The Example JavaServer Faces Application

The Example JavaServer Faces Application

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

• The JavaServer Faces implementation providesFacesServlet, whose instances accept incoming requests and pass them to the implementation for processing. Therefore, the application does not need to include a servlet (such as theDispatcher servlet) that processes request parameters and dispatches to application logic, as do the other versions of Duke’s Bookstore.

• A custom image map component that allows you to select the locale for the application.

• Navigation configured in a centralized application configuration resource file. This eliminates the need to calculate URLs, as other versions of the Duke’s Bookstore application must do.

• Backing beans associated with the pages. These beans hold the component data and perform other processing associated with the components. This processing includes handling the event generated when a user clicks a button or a hyperlink.

• The table that displays the books from the database and the shopping cart are rendered with thedataTable tag, which is used to dynamically render data in a table. ThedataTable tag ontut-install/javaeetutorial5/examples/web/bookstore6/web/bookshowcart.jsp also includes input components.

• The table that displays the books from the database uses ac:forEach JSTL tag, demonstrating that you can easily use JavaServer Faces component tags with JSTL tags.

• A custom validator and a custom converter are registered on the credit card field of thebookcashier.jsp page.

• A value-change listener is registered on the Name field ofbookcashier.jsp. This listener saves the name in a parameter so thattut-install/javaeetutorial5/examples/web/bookstore6/web/bookreceipt.jsp can access it.

This version of Duke’s Bookstore includes the same pages listed inTable 5-1. Italso includes thetut-install/javaeetutorial5/examples/web/bookstore6/web/chooselocale.jsp page, which displays the custom image map that allowsyou to select the locale of the application. This page is displayed firstand advances directly to thebookstore.jsp page after the locale is selected.

The packages of the Duke’s Bookstore application are:

• backing: Includes the backing bean classes

• components: Includes the custom UI component classes

• converters: Includes the custom converter class

• listeners: Includes the event handler and event listener classes

• model: Includes a model bean class

• renderers: Includes the custom renderers

• resources: Includes custom error messages for the custom converter and validator

• taglib: Includes custom tag handler classes

• util: Includes a message factory class

• validators: Includes a custom validator class

Chapter 12, Developing with JavaServer Faces Technology describes how to program backing beans, custom converters and validators, and eventlisteners.Chapter 13, Creating Custom UI Components describes how to program event handlers, custom components, renderers, and taghandlers.

The source code for the application is located in thetut-install/javaeetutorial5/examples/web/bookstore6/ directory.

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

1. Perform all the operations described inAccessing Databases from Web Applications.

2. In NetBeans 5.5, select File→Open Project.

3. In the Open Project dialog, navigate to:

   tut-install/javaeetutorial5/examples/web/

4. Select thebookstore6 folder.

5. Select the Open as Main Project check box and the Open Required Projects check box.

6. Click Open Project.

7. In the Projects tab, right-click thebookstore6 project, and select Undeploy and Deploy.

8. To run the application, open the bookstore URLhttp://localhost:8080/bookstore6.

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

1. In a terminal window, go totut-install/javaeetutorial5/examples/web/bookstore6/.

2. Typeant. This target will spawn any necessary compilations, copy files to thetut-install/javaeetutorial5/examples/web/bookstore6/build/ directory, and create a WAR file and copy it to thetut-install/javaeetutorial5/examples/web/bookstore6/dist/ directory.

3. Start the Application Server.

4. Perform all the operations described inCreating a Data Source in the Application Server.

5. To deploy the example, typeant 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 URLhttp://localhost:8080/bookstore6/.

To learn how to configure the example, refer to theweb.xml file, whichincludes the following elements:

• Adisplay-name element that specifies the name that tools use to identify the application.

• Acontext-param element that specifies that thejavax.faces.STATE_SAVING_METHOD parameter has a value ofclient, meaning that state is saved on the client.

• Alistener element that identifies theContextListener class used to create and remove the database access.

• Aservlet element that identifies theFacesServlet instance.

• Aservlet-mapping element that mapsFacesServlet to a URL pattern.

• Nested inside ajsp-config element is ajsp-property-group element, which sets the properties for the group of pages included in this version of Duke’s Bookstore. SeeSetting Properties for Groups of JSP Pages for more information.

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

Copyright © 2010, Oracle and/or its affiliates. All rights reserved.Legal Notices