如何使用Ant和Tomcat创建Web应用详解.docx
- 文档编号:27197293
- 上传时间:2023-06-28
- 格式:DOCX
- 页数:21
- 大小:942.46KB
如何使用Ant和Tomcat创建Web应用详解.docx
《如何使用Ant和Tomcat创建Web应用详解.docx》由会员分享,可在线阅读,更多相关《如何使用Ant和Tomcat创建Web应用详解.docx(21页珍藏版)》请在冰豆网上搜索。
如何使用Ant和Tomcat创建Web应用详解
如何使用Ant和Tomcat创建Web应用详解
我使用Tomcat4的Servlet/JPS容器技术实现一个Web应用程序。
这个过程中仍然有许多不确定的事,在多种可行的技术中选一种可不是一件容易的事。
这篇文章中,我选择尽量简单的解决方案,混合使用JavaServerPages(JSPs)以及Java。
应当尽量避免使用JSPs实现复杂逻辑;那种程序也许容易写,但难以调试而且几乎不可能被理解和维护。
好的解决方案是用JSPs负责Web页面的显示(这正是JSPs擅长的),把复杂逻辑的实现交给Java,如对数据库的访问。
这样,程序不但比较容易实现和调试,而且易于理解和维护。
这个Web应用程序可以运行在专用Web服务器或者是个人电脑上,操作系统可以是Windows,Linux,或者MacOS。
所需的软件包有Java运行时环境(JDK1.2或以上版本),Tomcat最新版本(Tomacat4或以上版本),以及Ant开发工具(Ant1.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文件如下:
xmlversion='1.0'?
>
password="tomcatpassword" roles="admin,manager"/> 我的开发环境是AppleCube,运行MacOSX10.2.1操作系统,软件包JDK1.3.1,Tomcat4.1.12,Ant1.5.1,MySQL3.23.52,及Connector/J3.0.1-beta。 操作系统升级到MacOSX10.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()关闭数据库连接 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,比较是大小写不敏感的。 在存储地址聚集时使用。 AddressBook中的JSP页面: AddressBook有七个JSP页。 每个代表一个对AddressBook数据库进行独立操作的Web页。 每个页面数据库的状态与前页数据库的状态是相互独立的。 如果数据库被其他用户改变了,Web页面将检测到并产生相应的动作。 例如,如果你正在修改一个地址而另一个用户在确认修改之前删除了该地址,JSP将通知你修改不存在的地址失败。 图2显示JSPs之间的逻辑关系。 Home.jsp: Home.jsp是AddressBook的主页,也就是用户使用AddressBook时见到的第一个页面。 它用一个表显示Address库中的所有地址。 表中的每一行显示一个地址,以及删除或修改地址的连接。 页面底部有一个添加新地址的连接。 配置信息见web.xmlnotes。 添加地址连接将控制权交给RequestAdd.jsp,删除地址连接将控制权交给RequestDelete.jsp,同时将要删除的地址id传递给该页,修改地址连接将控制权交给RequestModify.jsp,同时将要修改的地址id传递给该页。 RequestAdd.jsp: RequestAdd.jsp提供一个地址表单用于输入新地址。 页面底部的取消连接可以取消这次操作。 提交表单将新的地址域值以及控制权交给DoAdd.jsp,取消操作将控制权交给Home.jsp。 细节请看RequestAdd.jsp的完整的,带有注释的源代码。 DoAdd.jsp: DoAdd.jsp显示接收到的地址域值。 然后将新地址添加到数据库并显示是否成功的信息。 页面底部有一个继续连接。 点击继续连接回到Home.jsp。 RequestDelete.jsp: RequestDelete.jsp读取得到的id相应的地址。 该页面在表中显示地址域以便让你确认删除的是正确的地址。 页面底部的两个连接分别是继续请求的继续连接和取消请求的取消连接。 选择继续连接将转到DoDelete.jsp并传递要删除的地址id,选择取消连接回到Home.jsp。 细节请看RequestDelete.jsp的完整的带有注释的源代码。 DoDelete.jsp: DoDelete.jsp读取传递给它的id。 在表中显示该id对应的地址,从数据库中删除它,并显示是否成功。 页面底部是继续连接。 选择继续连接回到Home.jsp。 RequestModify.jsp: RequestModify.jsp显示一个表单并填入当前的地址,同时提供提交按钮和取消连接。 提交表单将新的地址域值以及控制权交给DoModify.jsp,选择取消连接回到Home.jsp。 DoModify.jsp: DoModify.jsp显示接收到的修改的地址域值。 然后修改数据库中的地址记录,并返回成功与否。 页面底部是继续连接。 选择继续连接回到Home.jsp。 AddressBook的Addresses数据库表: 如何建立数据库取决于所用的数据库软件。 若你用的不是MySQL以下的步骤就需要根据情况修改。 AddressBook只有一个表Addresses,保存在数据库Public中。 表Addresses有七个域: id 主键 自动增长的数据域 surname 长度为24的字符域 保存联系人的姓 firstname 长度为24的字符域 保存联系人的名 street 长度为80的字符域 保存地址的第一行 district 长度为80的字符域 保存地址的第二行 city 长度为40的字符域 保存城市名 postcode 长度为10的字符域 保存邮政编码 首先建立MySQL数据库(MacOSX10.2.1)。 用管理员权限启动mysql命令行工具,需要的话输入密码。 创建Public数据库,以及账号mysqlusername密码mysqlpassord。 命令如下: #mysql-uroot-p mysql>createdatabasePublic; mysql>grantallprivilegesonPublic.* tomysqlusername@localhost\ identifiedby'mysqlpassword' withgrantoption; mysql>flushprivileges; 然后,在Public数据库中创建Addresses表。 mysql>createtableAddresses(\ idint(8)primarykeyauto_increment,\ surnamevarchar(24)notnull,\ firstnamevarchar(24)notnull,\ streetvarchar(80)notnull,\ districtvarchar(80)notnull,\ cityvarchar(40)notnull,\ postcodevarchar(10)notnull\ ); 用命令Commit;提交。 要检查对表的操作是否正确,键入命令describeAddresser;,将得到如下结果: 现在可以插入一行来测试数据库 mysql>insertintoAddresses (surname,firstname,street,district, city,postcode)values ("Smith","John","1,TheHighStreet,", "Downtown,","Metropolis.","X999XX"); mysql>commit; mysql>select*fromAddresses; 结果如下: 注意地址的id被自动赋予值1。 至此AddressesBook的数据库创建完成。 配置AddresBook的开发目录 现在我们配置存放AddressBook源文件的目录,以及Web应用程序的war目录,它也是存放Web应用程序包的目录。 下载AddressBook源程序压缩包。 解压后将得到Ant能够处理的源程序目录结构,如图3所示。 不需要对AddressBook的开发目录进行特殊改变—建议将其解压至你的home目录(MacOS)。 让我们看看这些文件: 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应用程序时把该参数改为新的程序名。 如果在本地机器上运行Tomcat4,则manager.url参数也不必修改。 tomcat.home参数为Tomcat的安装目录,以上的设置表示Tomcat4.1.12安装在/url/local目录下(MacOS)。 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应用的权限。 AddressBook/build.xml: AddressBook/build.xml文件是Ant的配置文件,它使用许多Ant的标签。 以下是比较常用的: antbuild创建Web应用程序 antinstall安装Web应用程序用于测试 antremove卸载Web应用程序 antdeploy安装部署Web应用程序 antundeploy卸载Web应用程序 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为日志日期: "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,其值为mons.dbcp.BasicDataSourceFactory类,URL为jdbc: mysql: //localhost: 3306/Public? autoReconnect=true,JDBC驱动: org.gjt.mm.mysql.Driver,用户名和密码分别为: mysqlusername和mysqlpassword。 以上代码将javax.sql.DataSource作为该Web应用程序的上下文变量。 如果该变量不止被一个Web应用用到,可以将它定义为全局资源。 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: AddressBook/web/WEB-INF/web.xml是AddressBook的web应用部署描述文件。 其中包含两个主要参数: listener参数定义了Java类监听器AddressBook.ContextListener,在程序启动和关闭是被调用。 welcom-file-list参数定义了AddressBook的首页。 如下设置定义AddressBook的首页为Home.jsp。 创建,安装,部署和运行AddressBook: 安装AddressBook是先将当前目录改为AddressBook目录,然后运行Ant的install命令: $cdAddressBook $antinstall 如果安装失败,检查Tomcat的conf目录下的tomcat-user.xml是否配置正确,以及catalina-ant.jar是否从Tomcat的server/lib目录下拷贝到Ant的lib目录。 注意antinstall自动触发运行Ant的若干个标签,依次为antint,antprepare,antbuild和antpackage: antinit初始化时间戳 antprepare在AddressBook目录下创建war目录结构,包括: 一个war目录,一个war/WAR-INF目录,一个war/WEB-INF/classes目录,及一个war/WEB-INF/lib目录。 antbuild创建Web应用程序,包括将jsp文件拷贝到war目录下,将context.xml文件拷贝到war/META-INF目录下,将web.xml文件拷贝到war/WEB-INF目录下,并编译Java文件结果存入war/WEB-INF/classes目录下。 antpackage从war目录创建Web程序包。 Web程序包是由jar工具创建的.jar文件。 最后,antinstall根据war/META-INF/context.xml的配置信息将Web程序包安装到Tomcat中。 你可能注意到不需要登陆root权限或Tomcat就可以安装AddressBook,只要你的普通用户账号即可。 Ant用定义在AddressBook/build.properties中的tomcatusername和tomcatpassword即可安全的执行以上过程。 安装过程因配置选项不同而不同,配置信息具体见AddressBook/build.xml。 图4显示了构成AddressBookWeb应用程序的war目录结构以及各种文件。 在浏览器地址栏中输入地址http: //localhost: 8080/AddressBook测试AddressBook程序。 应该得到如图5的显示结果。 如果应用程序没有正确运行,先检查Tomcat的common/lib目录下有没有数据库的JDBC驱动程序。 如果数据库驱动正确应用程序仍然不正确运行,则检查Tomcat的log目录下的日志文件,这些文本格式的日志文件将帮助你发现错误。 添加地址,然后修改它,再删除它,再添加一个地址。 你将看到id持续自动增加。 开发过程 AddressBook安装成功之后,Tomcat调用AddressBook.ConextListener.contextInitialized创建AddressBook.AddressesDB的一个实例。 AddressBook.AddressesDB通过jdbc/PublicDataSource建立数据库连接。 AddressBook.ConextListener.contextInitialized将AddressBook.AddressesDB的实例作为一个servlet属性(addressesDB)保存。 当AddressBook的Home.jsp第一次被调用,Tomcat编译并执行它。 Home.jsp通过servlet属性addressesDB取得AddressBook.AddressesDB的实例,然后从数据库中读取地址并显示。 其他JSP页面在第一次被使用时也要先编译再执行,读取数据库的方法同Home.jsp。 antstop用于停止AddressBook程序。 Tomcat自动调用AddressBook.ContextListener.contextDestroyed取得上面提到的servlet属性addressesDB和AddressBook.AddressesDB的实例,关闭数据库连接并删除servlet属性addressesDB。 antstart用于启动AddressBook程序。 Tomcat自动调用AddressBook.ConextListener.contextInitialized重复启动过程。 整个Web应用程序的开发过程是这样的: 修改程序;用antinstall创建并安装;在浏览器中键入地址http: //localhost: 8080/applicationName(或点击刷新按钮)以测试Web程序;用antremove删除Web应用程序的上下文信息;重复整个过程,直到调试完毕。 当程序调试完毕后,使用antdeploy正式将你的程序配置到服务
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 如何 使用 Ant Tomcat 创建 Web 应用 详解