The Example JSP Document
This chapter uses the Duke's Bookstore application, version
bookstore5
, and thebooks
application to demonstrate how to write JSP pages in XML syntax. The JSP pages of thebookstore5
application use the JSTL XML tags (see XML Tag Library) to manipulate the book data from an XML stream. Thebooks
application contains the JSP documentbooks.jspx
, which accesses the book data from the database and converts it into the XML stream. Thebookstore5
application accesses this XML stream to get the book data.These applications show how easy it is to generate XML data and stream it between web applications. The
books
application can be considered the application hosted by the book warehouse's server. Thebookstore5
application can be considered the application hosted by the book retailer's server. In this way, the customer of the bookstore web site sees the list of books currently available, according to the warehouse's database.The source for the Duke's Bookstore application is located in the
<
INSTALL
>/javaeetutorial5/examples/web/bookstore5/
directory, which is created when you unzip the tutorial bundle (see About the Examples).To deploy the
books
application using NetBeans 5.5, follow these steps:
- Perform all the operations described in Accessing Databases from Web Applications.
- In NetBeans 5.5, select File
Open Project.
- In the Open Project dialog, navigate to:
<INSTALL>/javaeetutorial5/examples/web/
- Select the
books
folder.- Select the Open as Main Project checkbox and the Open Required Projects checkbox.
- Click Open Project Folder.
- In the Projects tab, right-click the
books
project, and select Deploy Project.To deploy the
books
application using theant
utility, follow these steps:
- In a terminal window, go to
<
INSTALL
>/javaeetutorial5/examples/web/books/
.- Run
ant
build
. This target will spawn any necessary compilations, copy files to the<
INSTALL
>/javaeetutorial5/examples/web/books/build/
directory, build a WAR file, and copy the WAR file to the<
INSTALL
>/javaeetutorial5/examples/web/books/dist/
directory.- Deploy the application by running
ant deploy
.To deploy and run the
bookstore5
application using NetBeans 5.5, follow these steps:
- Perform all the operations described in Accessing Databases from Web Applications.
- In NetBeans 5.5, select File
Open Project.
- In the Open Project dialog, navigate to:
<INSTALL>/javaeetutorial5/examples/web/
- Select the
bookstore5
folder.- Select the Open as Main Project checkbox and the Open Required Projects checkbox.
- Click Open Project Folder.
- In the Projects tab, right-click the
bookstore5
project, and select Deploy Project.- To run the applications, open the bookstore URL
http://localhost:8080/bookstore5/books/bookstore
.To deploy and run the application using
ant
follow these steps:
- In a terminal window, go to
<
INSTALL
>/javaeetutorial5/examples/web/bookstore5/
.- Run
ant
. This target will spawn any necessary compilations, copy files to the<
INSTALL
>/javaeetutorial5/examples/web/bookstore5/build/
directory, and create a WAR file and copy it to the<
INSTALL
>/javaeetutorial5/examples/web/bookstore5/dist/
directory.- Start the Application Server.
- Perform all the operations described in Creating a Data Source in the Application Server.
- 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.- To run the applications, open the bookstore URL
http://localhost:8080/bookstore5/books/bookstore
.To learn how to configure the
bookstore5
example, refer to theweb.xml
file, which includes the following configurations:
- A
display-name
element that specifies the name that tools use to identify the application.- A
context-param
element that identifies the context path to the XML stream.- A
context-param
element that specifies the JSTL resource bundle base name.- A set of
servlet
elements that identify the JSP files in the application.- A set of
servlet-mapping
elements that identify aliases to the JSP pages identified by theservlet
elements.- Nested inside a
jsp-config
element are twojsp-property-group
elements, which define the preludes and coda to be included in each page. See Setting JavaBeans Component Properties for more information.To learn how to configure the
books
example, refer to the web.xml file, which includes the following configurations:
- A
display-name
element that specifies the name that tools use to identify the application.- A
listener
element that identifies theContextListener
class used to create and remove the database access.- A
servlet
element that identifies the JSP page.- Nested inside a
jsp-config
element is ajsp-property-group
element, which identifies the JSP page as an XML document. See Identifying the JSP Document to the Container for more information.