应用开发者指南--process.html

应用开发者指南

开发流程

目录

开发流程 1.    一次性安装开发需要的Ant和Tomcat 2.    创建项目源代码目录 3.    编译源代码和目录 4.    编译web应用 5.    测试您的web应用 6.    创建一个发布版本

 

开发流程

尽管应用开发有很多形式，本手册提供的是使用Tomcat开发web应用的最普遍的流程。下面的章节中把开发者会执行的命令和任务进行了高亮显示。在任何给定的时间里，您要开发多个应用时，也可以使用相同的基本方法，只要你有合适的源代码控制系统和内部团队规则。 下面的任务描述假定您使用CVS源代码控制系统，并且您已正确配置了访问CVS仓库的权限。如何操作CVS的命令不在本手册的讨论范围之内。如果您使用的是另外的源代码控制环境，您需要找出您的系统中相应的命令。 一次性安装开发的Ant和Tomcat 为了利用和Manager web应用交互的特定Ant任务，您需要执行一次下面的任务（无论您要开发多少web应用）。 ·   配置Ant定制任务。Ant定制任务的执行代码在Jar包$CATALINA_HOME/lib/catalina-ant.jar中，该jar包必须拷贝到Ant的安装的lib目录中。  ·   定义一个或多个Tomcat用户。Manage web应用运行时有安全限制，它需要先有一个用户登录，该用户拥有管理员的安全角色。如何定义这个用户依赖于Realm，它在Tomcat的conf/server.xml中定义，参考Realm Configuration HOW-TO来获取更多信息。您可以定义任意数量拥有管理员角色的用户（可以使用任何您喜欢的用户名和密码）。   创建项目源代码目录 第一步就是要创建一个新工程的的源代码目录，并且定制您需要的使用的build.xml和build.properties。目录结构在前一章中描述过了，或者您可以使用sample application开始。 创建您的工程的源代码目录，并且在您的CVS仓库中定义。这可以使用一系列的命令来完成，假定{project}是您将保存到CVS仓库中的工程的目录名，而{username}是您的登录用户名： cd {my home directory} mkdir myapp    <-- Assumed "project source directory" cd myapp mkdir docs mkdir src mkdir web mkdir web/WEB-INF cvs import -m "Initial Project Creation" {project} \         {username} start 现在，为了验证目录已经在CVS中是否正确创建，我们将执行工程的checkout： cd .. mv myapp myapp.bu cvs checkout {project} 下一步，您需要创建并check in 一个开发用的build.xml的初始版本。为了更快速更容易的开始，请使用本手册包含的basic build.xml file作为build.xml的模板，您也可以完全从零开始手写build.xml. cd {my home directory} cd myapp emacs build.xml        <-- if you want a real editor :-) cvs add build.xml cvs commit 在你执行CVS commit之前，你的所有在开发目录中的修改都是本地的。只有您提交了，才会使修改对您团队中使用CVS仓库的其他开发者可见。 下一部就是要定制Ant属性，这些属性在build.xml脚本中命名。可以通过在顶层目录中创建名字为build.properties文件来完成。所支持的属性在样例build.xml的注释中列出了。最低限度，您需要定义catalina.home属性，用于定义Tomcat6的安装位置，以及管理员应用的用户名和密码。您可以像下面这样结束脚本： # Context path to install this application on app.path=/hello   # Tomcat 6 installation directory catalina.home=/usr/local/apache-tomcat-6.0   # Manager webapp username and password manager.username=myusername manager.password=mypassword 一般情况下，您不想把build.properties check in到CVS仓库中，因为这个文件对每个开发者是独一无二的。 现在开始创建web应用部署描述符的初始版本。您可以以basic web.xml file 作为您的web.xml的基础，或者从开手工编码来定义。 cd {my home directory} cd myapp/web/WEB-INF emacs web.xml cvs add web.xml cvs commit 注意这仅仅是样例web.xml文件。完整的部署描述符信息的定义在Servlet Specification中。   编辑源代码和页面 编辑/构建/测试任务一般是开发和维护过程中最普遍的活动。下面的原则一般都是适用的。正如Source Organization所描述的，新创建的源文件应该放在您的工程源代码目录中合适的子目录中。 无论何时您想刷新你的开发目录，从而获取其它开发人员体提交的修改，您都需要通过CVS来实现： cd {my home directory} cd myapp cvs update -dP 想要创建一个新文件，进入合适的目录，新建文件，然后在CVS中注册。当您对文件的内容满意了（在构建和测试成功之后），把新文件提交到仓库中。例如，创建一个新的JSP页码： cd {my home directory} cd myapp/web           <-- Ultimate destination is document root emacs mypage.jsp cvs add mypage.jsp ... build and test the application ... cvs commit 在包中定义的Java源代码必须组织成和包结构一致的目录形式（在src/子目录下）。例如，一个名叫com.mycompany.mypackage.MyClass.java 的Java类a应该存储在src/com/mycompany/mypackage/MyClass.java. 无论何时您创建了一个子目录，不要忘记在CVS中注册。 如果您要编辑一个已经存在的文件，您通常只需要编辑并测试，然后在一切OK之后提交修改的文件。尽管CVS可以配置成修改文件前必须“检出”或“锁定”文件，但这通常并不用。   构建web应用 当您已经准备好编译应用了，发出下面的命令(通常您会需要开一个shell窗口，并设置工程的源代码目录为当前路径，这样就只需要最后的命令)： cd {my home directory} cd myapp               <-- Normally leave a window open here ant 在build.xml中，Ant工具会行默认的“compile”目标，它将编译任何新增或更新的java代码。如果您在“build clean”后第一执行，它会使所有的文件都重新编译。 如果您要重新编译整个应用，请使用下面的命令： cd {my home directory} cd myapp ant all 在检入代码修改之前，执行上面的命令是一个非常好的习惯，这样可以确保您没有引入任何Javac无法坚持出来的细微问题。   测试您的Web应用 为了测试您的应用，您会把应用在Tomcat安装。最快的方法是使用定制的Ant任务，这在样例build.xml中也是包含的。这些命令的使用可能是像下面这个样子： ·   如果需要，启动Tomcat6。 如果Tomcat6还未运行，您需要以普通的方式启动它。  ·   编译您的应用。执行ant compile命令（或只执行ant，因为compile目标是缺省的）。 请确保没有编译错误。 ·   安装应用。 执行ant install命令。这个命令会告诉Tomcat立刻运行应用，应用会运行在构建属性app.path定义的上下文路径上。为使应用的安装生效，不一定需要重启Tomcat。. ·   测试应用。.使用您的浏览器或其它的测试工具来测试您的应用的功能。 ·   修改并在需要时重新构建。.当您发现必须修改，就在源代码文件中修改，请不要在构建的输出目录中修改，然后重新发起ant compile命令。这会保证您的修改在以后是可以被保存的(通过cvs commit命令) —— 输出目录会根据需要删除或重新创建。  ·   重新加载应用。Tomcat会自动识别JSP页面的修改，但它会继续使用旧的servlet或JavaBean，知道应用被重新加载。您可以通过ant reload命令来触发重新加载。  ·   完成后删除应用。.当您完成了这个应用，您可以将它从活动的执行中删除，这需要使用ant remove命令。 当完成测试后，请不要忘记在源代码仓库中提交您的修改！   创建发布版本 当您做完了新功能，并且所有内容都经过了测试(您已经测试过了，不对吗？J), 就可以创建web应用的发布版本了，它可以部署到生产服务器上。这需要下面的通用步骤： ·   从工程源代码目录中发起ant all命令，最后一次从头开始重新构建所有的内容。 ·   使用cvs tag命令来为当前发布的所有源代码打个标签。这可以使您在以后可靠地使用源代码重建构建一个版本。 ·   发起ant dist命令来创建可发布的web应用包（WAR文件），同时创建一个包含所有源代码的jar文件。 ·   依照您所在组织的标准发布流程，使用tar或zip工具把dist目录里所有内容打包。