通过实例学习Struts2 - 从struts-blank开始 (1)

本文链接：https://blog.csdn.net/nylx/article/details/11853251

最近发现一些网站在Copy&Paste我的文章，请尊重我的劳动成果，在转载的时候注明出处，谢谢。

前言

一直用Struts1 , 现在新的项目要转向Struts2了，先研究学习一下，做点技术储备。

我一直认为计算机软件行业是一个实践性非常强的行业，书读了多少都不管用，一定要卷起袖子，亲自动手，才能学到一门技术的精髓，才能谈得上精通。

否则浮在表面，只懂概念，夸夸奇谈，一进入真正的项目就傻眼了。

但是自己完全从零开始来学习一个技术还是太慢了，一定要找到一个切入点，就像打仗一样，集中优势兵力，从一点突破，向纵深发展，迂回包抄，各个歼灭。

这个切入点就是优秀的源代码，看看大牛们是怎么做的，然后模仿学习，能极大的减少你学习的时间。

现在市面上有很多讲Struts2的书籍，Struts2权威，大全，指南，鱼龙混杂，我的观点是先不要急着读他们，先找一本小册子了解一下基本知识，然后找优秀的Struts2项目代码学习，在学习思考，不仅仅要知道What, How, 要多问自己几个Why , 假想一下如果让你去设计，你会怎么做，然后和Struts 的设计思想对比，这样才能真正的提高。

至于那些“权威/大全/指南” ，我更多的会用来查找技术细节，作为参考书。

基于这个思路，先在网上搜索了一本InfoQ的书 <<深入浅出Struts2>> , 还凑合，很快就能翻完，建立了一个基本印象。

至于优秀的Struts2项目代码，没有找到合适的，决定拿struts2 中自带的应用来研究学习，毕竟是官方出品，差不到哪儿去。

哪位同学知道更好的使用Struts2的项目源码，请不吝赐教。

建立环境

废话说了这么多，赶紧开工

先来准备环境:
1. 从Struts2官网下载源码： http://struts.apache.org/release/2.1.x/，写这篇文章的时候版本是struts-2.3.15.1，注意下载那个Full Distribution，会包含源码和例子
2. 开发工具当然少不了，从http://www.eclipse.org/downloads/ 下载一个 “Eclipse IDE for Java EE Developers,” 这个版本可以和Web Server和 Application Server集成
3. 用Tomcat做Web服务器吧： http://tomcat.apache.org/ ,我下载的版本是7.0.42

把下载的struts2 解压开，里边有个struts-2.3.15.1/apps 目录，其中就是我们要的所有项目例子

这里的WAR包都是直接可以放到Tomcat中运行的，但是为了研究，我们需要把它解开，别告诉我你不知道怎么解压开WAR 文件啊 :-)

从名称来看struts2-blank.war最简单，解压开大概是这个样子

启动Eclipse 启动，在Preferences -> Server -> Runtime Enviroment 中添加一个Apache Tomcat 7 的 Server runtime , 具体过程就不说了，相信各位同学都能轻松搞定

建立一个Dynamic Web project ,名称就叫做struts2-blank 吧，然后重要的步骤来了：

(1) 把上面图片中的所有文件都Copy到新建项目的WebContent下, 如果Eclipse 提示是否覆盖文件的话，就选择“是”

(2) 然后把WEB-INF/src/java 下的所有文件都copy 到 struts-blank项目的 src 目录下 ------ 这是真正的源代码

(3) 删除WEB-INF/src 目录，清空WEB-INF/classes 目录 ---- 这些目录没用了

最好系统长这个样子：

建立一个基于Tomcat7 的Server ，用来部署项目，然后把struts2-blank 这个web 项目加到Server 中，启动server , 就能看到tomcat server 在启动，然后就是struts2 启动的log 了

在浏览器中运行 http://localhost:8080/struts2-blank/ 就能看到最最简单的界面了：

看起来费了很大的劲，实际上还是挺简单的，之所以要建立一个Eclipse 环境，主要是为了看源代码方便。

