This chapter gently introduces the JavaServer Faces technology. More importantly, it teaches you how to write your first JSF application to get a feel for how this great technology works. In addition to the sample chapters, this chapter prepares you for the next chapters by introducing the JSF Application Programming Interface (API) and the Application Configuration file. This excerpt comes from chapter two of JavaServer Faces Programming, by Budi Kurniawan (McGraw-Hill/Osborne, ISBN 0-07-222983-7, 2004).
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 4The directory structure of the listener and component tree example
Listing 1The 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">
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!