使用何种技术
我使用Tomcat 4的Servlet/JPS容器技术实现一个Web应用程序。这个过程中仍然有许多不确定的事，在多种可行的技术中选一种可不是一件容易的事。这篇文章中，我选择尽量简单的解决方案，混合使用Java Server Pages(JSPs)以及Java。
应当尽量避免使用JSPs实现复杂逻辑；那种程序也许容易写，但难以调试而且几乎不可能被理解和维护。好的解决方案是用JSPs负责Web页面的显示（这正是JSPs擅长的），把复杂逻辑的实现交给Java，如对数据库的访问。这样，程序不但比较容易实现和调试，而且易于理解和维护。
这个Web应用程序可以运行在专用Web服务器或者是个人电脑上，操作系统可以是Windows，Linux，或者Mac OS。所需的软件包有Java运行时环境（JDK1.2或以上版本），Tomcat最新版本（Tomacat 4或以上版本），以及Ant开发工具（Ant 1.4或以上版本）。Ant用于创建Web应用程序包（WAR），以及在Tomcat上安装部署WAR文件，配置关系数据库接口javax.sql.DataSource。所有以上提到的软件包都可以通过Internet免费获得。
这个Web应用程序还需要一个数据库。几乎所有支持SQL而且有JDBC驱动的关系数据库都可以。MySQL是一个符合条件的不错选择。从MySQL.com可以得到MySQL的最新版本以及它的JDBC驱动Connector/J。
为了让Ant与Tomact管理软件协同工作，需要将catalina-ant.jar从Tomcat的server/lib目录拷贝到Ant的lib目录下。将你的数据库JDBC驱动程序复制到Tomcat的common/lib目录下使Tomcat和其上的Web应用程序可以访问数据库。最后，必须建立Tomcat的admin和manager角色（roles），及其用户名和密码，编辑Tomcat的conf目录下的tomcat-user.xml文件如下：
<?xml version='1.0'?> <tomcat-users> <role rolename="admin"/> <role rolename="manager"/> <user username="tomcatusername" password="tomcatpassword" roles="admin,manager"/> </tomcat-users>
我的开发环境是Apple Cube，运行Mac OS X 10.2.1操作系统，软件包JDK 1.3.1，Tomcat 4.1.12，Ant1.5.1，MySQL 3.23.52，及Connector/J 3.0.1-beta。操作系统升级到Mac OS X 10.2.2未出现任何问题。同样Tomcat升级到4.1.17也没出现问题。
Web应用程序
本文通过一个叫做AddressBook的简单地址簿程序来说明如何应用将要介绍的技术。这个应用程序的目的不是建立一个地址簿的正式版本，它仅仅是一个例子。
AddressBook中的Java程序: AddressBook中包含三个Java程序。图1显示了他们在Tomcat中的是如何使用的。
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之间的逻辑关系。
Home.jsp: Home.jsp是AddressBook的主页，也就是用户使用AddressBook时见到的第一个页面。它用一个表显示Address库中的所有地址。表中的每一行显示一个地址，以及删除或修改地址的连接。页面底部有一个添加新地址的连接。配置信息见web.xml notes。
添加地址连接将控制权交给RequestAdd.jsp
删除地址连接将控制权交给RequestDelete.jsp,同时将要删除的地址id传递给该页
修改地址连接将控制权交给RequestModify.jsp,同时将要修改的地址id传递给该页
细节请看Home.jsp的完整的带有注释的源代码。
RequestAdd.jsp: RequestAdd.jsp提供一个地址表单用于输入新地址。页面底部的取消连接可以取消这次操作。
提交表单将新的地址域值以及控制权交给DoAdd.jsp
取消操作将控制权交给Home.jsp。细节请看RequestAdd.jsp的完整的，带有注释的源代码。
DoAdd.jsp: DoAdd.jsp显示接收到的地址域值。然后将新地址添加到数据库并显示是否成功的信息。页面底部有一个继续连接。
点击继续连接回到Home.jsp。细节请看DoAdd.jsp的完整的，带有注释的源代码。
RequestDelete.jsp: RequestDelete.jsp读取得到的id相应的地址。该页面在表中显示地址域以便让你确认删除的是正确的地址。页面底部的两个连接分别是继续请求的继续连接和取消请求的取消连接。
选择继续连接将转到DoDelete.jsp并传递要删除的地址id
选择取消连接回到Home.jsp。细节请看RequestDelete.jsp的完整的带有注释的源代码。
DoDelete.jsp: DoDelete.jsp读取传递给它的id。在表中显示该id对应的地址，从数据库中删除它，并显示是否成功。页面底部是继续连接。
选择继续连接回到Home.jsp。细节请看DoDelete.jsp的完整的，带有注释的源代码。
RequestModify.jsp: RequestModify.jsp显示一个表单并填入当前的地址，同时提供提交按钮和取消连接。
提交表单将新的地址域值以及控制权交给DoModify.jsp
选择取消连接回到Home.jsp。细节请看RequestModify.jsp的完整的，带有注释的源代码。
DoModify.jsp: DoModify.jsp显示接收到的修改的地址域值。然后修改数据库中的地址记录，并返回成功与否。页面底部是继续连接。
选择继续连接回到Home.jsp。细节请看DoModify.jsp的完整的，带有注释的源代码。
AddressBook的Addresses数据库表: 如何建立数据库取决于所用的数据库软件。若你用的不是MySQL以下的步骤就需要根据情况修改。AddressBook只有一个表Addresses，保存在数据库Public中。表Addresses有七个域：
id，主键，自动增长的数据域
surname，长度为24的字符域，保存联系人的姓
firstname，长度为24的字符域，保存联系人的名
street，长度为80的字符域，保存地址的第一行
district，长度为80的字符域，保存地址的第二行
city，长度为40的字符域，保存城市名
postcode，长度为10的字符域，保存邮政编码
首先建立MySQL数据库（Mac OS X 10.2.1）。用管理员权限启动mysql命令行工具，需要的话输入密码。创建Public数据库，以及账号mysqlusername密码mysqlpassord。命令如下：
# mysql -u root -pmysql> create database Public;mysql> grant all privileges on Public.* to mysqlusername@localhostidentified by 'mysqlpassword' with grant option;mysql> flush privileges;
然后，在Public数据库中创建Addresses表。
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 );
用命令Commit；提交。要检查对表的操作是否正确，键入命令describe Addresser；，将得到如下结果：
+-----------+-------------+------+-----+---------+----------------+| 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;
结果如下：
注意地址的id被自动赋予值1。至此AddressesBook的数据库创建完成。
配置AddresBook的开发目录 现在我们配置存放AddressBook源文件的目录，以及Web应用程序的war目录，它也是存放Web应用程序包的目录。下载AddressBook源程序压缩包。解压后将得到Ant能够处理的源程序目录结构，如图3所示。不需要对AddressBook的开发目录进行特殊改变?建议将其解压至你的home目录（Mac OS）。
让我们看看这些文件：
AddressBook/build.properties: AddressBook/build.properties含有若干被AddressBook/build.xml读取得设置信息。定制build过程时，尽量编辑较小的build.properties文件，而不要修改复杂的多的build.xml文件。
app.name=AddressBooktomcat.home=/usr/local/jakarta-tomcat-4.1.12manager.url=http://localhost:8080/managerusername=tomcatusernamepassword=tomcatpassword
app.name参数不需要修改。如果将来要重用这些文件创建新的Web应用程序时把该参数改为新的程序名。如果在本地机器上运行Tomcat 4，则manager.url参数也不必修改。
tomcat.home参数为Tomcat的安装目录，以上的设置表示Tomcat 4.1.12安装在/url/local目录下（Mac OS）。Ant将根据这个参数设置编译AddressBook时的CLASSPATH变量，使它包含Tomcat的common/lib.jar文件。（这样Tomcat 和Web应用程序都可以直接访问这个文件，而不必将其复制到应用程序的WEB-INF/lib目录下。）
Tomcat也有一个类似的目录：shared/lib，给目录下的.jar文件在运行时对于应用程序是可访问的，但对Tomcat是不可访问的。
参数tomcatusrename和tomcatpassword必须与Tomcat的配置文件conf/tomcat-users.xml中的设置一致。Ant使用它们以及manager.url取得在Tomcat环境中安装AddressBook应用的权限。
细节请看build.properties的完整带有注释的源代码。
AddressBook/build.xml: AddressBook/build.xml文件是Ant的配置文件，它使用许多Ant的标签。以下是比较常用的：
? ant build 创建Web应用程序
? ant install 安装Web应用程序用于测试
? ant remove 卸载Web应用程序
? ant deploy安装部署Web应用程序
? ant undeploy卸载Web应用程序
细节请看build.xml的完整的带有注释的源代码。
AddressBook/context.xml: AddressBook/context.xml是在Ant处理安装、重新载入、删除、部署、卸载请求时装入Tomcat中的。给文件记录的是AddressBook的上下文信息，或者是Tomcat运行AddressBook需要的参数。
Logger项定义了Tomcat用文本格式记录AddressBook的事件日志，并存放于Tomcat的logs目录下。以下Logger项定义了名为localhost_AddressBook_log.YYYY-MM-DD.txt的日志文件，其中YYYY-MM-DD为日志日期：
<Logger className="org.apache.catalina.logger.FileLogger" prefix= "localhost_AddressBook_log." suffix=".txt" timestamp="true"/>
Resource和ResourceParams项定义Tomcat必须为AddressBook创建一个叫jdbc/Publicd的javax.sql.DataSource。以下设置创建了一个javax.sql.DataSource，其值为org.apache.commons.dbcp.BasicDataSourceFactory类，URL为jdbc:mysql://localhost:3306/Public?autoReconnect=true，JDBC驱动：org.gjt.mm.mysql.Driver，用户名和密码分别为：mysqlusername和mysqlpassword：
以上代码将javax.sql.DataSource作为该Web应用程序的上下文变量。如果该变量不止被一个Web应用用到，可以将它定义为全局资源。细节请看context.xml的完整的带有注释的源代码。
AddressBook/src/*.java: src目录中存放Web应用的三个Java程序。见Address.java，AddressesDB.java和ContextListener.java的描述。
AddressBook/web/*.jsp: web目录存放Web应用的七个JSP页面。见Home.jsp, RequestAdd.jsp, DoAdd.jsp, RequestDelete.jsp, DoDelete.jsp, RequestModify.jsp, 和 DoModify.jsp的描述。
AddressBook/web/WEB-INF/web.xml[1] [2] 下一页
打印本文 
关闭窗口