Java Server Faces (JSF)

Revision as of 05:15, 8 July 2008

Integrating OpenCms with JavaServer Faces 1.1 is possible. JSF 1.2 seems not to work with up to OpenCms 7.0.4. This articles lists all the work that has to be done to use JSF within OpenCms.

Prerequisites

Before you start you have to decide on the software versions you want to use. On the Apache website there is a compatibility list for Apache's software stack (Tomcat, MyFaces).

The following combinations are known to work (please extend!):

The following seem to NOT work:

• JSF 1.2 in general. Tested with Sun's RI (Mojara) and Apache Myfaces.
• With Mojara the JSF page ist rendered, but output of JSF tags is out of order and partially overwriting JSP output. In addition to this the output is truncated, depending on the <f:view>-tag's content size.
• With Apache MyFaces the output of the JSF page is incomplete. Non-JSF output seems to be missing completely.

Integrating OpenCms and Java Server Faces

Copy JSF Libraries

First, get the JSF implementation of your choice. Unzip the distribution and search for the JAR files named jsf-api.jar and jsf-impl.jar (usually in the lib directory). Copy these two archives to WEB-INF/lib in your OpenCms installation directory.

Adapt Webapplication Descriptor

Next you have to configure the servlet mapping in WEB-INF/web.xml. Add the following sections:

   <servlet>
      <servlet-name>Faces Servlet</servlet-name>
      <servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
      <load-on-startup>1</load-on-startup>
   </servlet>

   <servlet-mapping>
      <servlet-name>Faces Servlet</servlet-name>
      <url-pattern>/faces/*</url-pattern>
   </servlet-mapping>

Note that it has been reported, that suffix-mapping (e.g, *.jsf) should work as well but I couldn't get it to work, so I used prefix mapping, i.e. "/faces/*", instead.

Create Faces Configuration

Next you can create a JSF configuration file in WEB-INF/faces-config.xml like this:

<?xml version="1.0"?>
<faces-config xmlns="http://java.sun.com/xml/ns/javaee"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
        http://java.sun.com/xml/ns/javaee/web-facesconfig_1_2.xsd"
        version="1.2">
   <navigation-rule>
      <from-view-id>/opencms/jsf-example.jsp</from-view-id>
      <navigation-case>
         <from-outcome>login</from-outcome>
         <to-view-id>/opencms/jsf-example2.jsp</to-view-id>
      </navigation-case>
   </navigation-rule>

   <managed-bean>
      <managed-bean-name>user</managed-bean-name>
      <managed-bean-class>com.corejsf.UserBean</managed-bean-class>
      <managed-bean-scope>session</managed-bean-scope>
   </managed-bean>
</faces-config>

Add Bean Classes

Add bean classes as you need them to WEB-INF/classes or in a JAR file, as you like.

Restart Servlet Container

Restart your servlet container.

Use your JSF pages with the correct URLs

Create you JSF pages and access them with the correct URLs. There is nothing special in creating JSF pages. Just go to OpenCms' workplace, click on "New", select "JSP" as the type for you new JSF page and insert your code.

When you want to access a JSF page use the base URL http://myhost:8080/opencms/faces/opencms/ with the path of the file in workplace appended. For example if you have a file jsf-example.jsp in your root-folder of the /sites/default site, access it via the URL http://myhost:8080/opencms/faces/opencms/jsf-example.jsp.

Here's a simple servlet filter that rewrites any pages ending with ".jsf" to /opencms/faces/opencms . This way, you can click on the JSF pages within the editor and get the preview to work correctly. You'll need to name all your JSF pages ".jsf" for this to work. The filter requires the Apache Commons Lang libraries:

You'll also need to map it in web.xml:

Usefull Links

• http://www.opencms-forum.de/opencms-forum/viewthread?thread=2068
• http://www.opencms-forum.de/opencms-forum/viewthread?thread=1042
• http://www.nabble.com/forum/ViewPost.jtp?post=13485806&framed=y
• http://www.nabble.com/forum/ViewPost.jtp?post=15958214&framed=y
• http://forum.java.sun.com/thread.jspa?threadID=5236855&tstart=555