对于Struts2自带的其他例子，各位同学如法炮制即可

Struts2 blank project

终于可以开始看源码了, 首先引起我注意的就是struts.xml , 是直接放在Eclipse 项目的src 目录下，这就意味着运行时Eclipse 会自动把它copy到WEB-INF/classes 目录下，和编译过的java class文件放在一起，而在struts1 中，配置文件叫做struts-config.xml , 是直接放在WEB-INF 目录下的，这是一个很大的区别。

打开这个文件瞧一瞧：

    <constant name="struts.devMode" value="true" /> <--- 肯定是指定开发模式

    <package name="default" namespace="/" extends="struts-default">

        <default-action-ref name="index" /> <--- 指定缺省的Action引用，在下面定义
        <global-results>
            <result name="error">/error.jsp</result> <--- Global result, Action的结果如果是error,就可以用这个result
        </global-results>

        <global-exception-mappings>
            <exception-mapping exception="java.lang.Exception" result="error"/> <--- 这个功能不错，把所有的代码异常都映射到error这个result
        </global-exception-mappings>

        <action name="index">
            <result type="redirectAction"> <--- 调用另外一个Action : "/example/HelloWorld" , namespace其实指的就是url
                <param name="actionName">HelloWorld</param>
                <param name="namespace">/example</param>
            </result>
        </action>
    </package>

    <include file="example.xml"/> <--- 不错，可以include 别的文件，模块化更好，更容易支持团队开发

顺藤摸瓜，再来看看example.xml

    <package name="example" namespace="/example" extends="default"> <---注意namespace是/example, 即这个package下面的所有action 调用都得这么写： 
                                                                    <---http://xxxx/structs-blank/example/xxxx

        <action name="HelloWorld" class="example.HelloWorld">   <--- 很明显， 这里的Action 实现类是HelloWorld, 可以猜测到，执行成功的话会调用
                                                                <--- HelloWorld.jsp
             <result>/example/HelloWorld.jsp</result>
        </action>

      ......
    </package>

赶紧瞄一眼HelloWorld.java

public class HelloWorld extends ExampleSupport {
    //毫无疑问，这个方法会被调用，设置一个消息的key (HelloWorld.message) 然后返回sucess, 
    //在package.properties中能看到Helloworld.message , 但是struts2到底是怎么调用它的呢？先别着急，
    //记下问题， 先看完整个流程再说
    public String execute() throws Exception {  
        setMessage(getText(MESSAGE));          
        return SUCCESS;                         
    }

    /**
     * Provide default valuie for Message property.
     */
    public static final String MESSAGE = "HelloWorld.message";

    /**
     * Field for Message property.
     */
    private String message;

    /**
     * Return Message property.
     *
     * @return Message property
     */
    public String getMessage() {
        return message;
    }

    /**
     * Set Message property.
     *
     * @param message Text to display on HelloWorld page.
     */
    public void setMessage(String message) {
        this.message = message;
    }
}

 在HelloWorld.jsp中，有这么一句  <h2><s:property value="message"/></h2>  ， 可以猜测这里的message 应该和Action 中的getMessage()有关联， 要不然struts2如何拿到message 的值？

 这样，基本的流程就走完了， 我们看到了struts2的Action定义是在struts.xml 中（以及其他被include的xml 文件）， Action 的execute方法会被调用， jsp中可以引用Action中设置的属性的值。
 好像还少了点什么东西， 对了，struts2到底是通过什么配置起作用的？ 答案当然是在web.xml 中

    <filter>
        <filter-name>struts2</filter-name>
        <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
    </filter>

    <filter-mapping>
        <filter-name>struts2</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

和Struts1 不同， Struts2是用一个filter 来处理所有请求的。

如果你之前有struts2开发经验的话，可能会注意到这里使用的不是FilterDispatcher，而是StrutsPrepareAndExecuteFilter 。

这是因为对于Struts2的老版本，使用的是FilterDispatcher，对于2.1.3以上的版本，就开始使用StrutsPrepareAndExecuteFilter了

今天就到此为止吧，明天再仔细看一下其他的分支。