blob: 7ec69699df0a78a572b32ef6c418b9c9de70b289 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<link rel="stylesheet" href="../../book.css" type="text/css">
<title>JSF Library Management</title>
</head>
<body>
<h1>JSF Library Management</h1>
<br>
The JSF Tools project helps users manage the JAR files for a Dynamic Web
Project using the JDT User Library feature. This enables a user to add
the JSF implementation JAR files, custom JSF-JSP Tag libraries and
supporting JAR files to the classpath of the project. The user can
optionally deploy the JAR files to the WEB-INF/lib directory at publish
time using the J2EE Module Dependencies.
<br>
<br>
<img src="./images/jsf_library_configuration.png"
alt="Configure JSF Libraries">
<br>
<h2>Validation</h2>
The tool validates that the project has the JSF implementation JAR files
on the classpath.
<br>
<br>
<img src="./images/jsf_validate_library.png" alt="Validate JSF Library">
<br>
<h2>Download Library</h2>
This feature allows user to download the JSF implementation JAR files.
<br>
<br>
<img src="./images/jsf_download_library.png" alt="Download Library">
<br>
<a id="projectrefs"></a>
<h2>Library Provided By Target Runtime</h2>
<br>
If the user has chosen a runtime adapter that is capable of supplying
the JSF implementation libraries, the library configuration can be
disabled by selecting the option, "Disable Library Configuration" . This
replaces the "Server Supplied" option of previous releases.
<br>
<br>
<img src="./images/jsf_disable_library_configuration.png"
alt="Disable Library Configuration">
<br>
<a id="projectrefs"></a>
<h2>Project References</h2>
<br>
<p>When a JDT User Library is referenced by a project, either at JSF
Facet install time, or at a later time by adding it using projects Java
Build Path property page, the library is placed on the project's build
classpath as a classpath container. In order for the jars in the library
to be deployed with the application, the library must <b>also</b> be
selected in the Java EE Module Dependencies page. This handles placing
each jar in the library into the WEB-INF/lib directory of the deployed
application.</p>
<br>
<img src="./images/jsf_library_jeemodule.png"
alt="Set Java EE Module dependencies">
<br>
<a id="legacysupport"></a>
<h2>Legacy Library Configuration</h2>
<br>
<p>Existing JSF applications that use the JSF Library feature from
earlier releases (WTP 3.1 and earlier), will continue to work in this
release. The tool will detect an older workspace and configure the
existing JSF application to use a 'Legacy Library Configuration' as the
library type. Users are encouraged to switch to the 'Use Library' type.</p>
<br>
<img src="./images/jsf_library_legacy.png"
alt="Support for Legacy Library configuration">
<br>
<br>
<p><img src="../../images/ngrelc.png" alt="Related concepts"
border="0"><br>
<a href="../concepts/jsf_facets.html">JSF Facets</a><br>
</p>
<p><img src="../../images/ngrelr.png" alt="Related reference"
border="0"><br>
<a
href="../../../org.eclipse.jdt.doc.user/reference/preferences/java/buildpath/ref-preferences-user-libraries.htm">JDT
User Library</a></p>
<p><img src="../../images/ngrelt.png" alt="Related tasks" border="0">
<br>
<a href="../tasks/jsf_library_migration.html">Migrating a project
using JSF Library to use JDT User Library</a><br>
<a href="../tasks/create_jsf_app.html">Create JSF Project</a><br>
</p>
</body>
</html>