Struts框架入门指南

# Struts框架入门指南 ## 1. 前置假设与约定 ### 1.1 前置假设 若要学习Struts开发，需具备一定Struts使用经验，了解如何构建和部署J2EE Web应用程序。运行示例Web应用程序需要像Tomcat或Resin这样的Servlet容器，尽管像JBoss、Weblogic和WebSphere这样的完整J2EE应用服务器也能正常工作，但由于解决方案未使用Enterprise JavaBeans，所以并非必需。多数示例应用程序是在运行Tomcat 5.0.29的Windows XP机器上构建和测试的，浏览器主要使用Firefox（版本1.0）。 ### 1.2 编程约定 为减少Struts中大量易混淆术语带来的困扰，采用了以下编程约定： - **action**：指动作的概念。 - **Action**：指Java类。 - **action**：指XML文件中的`<action>`元素。 Java类和接口始终以等宽字体书写，首字母大写。引用类的特定方法时，采用`ClassName.methodName()`的约定，这并不意味着该方法是静态的，只是一种方便的引用方式。引用XML、HTML和JSP元素及标签时，省略尖括号，如`forward`、`td`和`bean:write`。引用Struts配置文件时，使用规范名称`struts-config.xml`，不过也可使用自定义名称。同样，Validator和Tiles配置文件使用规范名称`validation.xml`和`tiles-defs.xml`。 ### 1.3 排版约定 - **普通文本**：表示菜单标题、菜单选项、菜单按钮和键盘快捷键（如Alt和Ctrl）。 - **斜体**：表示新术语、URL、电子邮件地址、文件名、文件扩展名、路径名、目录和Unix实用程序。 - **等宽字体**：表示命令、选项、开关、变量、属性、键、函数、类型、类、命名空间、方法、模块、属性、参数、值、对象、事件、事件处理程序、XML标签、HTML标签、宏、文件内容和命令输出。 - **粗体等宽字体**：表示用户应逐字输入的命令或其他文本。 - **斜体等宽字体**：表示应替换为用户提供值的文本。 ## 2. Struts框架概述 Struts框架在过去一年中人气急剧上升。自2003年6月Struts 1.1发布以来，它已成为开发复杂基于JSP的Web应用程序最流行的框架之一。Struts用户邮件列表的流量很大，通常每天有70条消息。尽管很受欢迎，但如何开始使用Struts进行开发仍是常见话题。以下将介绍如何下载和部署Struts示例应用程序。 ### 2.1 下载Struts #### 2.1.1 问题 想要开始使用Struts开发应用程序。 #### 2.1.2 解决方案 从[http://struts.apache.org/acquiring.html](http://struts.apache.org/acquiring.html)下载Struts的二进制和源代码分发版，并将示例应用程序部署到Web容器中。 #### 2.1.3 讨论 对于Struts新手开发者，常见问题是选择哪个版本。毫无疑问，任何新的Struts项目都应使用最新的最佳可用版本。目前，Struts 1.2.4（本文中简称Struts 1.2）已正式发布。对于想体验最新Struts功能的开发者，Struts Nightly Build可让你提前了解Struts 1.3。 拥有二进制和源代码分发版很有用。二进制分发版包含Struts JAR文件和相关依赖JAR文件；源代码分发版包含Struts框架本身的源代码、Struts标签库的Java源代码，以及所有示例应用程序的Java源代码、部署描述符、HTML页面和JSP页面。这些分发版的具体内容会因是最新发布版本还是Struts Nightly Build而有所不同。 Struts 1.2发布版本的二进制分发版包括基本的README文件、安装文档和发行说明。`lib`文件夹包含Struts JAR文件以及Jakarta Commons项目的依赖JAR文件。`contrib`文件夹包含对Struts分发版的贡献，但不被视为Struts核心的一部分，例如Struts - EL的JAR文件和示例Web应用程序，Struts - EL允许在Struts标签中使用JSTL（JSP标准标签库）风格的表达式语言，因此包含JSTL标签库。 Struts 1.2发布版本的源代码分发版包含Struts框架的源代码以及示例应用程序的源代码和Web资源。此外，`contrib`文件夹包含Struts社区贡献的源代码，这些贡献目前不是Struts核心的一部分，但未来可能会成为核心的一部分，一些特别有趣的贡献如下： - **Struts - EL**：为Struts标签提供JSTL表达式语言支持。 - **Struts - Faces**：支持Struts应用程序与Java Server Faces技术集成的框架层。 - **Scaffold**：一组用于协助将数据层（模型）与Struts集成的基类和辅助类。 下载源代码和二进制分发版后，需部署Struts中包含的示例应用程序。 ### 2.2 部署Struts示例应用程序 #### 2.2.1 问题 想将Struts MailReader示例应用程序部署到Tomcat。 #### 2.2.2 解决方案 若Tomcat未运行，可从[http://jakarta.apache.org/tomcat](http://jakarta.apache.org/tomcat)下载。本方案假设使用Tomcat 5，需设置Struts和Tomcat的环境变量，将Struts示例WAR文件复制到Tomcat，然后启动Tomcat。若使用Struts 1.2，Struts示例应用程序的WAR文件已从`struts-example.war`更改为`struts-mailreader.war`。 - **Windows机器命令**： ```plaintext C:\>set STRUTS_HOME=c:\jakarta-struts-1.1 C:\>set CATALINA_HOME=c:\tomcat5 C:\>copy %STRUTS_HOME%\webapps\struts-example.war %CATALINA_HOME%\webapps 1 file(s) copied. C:\>%CATALINA_HOME%\bin\startup Using CATALINA_BASE: c:\tomcat5 Using CATALINA_HOME: c:\tomcat5 Using CATALINA_TMPDIR: c:\tomcat5\temp Using JAVA_HOME: c:\j2sdk1.4.2 ``` 最后一条命令`%CATALINA_HOME%\bin\startup`启动Tomcat。在Windows上，Tomcat将在单独的终端窗口中启动，该窗口的输出会显示已部署的应用程序信息和Tomcat的状态。 - **Unix/Linux机器命令**： ```plaintext $ export STRUTS_HOME=/usr/local/jakarta-struts-1.1 $ export CATALINA_HOME=/usr/local/tomcat5 $ cp $STRUTS_HOME/webapps/struts-example.war $CATALINA_HOME/webapps $ $CATALINA_HOME/bin/startup.sh Using CATALINA_BASE: /usr/local/tomcat5 Using CATALINA_HOME: /usr/local/tomcat5 Using CATALINA_TMPDIR: /usr/local/tomcat5/temp Using JAVA_HOME: /usr/local/j2sdk1.4.2 ``` Tomcat将作为后台进程启动，可使用以下命令监控Tomcat的输出： ```plaintext $ tail -f $CATALINA_HOME/logs/catalina.out ``` 除操作系统文件路径不同外，输出与Windows上的输出相同。 部署完成后，在浏览器中访问[http://localhost:8080/struts-example](http://localhost:8080/struts-example)，应能看到Struts示例应用程序页面。 #### 2.2.3 讨论 使用和检查`struts-example` Web应用程序是学习Struts的绝佳辅助工具。编写第一个Struts应用程序之前，应了解`struts-example`应用程序的工作原理，最佳方法是部署该应用程序，通过实验界面并查看源代码来深入学习。部署`struts-example`需要下载Struts的二进制和源代码分发版，WAR文件包含在二进制分发版中，源代码包含在源代码分发版中。 除`struts-example`应用程序外，其他Web应用程序展示了Struts的其他功能，如下表所示： **Struts 1.1示例应用程序** | WAR文件 | 描述 | | --- | --- | | struts-blank.war | 一个样板Struts应用程序。 | | struts-documentation.war | Struts用户指南和标签库参考文档。 | | struts-example.war | 经典的Struts Mail Reader示例，展示了Struts提供的大多数基本核心功能。 | | struts-exercise-taglib.war | 一个测试Struts标签库功能的应用程序。 | | struts-upload.war | 展示如何使用Struts的文件上传支持。 | | struts-validator.war | 演示如何在Struts中使用Validator。 | | tiles-documentation.war | 包含Tiles文档、示例布局和教程。 | **Struts 1.2示例应用程序** | WAR文件 | 描述 | | --- | --- | | struts-blank.war | 一个样板Struts应用程序。 | | struts-documentation.war | Struts用户指南和标签库参考文档。 | | struts-examples.war | 替代了`struts-exercise-taglib.war`、`struts-upload.war`和`struts-validator.war`，将标签库、上传和Validator示例合并到一个应用程序中。 | | struts-mailreader.war | 经典的Struts Mail Reader示例，展示了Struts提供的大多数基本核心功能。 | | tiles-documentation.war | 包含Tiles文档、示例布局和教程。 | ## 3. 总结 通过以上步骤，我们完成了Struts的下载和示例应用程序的部署。这为进一步学习和使用Struts框架开发复杂的JSP Web应用程序奠定了基础。后续可根据需求深入研究Struts的各项功能，利用示例应用程序进行实践和探索。 ```mermaid graph LR A[开始] --> B[下载Struts] B --> C[设置环境变量] C --> D[复制WAR文件到Tomcat] D --> E[启动Tomcat] E --> F[访问示例应用程序] F --> G[学习和实践] G --> H[开发Struts应用程序] H --> I[结束] ``` 通过这个流程图，我们可以清晰地看到从开始到最终开发Struts应用程序的整个过程。首先下载Struts，然后进行环境变量设置和文件复制，启动Tomcat后访问示例应用程序进行学习和实践，最后利用所学知识开发自己的Struts应用程序。 ## 4. Struts开发的其他相关要点 ### 4.1 代码使用说明 在开发过程中，通常可以在自己的程序和文档中使用相关代码。一般情况下，无需获得授权，除非要复制大量代码。例如，编写一个使用多个代码片段的程序不需要授权，但出售或分发示例代码的CD - ROM则需要授权。引用代码回答问题也不需要授权，但将大量示例代码纳入产品文档则需要授权。虽然不强制要求，但我们鼓励进行代码来源的标注，标注通常包括标题、作者、出版商和ISBN。例如：“Jakarta Struts Cookbook by Bill Siggelkow. Copyright 2005 O'Reilly Media, Inc., 0 - 596 - 00771 - X.”。如果觉得自己对代码示例的使用超出了合理使用范围或上述授权范围，可联系[email protected]。 ### 4.2 反馈与支持 如果对相关内容有评论或问题，可以向以下地址反馈： - **邮寄地址**：O'Reilly Media, Inc. 1005 Gravenstein Highway North, Sebastopol, CA 95472 - **电话**： - 美国或加拿大：(800) 998 - 9938 - 国际或本地：(707) 829 - 0515 - **传真**：(707) 829 - 0104 此外，O'Reilly为相关内容维护了一个网页，列出了勘误表、示例和其他额外信息，可访问[http://www.oreilly.com/catalog/jakartastrutsckbk](http://www.oreilly.com/catalog/jakartastrutsckbk)。若要对内容进行评论或提出技术问题，可发送电子邮件至[email protected]。更多关于O'Reilly书籍、会议、资源中心和O'Reilly网络的信息，可查看O'Reilly的网站[http://www.oreilly.com](http://www.oreilly.com)。 ### 4.3 Safari在线资源 当看到喜欢的技术书籍封面上有Safari® Enabled图标时，意味着该书可通过O'Reilly网络Safari Bookshelf在线获取。Safari提供了比电子书更好的解决方案，它是一个虚拟图书馆，可轻松搜索数千本顶级技术书籍，复制粘贴代码示例，下载章节，并在需要最准确、最新信息时快速找到答案。可在[http://safari.oreilly.com](http://safari.oreilly.com)免费试用。 ## 5. Struts开发的致谢 Struts开发的成果离不开众多人员的努力和贡献： - **编辑团队**：特别感谢O'Reilly的编辑Brett McLaughlin，他的耐心和鼓励帮助克服了许多困难时期，并且始终强调质量至上。 - **家人支持**：作为兼职开发者，在编写、研究和编码过程中，家人给予了极大的支持。妻子Debbie、儿子Kyle和Cameron做出了很多牺牲，他们的鼓励和耐心是一种福气。还有兄弟Ed以及父母，母亲虽然可能不太清楚“Strut”是什么，但一直保持着兴趣。 - **前期工作者**：Chuck Cavaness和Brian Keeton的前期工作为开发奠定了基础。Chuck的《Programming Jakarta Struts》是Struts文献的经典之作，为后续开发提供了重要指导。他们还编写了初步的开发方案，帮助顺利开启开发工作。 - **技术编辑**：Ted Husted、James Mitchell和James Holmes作为技术编辑，给予了很多帮助。Ted堪称Struts传奇人物，他提供了历史视角，有助于理解Struts的演变。James Mitchell和James Holmes不仅是受尊敬的同事，更是好朋友，他们在整个过程中投入了时间、精力并给予鼓励。特别是James Mitchell推荐成为开发者，并协助完成了初始章节大纲；James Holmes允许参与他的《Struts: The Complete Reference》的编写。 - **社区贡献者**：Struts开发者社区也功不可没，书中的许多开发方案基于struts - user邮件列表上的常见和不常见问题、答案及讨论。虽然已尽力对特定开发者提供的解决方案给予赞誉，但可能仍有遗漏，在此表示歉意，若有重大遗漏请告知。 - **其他贡献者**：Craig McClanahan开发了Struts并在Struts - Faces开发方案中提供帮助；Jonathan Freeman和Stephanie Peretti弥补了图形和西班牙语方面的不足；Niall Pemberton和Hubert Rabago对多个开发方案提供了出色反馈；Rick Reumann在他的“Struttin' with Struts”网站上提供了优秀教程；好友Anuj Soni多年来的友谊、建议和鼓励也是一种福气。 ## 6. Struts开发流程总结 ### 6.1 开发流程步骤 以下是使用Struts进行开发的主要步骤总结： 1. **准备环境**：确保具备一定Struts使用经验，了解J2EE Web应用程序的构建和部署。准备好Servlet容器，如Tomcat或Resin。 2. **下载Struts**：从[http://struts.apache.org/acquiring.html](http://struts.apache.org/acquiring.html)下载Struts的二进制和源代码分发版。 3. **部署示例应用**：设置Struts和Tomcat的环境变量，将示例WAR文件复制到Tomcat并启动，通过浏览器访问示例应用程序进行学习。 4. **学习参考资料**：利用示例应用程序、Struts用户指南和标签库参考文档等资料深入学习Struts。 5. **开发实践**：根据需求开始开发自己的Struts应用程序，参考已有代码示例，注意代码使用的授权问题。 6. **反馈与改进**：在开发过程中遇到问题或有建议，及时向相关渠道反馈，不断改进和完善应用程序。 ### 6.2 开发流程可视化 ```mermaid graph LR A[准备环境] --> B[下载Struts] B --> C[部署示例应用] C --> D[学习参考资料] D --> E[开发实践] E --> F[反馈与改进] F --> E ``` 这个流程图展示了Struts开发的循环流程。从准备环境开始，依次进行下载、部署、学习、开发，在开发过程中不断反馈和改进，形成一个持续优化的开发过程。 ## 7. 总结与展望 通过上述内容，我们全面了解了Struts开发的各个方面，包括前置假设、编程约定、下载部署、代码使用、反馈支持以及相关人员的贡献等。Struts作为一个成熟的框架，为开发复杂的基于JSP的Web应用程序提供了强大的支持。 未来，随着Web技术的不断发展，Struts可能会不断演进和完善。开发者可以持续关注Struts社区的动态，利用社区的资源和经验，不断提升自己的开发能力，开发出更加高效、稳定和功能丰富的Web应用程序。同时，也可以积极参与社区贡献，为Struts的发展贡献自己的力量。