Application files

The Address Book sample application includes the Java class files listed in Table D-1 and the JavaServer Page (JSP) files listed in Table D-2.

**Table D-1: Java files**
File name	Description
AddressBookConstants.class	Contains a list of constants that can be accessed from the Java code and the JSPs.
AddressBookServlet.class	The controller servlet for the application. All calls from the JSPs are directed to this servlet. The servlet determines the type of operation requested, invokes the appropriate data access methods, saves the results in AddressBookJSPDataMediator.class, and redirects the request to the appropriate JSP to render the data.
AddressBookJSPDataMediator.class	Used to negotiate data between the JSPs and the Java code. An object of this class is stored in the session. The JSP gets the objects from the session to access the data and renders HTML windows.
AddressBookDBAccess.class	Responsible for all data access using the personalization APIs. See the comments in the Java code for more information on the individual methods of this class.
AddressBookEntry.class	The encapsulation of an individual address book entry. Additionally, this class contains support methods that ensure unique names when saving information using the personalization APIs.

**Table D-2: JSP files**
File name	Description
addcategory.jsp	Displays the window that allows you to add a category.
addcontact.jsp	Displays the window that enables you to create an address book entry.
addressdetails.jsp	Displays a read-only list of addresses. You can invoke this window from the Search Results window or the List Address window.
confirmscreen.jsp	When an address is entered, this file displays an address confirmation window.
editcontact.jsp	Displays a window that allows you to edit an address.
error.jsp	Displays error messages. The type of operation that caused the error determines the error message.
index.jsp	Displays the Welcome window, which allows you to: Add a new contact View all contacts Add a category Search for addresses
listaddress.jsp	Lists all the addresses in the address book based on the specified criteria.
search.jsp	Displays the Search window that allows users to search on first name, last name, or category.
searchresults.jsp	Displays the search results.
success.jsp	Notifies users when an operation has completed successfully.
underconstruction.jsp	A message page with one line of text, “Under Construction.”