WAS v8.5 > Develop applications > Develop web applications > Assemble web applications > Configure JavaServer Faces implementationConfigure JavaServer Faces implementation
Use this task to specify which JavaServer Faces implementation to use. We can use Apache MyFaces 2.0 or the Sun Reference Implementation 1.2 of JSF, or our own implementation.
Ensure the application is configured for JavaServer Faces (JSF) using the specific web.xml context parameters for the implementation that we have chosen.
The JSF implementation is a server-wide configuration setting. Thus, if we have multiple applications which require different JSF implementations, you must separate the applications into different application servers or clusters, and specify the implementation by following the steps in this topic for each application server or cluster. Alternatively, we can use an isolated shared library, as described for third-party JSF implementations, as follows.
For transitioning users: The Application Server JSF engine determines if the Sun Reference Implementation (RI) 1.2 or Apache MyFaces 2.0 is used from the Application Server run time. If either is used, the correct listener class is registered with the web container. We do not need to add the com.sun.faces.ConfigureListener or the org.apache.myfaces.StartupConfigureListener to your web.xml file.trns
Be Aware: To use a third-party JSF implementation not shipped with the product, then:
- Add the third-party listener to the required web.xml file.
- Add the third-party implementation JAR files to the application as an isolated shared library and associate it with the application:
- Move the JSF JAR files to a directory outside of the application.
- Create the isolated shared library. See topic Create shared libraries for information about how to create the shared library.
- Ensure the classloader is set to PARENT_FIRST, the default value. To view the current configuration in the dmgr console panel, click Applications > Application Types > WebSphere enterprise applications > application_name > Class loading and update detection.
- If we are using a third-party MyFaces implementation, set the JSF implementation to Sun RI. To change this configuration in the dmgr console panel, click Applications > Application Types > WebSphere enterprise applications > application_name > JSP and JSF options. Under JSF implementation, select Sun RI from the drop-down menu. If we are using a different third-party JSF implementation, keep the JSF implementation set to the default value.
- Restart the application server.
We can also configure the JSF implementation on the Provide JSP reloading options for web modules panel for application installation and update wizards.
Configure the server or cluster to use the JSF implementation you want. We can do this task using the dmgr console or wsadmin.
- In the dmgr console panel, click Applications > Application Types > WebSphere enterprise applications > application_name > JSP and JSF options
Select one of the following implementations:
- Sun Reference Implementation 1.2 - Select this option to use the Sun Reference Implementation 1.2 JSF implementation.
- MyFaces 2.0 - Select this option to use the MyFaces 2.0 JSF implementation. This option is the default JSF implementation.
- Using wsadmin:
- An example of setting a single server to use the Sun RI 1.2 JSF implementation:
wsadmin>set server [$AdminConfig list ApplicationServer *server1*] server1(cells/myNode01Cell/nodes/myNode01/servers/server1|server.xml#ApplicationServer_1183122130078) wsadmin>$AdminConfig modify $server {{jsfProvider SunRi1.2}} wsadmin>$AdminConfig save- An example of setting a cluster to use the MyFaces 2.0 JSF implementation:
wsadmin>set cluster [$AdminConfig list ServerCluster] cluster1(cells/myNode01Cell/nodes/myNode01/clusters/cluster1|cluster.xml#ServerCluster_1173916133721) wsadmin>$AdminConfig modify $cluster {{jsfProvider MyFaces}} wsadmin>$AdminConfig save
Results
Configure JSF engine parameters as necessary.
Subtopics
Related concepts:
JavaServer Faces
JWL
JavaServer Faces
Related
Configure Portlet Bridge for JavaServer Faces
Manage JavaServer Faces implementations using wsadmin.sh
Create shared libraries
Associate shared libraries with applications or modules
Reference:
JSF engine configuration parameters