The Example JavaServer Faces Application

The JavaServer Faces technology chapters of this tutorial primarily use a rewritten version of the Duke's Bookstore example to illustrate the basic concepts of JavaServer Faces technology. This version of the Duke's Bookstore example includes several JavaServer Faces technology features:

This version of Duke's Bookstore includes the same pages listed in Table 4-1. It also includes the chooselocale.jsp page, which displays the custom image map that allows you to select the locale of the application. This page is displayed first and advances directly to the bookstore.jsp page after the locale is selected.

The packages of the Duke's Bookstore application are:

Chapter 11 describes how to program backing beans, custom converters and validators, and event listeners. Chapter 12 describes how to program event handlers, custom components, renderers, and tag handlers.

The source code for the application is located in the <INSTALL>/javaeetutorial5/examples/web/bookstore6/ directory.

To deploy and run the application using NetBeans 5.5, follow these steps:

  1. Perform all the operations described in Accessing Databases from Web Applications.
  2. In NetBeans 5.5, select FileRight ArrowOpen Project.
  3. In the Open Project dialog, navigate to:
  4. <INSTALL>/javaeetutorial5/examples/web/

  5. Select the bookstore6 folder.
  6. Select the Open as Main Project checkbox and the Open Required Projects checkbox.
  7. Click Open Project Folder.
  8. In the Projects tab, right-click the bookstore6 project, and select Deploy Project.
  9. To run the application, open the bookstore URL http://localhost:8080/bookstore6.

To deploy and run the application using ant follow these steps:

  1. In a terminal window, go to <INSTALL>/javaeetutorial5/examples/web/bookstore6/.
  2. Run ant. This target will spawn any necessary compilations, copy files to the <INSTALL>/javaeetutorial5/examples/web/bookstore6/build/ directory, and create a WAR file and copy it to the <INSTALL>/javaeetutorial5/examples/web/bookstore6/dist/ directory.
  3. Start the Application Server.
  4. Perform all the operations described in Creating a Data Source in the Application Server
  5. To deploy the example, run ant deploy. The deploy target outputs a URL for running the application. Ignore this URL, and instead use the one shown in the next step.
  6. To run the application, open the bookstore URL http://localhost:8080/bookstore6/.

To learn how to configure the example, refer to the web.xml file, which includes the following elements:

To run the example, open the URL http://localhost:8080/bookstore6 in a browser.