The Java EE 5 Tutorial

The Example JSP Pages

This chapter describes the tasks involved in defining simple tags. It illustrates the tasks using excerpts from the JSP version of the Duke’s Bookstore application discussed in The Example JSP Pages, rewritten here to take advantage of several custom tags:

The tutorial-template tag library defines a set of tags for creating an application template. The template is a JSP page that has placeholders for the parts that need to change with each screen. Each of these placeholders is referred to as a parameter of the template. For example, a simple template might include a title parameter for the top of the generated screen and a body parameter to refer to a JSP page for the custom content of the screen. The template is created using a set of nested tags (definition, screen, and parameter) that are used to build a table of screen definitions for Duke’s Bookstore. An insert tag to insert parameters from the table into the screen.

Figure 8–1 shows the flow of a request through the following Duke’s Bookstore web components:

Figure 8–1 Request Flow through Duke’s Bookstore Components

Diagram shows how a request is routed through a servlet
and two JSP pages to the Book DB, then a response is routed through a JSP
page to the client.

The source code for the Duke’s Bookstore application is located in the tut-install/javaeetutorial5/examples/web/bookstore3/ directory created when you unzip the tutorial bundle (see Chapter 2, Using the Tutorial Examples).

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

  1. Perform all the operations described in Accessing Databases from Web Applications.

  2. In NetBeans IDE, select File->Open Project.

  3. In the Open Project dialog, navigate to:


    tut-install/javaeetutorial5/examples/web/
  4. Select the bookstore3 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 the bookstore3 project, and select Undeploy and Deploy.

  8. To run the application, open the bookstore URL http://localhost:8080/bookstore3/bookstore.

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

  1. In a terminal window, go to tut-install/javaeetutorial5/examples/web/bookstore3/.

  2. Type ant. This command will spawn any necessary compilations, copy files to the tut-install/javaeetutorial5/examples/web/bookstore3/build/ directory, and create a WAR file and copy it to the tut-install/javaeetutorial5/examples/web/bookstore3/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, type 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/bookstore3/bookstore.

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

To run the example, open the bookstore URL http://localhost:8080/bookstore3/bookstore.

See Troubleshooting Duke's Bookstore Database Problems for help with diagnosing common problems.