<?xml version='1.0'?>
    <tomcat-users>
        <role rolename="admin"/>
        <role rolename="manager"/>
        <user username="tomcatusername" password="tomcatpassword"
                 roles="admin,manager"/>
    </tomcat-users>

AddressBook.ContextListener: AddressBook.ContextListener是一个servlet上下文监听器，它在AddressBook开始和关闭时被调用，可以使用AddressBook的部署描述文件web.xml配置。当AddressBook开始运行时，创建一个AddressesDB的实例并将它作为一个上下文属性保存；而当AddressBook运行结束时，从上下文属性中取出AddressesDB对象并关闭数据库连接。在运行过程中，当JSPs需要连接数据库，它们将访问上下文属性中的AddressesDB对象。细节请看ContextListener.java的完整的带有注释的源代码。

AddressBook. AddressesDB: AddressBook. AddressesDB用于操作地址数据库。它的构造函数建立一个数据库连接，这个会话可以被多个Web会话共享。这个类提供多个数据库连接函数：

getAddress(id)返回用id标识的地址，如果地址没找到则返回null。

addAddress(address)添加地址并返回改变的行数

deleteAddress(id)删除地址并返回改变的行数

getAddresses()返回数据库中所有地址的聚集，如果数据库无效返回null

close()关闭数据库连接

细节请看AddressesDB.java的完整的带有注释的源代码。

AddressBook. Address: AddressBook. Address是用于描述地址的类。在用JSPs编程时，用类集中描述数据仍不失为一个好的方法。在AddressBook中使用的就是这种方法。AddressBook. Address的构造函数将地址内容保存于对象中。这个类中包括取得单个地址域的普通get函数，两个获取合并的地址域的get函数，以及一个地址比较函数：

Address(id,surname,fisrtname,street,district,city,postcode)

getId()

getSurname()

getFirstname()

getStreet()

getDistrict()

getCity()

getPostcode()

getFullname()返回firstname+” ”+surname

getFulladdress()返回street+” ”+district+” ”+city+” ”+postcode

compareTo(address)返回负整数、零、正整数，分别对应surname和firstname大于、等于、小于这个surname和firstname，比较是大小写不敏感的。在存储地址聚集时使用。

细节请看Address.java的完整的，带有注释的源代码。

AddressBook中的JSP页面: AddressBook有七个JSP页。每个代表一个对AddressBook数据库进行独立操作的Web页。每个页面数据库的状态与前页数据库的状态是相互独立的。如果数据库被其他用户改变了，Web页面将检测到并产生相应的动作。例如，如果你正在修改一个地址而另一个用户在确认修改之前删除了该地址，JSP将通知你修改不存在的地址失败。

　　图2显示JSPs之间的逻辑关系。

# mysql -u root -p
mysql> create database Public;
mysql> grant all privileges on Public.* to mysqlusername@localhost\
identified by 'mysqlpassword' with grant option;
mysql> flush privileges;

mysql> create table Addresses ( \
id        int(8) primary key auto_increment, \
surname   varchar(24) not null, \
firstname varchar(24) not null, \
street    varchar(80) not null, \
district  varchar(80) not null, \
city      varchar(40) not null, \
postcode  varchar(10) not null \
);

+-----------+-------------+------+-----+---------+----------------+
| Field      | Type          | Null | Key | Default | Extra       |
+-----------+-------------+------+-----+---------+----------------+
| id          | int(8)       |       | PRI | NULL   |auto_increment|
| surname    | varchar(24) |       |      |         |              |
| firstname | varchar(24)  |       |      |         |              |
| street     | varchar(80)  |       |      |        |              |
| district   | varchar(80) |       |      |         |              |
| city        | varchar(40) |       |      |        |              |
| postcode   | varchar(10) |       |      |         |              |
+-----------+-------------+------+-----+---------+----------------+

mysql> insert into Addresses (surname, firstname, street, district,
city, postcode) values ("Smith", "John", "1, The High Street,",
"Downtown,", "Metropolis.", "X99 9XX");
mysql> commit;
mysql> select * from Addresses;

app.name=AddressBook
tomcat.home=/usr/local/jakarta-tomcat-4.1.12
manager.url=http://localhost:8080/manager
username=tomcatusername
password=tomcatpassword

<Logger className="org.apache.catalina.logger.FileLogger" prefix=
  "localhost_AddressBook_log." suffix=".txt" timestamp="true"/>

<listener>
   <listener-class>AddressBook.ContextListener</listener-class>
</listener>

<welcome-file-list>
   <welcome-file>Home.jsp</welcome-file>
</welcome-file-list>

$ cd AddressBook
$ ant install

添加地址，然后修改它，再删除它，再添加一个地址。你将看到id持续自动增加。

开发过程

　　AddressBook安装成功之后，Tomcat调用AddressBook.ConextListener.contextInitialized创建AddressBook.AddressesDB的一个实例。AddressBook.AddressesDB通过jdbc/Public DataSource建立数据库连接。AddressBook.ConextListener.contextInitialized将AddressBook.AddressesDB的实例作为一个servlet属性（addressesDB）保存。

　　当AddressBook的Home.jsp第一次被调用，Tomcat编译并执行它。Home.jsp通过servlet属性addressesDB取得AddressBook.AddressesDB的实例，然后从数据库中读取地址并显示。其他JSP页面在第一次被使用时也要先编译再执行，读取数据库的方法同Home.jsp。

　　ant stop用于停止AddressBook程序。Tomcat自动调用AddressBook.ContextListener.contextDestroyed取得上面提到的servlet属性addressesDB和AddressBook.AddressesDB的实例，关闭数据库连接并删除servlet属性addressesDB。

　　ant start用于启动AddressBook程序。Tomcat自动调用AddressBook.ConextListener.contextInitialized重复启动过程。

　　整个Web应用程序的开发过程是这样的：修改程序；用ant install创建并安装；在浏览器中键入地址http://localhost:8080/applicationName（或点击刷新按钮）以测试Web程序；用ant remove删除Web应用程序的上下文信息；重复整个过程，直到调试完毕。当程序调试完毕后，使用ant deploy正式将你的程序配置到服务器上。在重起Tomcat或者重起服务器后，你的应用程序就开始运行了。要将Web应用程序从你的服务器彻底删除用ant undeploy命令。

Tomcat Manager

　　使用Tomcat Manager可以替代Ant。在浏览器中键入地址http://localhost:8080/manager/html/list，将出现如图6所示的Tomcat Manager Web页面。