[Myfaces Wiki] Update of "Library dependencies" by vanosten

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Myfaces Wiki" for change notification.

The following page has been changed by vanosten:
http://wiki.apache.org/myfaces/Library_dependencies

New page:
##language:en
== Library dependencies and versions ==
To use Apache MyFaces in your own webapplication you need to add several third party libraries. This page gives an overview over the necessary libraries and their version for the current stable release (which is 1.1.0 at the time of this writing).

See also [http://myfaces.apache.org/gettingstarted.html Getting started with Apache MyFaces].

=== Required third party libraries ===
MyFaces version 1.1.0:
|| '''Library''' || '''Version''' || '''Notes''' ||
|| [http://jakarta.apache.org/commons/beanutils/ Jakarta Commons BeanUtils] || 1.6.1 ||||
|| [http://jakarta.apache.org/commons/codec/ Jakarta Commons Codec] || 1.2 ||||
|| [http://jakarta.apache.org/commons/collections/ Jakarta Commons Collections] || 3.0 ||||
|| [http://jakarta.apache.org/commons/digester/ Jakarta Commons Digester] || 1.5 ||||
|| [http://jakarta.apache.org/commons/el/ Jakarta Commons EL] || 1.0 ||||
|| [http://jakarta.apache.org/commons/fileupload/ Jakarta Commons FileUpload] || 1.0 || Required only if you are uploading files ||
|| [http://jakarta.apache.org/commons/logging/ Jakarta Commons Logging] || 1.0.4 ||||
|| [http://jakarta.apache.org/commons/validator/ Jakarta Commons Validator] || 1.2.0-dev || Which snapshot is used for testing??? ||
|| [http://jakarta.apache.org/oro/index.html Jakarta ORO] || ??? || You can use the one from the Myfaces 1.0.9 binary distribution in the lib-directory ||
|| [http://logging.apache.org/log4j/docs/ log4J] || 1.2.12 || Required only if you have commons-logging configured to use log4j. Version 1.2.8 might do as well ||
|| myfaces-impl.jar || 1.1.0 || Alternatively use myfaces-all.jar ||
|| myfaces-api.jar || 1.1.0 || Alternatively use myfaces-all.jar ||
|| tomahawk.jar || 1.1.0 || If you want to use MyFaces extensions. Alternatively use myfaces-all.jar ||
|| portlet-api.jar || implementation specific || Required only if you are doing portlets according to the [http://jcp.org/en/jsr/detail?id=168 Java Portlet Specification 1.0]. E.g. [http://portals.apache.org/pluto/ Apache Portals Pluto] which is the reference implementation || 
|| [http://struts.apache.org/ Apache Struts] struts.jar || 1.2.7 || Required only if you are doing tiles work, will change to the tile.jar file once tiles is pulled from struts. ||

=== Installation ===
* Copy the libraries (jar-files) into the WEB-INF/lib directory of your .war file.
* If you are using a JSP 1.2 container like Tomcat 4 you must also copy the file jsp-2.0.jar to your WEB-INF/lib dir.
* Make sure that there is no jsf-api.jar (i.e. Suns API implementation) in the classpath or in one of your container's shared lib directories (e.g. common/lib or shared/lib for Tomcat).

Alternatively you can add the libraries to the classpath of your Servlet container (check the documentation of your container).

Typically the first approach is recommended, as it allows you (a) to have different versions of libraries in different webapplication within the same container, and (b) to distribute your application as a whole without others having to install the libraies into their Servlet container.