Creating the Directory Structure - Java

As the first step, you need to create a directory structure for your JSF application. In Tomcat, you create this under webapps. The directory structure for your application, called JSFCh02a, is depicted in Figure 4. The directory contains all the required components that you will build in this example.

First, note that you must copy the .jar files containing the JSF implementation into the WEB-INF/lib directory. Then, in the WEB-INF/classes directory, you have the JavaBean class. In the WEB-INF directory, you have the deployment descriptor (web.xml) and the application configuration file (faces-config.xml). Lastly, the adder.jsp page is in the application directory itself.

Writing the Deployment Descriptor for the Listener and Component Tree Example

Just like any other servlet/JSP application, this JSF application needs a deployment descriptor. Listing 1 presents the deployment descriptor for this application.

Figure 4 The directory structure of the listener and
component tree example

Listing 1 The Deployment Descriptor (web.xml)


<?xml version="1.0"? >
<!DOCTYPE web-app PUBLIC
  "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
  "http://java.sun.com/dtd/web-app_2_3.dtd">

<P align=left> 
<P align=left><web-app>
  <!-- Faces Servlet -->
  <servlet>
    <servlet-name>Faces Servlet</servlet-name>
    <servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
    <load-on-startup> 1 </load-on-startup>
  </servlet>

<P align=left> 
<P align=left>  <!-- Faces Servlet Mapping -->
  <servlet-mapping>
    <servlet-name>Faces Servlet</servlet-name>
    <url-pattern>/faces/*</url-pattern>
  </servlet-mapping>
</web-app>



There are two sections in the deployment descriptor. The servlet element registers the FacesServlet, and the servlet-mapping element states that any request containing the pattern /faces/ in the URL must be passed to the FacesServlet. 

Remember: This is part one of the second chapter of JavaServer Faces Programming, by Budi Kurniawan (McGraw-Hill/Osborne, ISBN 0-07-222983). Stay tuned for part 2 of "Introduction to JavaServer Faces," where we learn about JSP, JavaBeans, and Model 2.  Buy this book!