struts2

开发Struts 2 最少用到的jar文件：

　　Struts-core-2.x.x.jar : Struts 2 框架的核心类库

　　xwork-2.x.x.jar : XWork类库，Struts 2 在其上构建

　　ognl-2.6.x.jar : Object Graph Navigation Language ， Struts 2 框架通过其读写对象的属性。

　　freemarker-2.3.x.jar : Struts 2 的UI标签的模版使用 Freemarker编写。

　　commons-logging-1.1.x.jar : ASF出品的日志包。

　　commons-fileupload-1.2.1.jar : 文件上传组件。

服务器启动后，根据web.xml加载ActionServlet读取struts-config.xml文件内容到内存

struts流程

。

以登录为例：第一次进login.jsp会先实例化Form、把默认值（String默认为空字符串，整型默认为0）赋给表单元素。

输入用户名密码提交表单、提交到action属性的login.action，通过ActionServlet读struts-config.xml文件找到 action下的path属性找到.action，通过name属性找form-beans中的form-bean的name属性得到ActionForm的包名类名，先实例化form，把表单的值填充给form，调用form的validate方法验证、ActionErrors返回null表示验证通过，否则失败返回input指定的页面.验证通过会实例化Action，执行Action的execute方法。

 

 

 整个配置我们可以分为两大块，一个是在web.xml文件中的配置，另一块是Struts2框架中的配置。框架中的配置又有执行环境的配置和Struts2组件配置。

web.xml配置 
框架执行环境配置(全局配置选项):struts.properties文件 
组件配置文件:struts-default. xml, struts-plugin.xml, strtus.xml 

　　 

1、web.xml文件

FilterDispatcher是一个过滤器。注意，在Struts2.0.X的时候，使用的是 
org.apache.struts2.dispatcher.FilterDispatcher作为核心控制器,而Struts2.1 中改成了org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter。它是整个web应用的配置项，需要在web.xml中进行配置. 

在Struts 2中，Struts框架是通过Filter启动的，他在web.xml中的配置如下：

<!-- 配置Struts2 核心 Filter -->
<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>

　　在StrutsPrepareAndExecuteFilter的init()方法中将会读取类路径下默认的配置文件

struts.xml完成初始化操作。

　　注意：struts 2 读取到 struts.xml的内容后，以javabean形式存放在内存中，以后Struts 2对用户

的每一次请求处理将使用内存中的数据。

　　Filter 过滤器是用户请求和处理程序之间的一层处理程序。它可以对用户请求和处理程序响应的类容进行处理，通常用于权限、编码

转换等场合。

2、ActionSupport 类

     ActionSupport 类为 Action 提供了一些默认实现，主要包括预定义常量、从资源文件中取文本资源、接收验证错误信息和验证的默认实现

3、struts.xml文件

struts.xml需要存放在WEB-INF/classes下，模板如下：

　

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.1//EN" "http://struts.apache.org/dtds/struts-2.1.dtd">
<struts>
</struts>   

　　Struts.xml是 Struts 2 的核心配置文件，主要用于配置开发人员编写的action。

Struts 2 数据验证及验证框架的应用：

　　1、数据校验

　　Action 继承了 ActionSupport 类 ，而该类实现了 Action 、Validateable 、 ValidationAware 、TextProvider、LocaleProvider

Serializable 接口。

　　在Validateable 接口定义了一个 validate() 方法 ， 在用户自定义 Action 类中重写该方法就可以实现 验证功能。

 　　

public class LoginAction extends ActionSupport
{
 
    private String username ;  
    public String getUsername() {
        return username;
    }
     
    public void setUsername(String username) {
        this.username = username;
    } 
    @Override
    public String execute() throws Exception {
        // TODO Auto-generated method stub
        if ( ! username.equals("HelloWorld"))
        {
            Map request = (Map) ActionContext.getContext().get("request") ; 
            request.put("name", getUsername()) ; 
            return SUCCESS;
        }
        else return ERROR ; 
    } 
    public void validate()
    {  
        //如果名字为空，则把错误信息天骄的Action类的fileError
        if (this.getUsername() == null || this.getUsername().trim().equals(""))
        {
            addFieldError("username" , "名字不能为空") ; 
        }
    } 
}

　　在类中定义了校验方法后，该方法会执行系统的  execute() 方法之前执行。如果执行该方法后，Action类的fieldError中已经包含了数据校验错误信息，

将把请求转发到input逻辑视图处，所以在 Action配置中也要配置一下。

　　

        <action name = "LoginAction" class = "com.cnblogs.jbelial.login.LoginAction" >
            <!-- 定义3个逻辑视图和物理资源之间的映射  -->
            <result name = "input">/login.jsp</result>
            <result name = "error">/error.jsp</result>
            <result name = "success">/main.jsp</result>
        </action>

　　注意：

　　result中的name属性有下：

　　1、success ： 表示请求处理成功，该值也是默认值。

　　2、error ：表示请求处理失败。

　　3、none ：表示请求处理完成后不跳转到任何页面。

　　4、input ：表示输入时如果验证失败应该跳转到什么地方。

　　5、login ：表示登录失败后跳转的目标。

　　2、Struts 2 验证框架的应用

　 　Struts 2 提供了大量的数据校验器，包括表单域校验器和非表单域校验器。

　　（1）必填字符串校验器

　　　该校验器的名字是 requiredstring 其校验规则定义文件如下：

　　

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1//EN" 
"http://struts.apache.org/dtds/struts-2.1.dtd">

<validators>
    <field name = "username">
        <!-- 需要验证的字段的字段名 -->
        <field-validators type = "requiredstring">
            <!-- 去空格 -->
            <param name = "trim">true</param>
            <!-- 错误提示信息 -->
            <message>请输入用户名</message>
        </field-validators>
    </field>
</validators>

　　文件命名：ActionName-validation.xml:其中ActionName 就是需要校验的用户自定义的Action 类的名字。而且该文件应该与Action 类文件放置在

同一路径下。

　　（2）必填校验器

　　该校验器的名字就是 required 。该校验器与requiredstring 的差别就是 可以有空字符串。配置如下：

　　

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1//EN" 
"http://struts.apache.org/dtds/struts-2.1.dtd">

<validators> 

        <!-- 需要验证的字段的字段名 -->  

    <field name = "username">
        <field-validators type = "required"> 
            <!-- 错误提示信息 -->
            <message>请输入用户名</message>
        </field-validators>
    </field>
</validators>

　　（3）整数校验器

　　　　该校验器的名字为 int ，该校验器要求字段的整数值必须在一定范围内。配置如下：

　　

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1//EN" 
"http://struts.apache.org/dtds/struts-2.1.dtd">

<validators>
    <!-- 需要验证的字段的字段名 -->
    <field name = "number">
        <field-validators type = "int"> 
            <!-- 数值的最小值 -->
            <param name = "min">50</param>
            <!-- 数值的最大值 -->
            <param name = "max">100</param>
            <!-- 错误提示信息 -->
            <message>大小必须在50至100之间</message>
        </field-validators>
    </field>
</validators>

　　

　　(4) 日期校验器

　　该校验器的名字是 date ， 该校验器要求字段的日期值必须在指定范围类，所以也有 min 和 max 参数。配置格式：

　　

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1//EN" 
"http://struts.apache.org/dtds/struts-2.1.dtd">

<validators>
    <!-- 需要验证的字段的字段名 -->
    <field name = "date">
        <field-validators type = "date"> 
            <!-- 时间的最小值 -->
            <param name = "min">1900-01-01</param>
            <!-- 时间的最大值 -->
            <param name = "max">9999-01-01</param>
            <!-- 错误提示信息 -->
            <message>时间必须在1900-01-01至9999-01-01之间</message>
        </field-validators>
    </field>
</validators>

　　(5) 邮件地址校验器

　　该校验器的名称是 email ，该校验器要求字段的字符如果非空，就必须是合法的邮件地址。格式如下：

　　

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.1//EN" 
"http://struts.apache.org/dtds/struts-2.1.dtd">

<validators>
    <!-- 需要验证的字段的字段名 -->
    <field name = "email">
        <field-validators type = "email">  
            <!-- 错误提示信息 -->
            <message>邮箱地址无效</message>
        </field-validators>
    </field>
</validators>

　　(6) 网址校验器

　　该校验器的名称是 url  , 该校验器要求字段的字符如果非空，就必须是合法的URL地址 。 格式 和 (5)邮箱校验器 类似。

　　(7) 字符穿长度校验器

　　该校验器的名称是 stringlength ，该校验器要求字段的字符长度必须在指定的范围之间 ，所以它有 minLength 和 maxLength 两个参数。

它的个数如 （3）整数校验器 类似。

　　(8) 正则表达式校验器

　　该校验器的名称是 regex ，它检查被校验字段是否匹配一个正则表达式。

3、Struts 2 拦截器：

　　Struts 2 框架的绝大部分功能是通过拦截器来完成的，当FilterDispatcher拦截到用户请求后，大量拦截器将会对用户请求进行处理，然后调用用户

自定义的Action 类中的方法来处理请求。

　　拦截器的配置:

　　在struts.xml文件中来定义的，使用<interceptor.../>元素，格式如下：

　　<interceptor name = "拦截器名" class = "拦截器实现的类">

　　　　<param name = "参数名">参数值</param>

　　</interceptor>

　　其中<param.../>可以省略，但在有的时候就需要为其传入拦截器参数。

　　有时候一个Action要配置不只一个拦截器，往往多个拦截器一起使用来进行过滤。这时候就要配置几个拦截器组成的拦截器栈。定义拦截器栈用

<interceptor-stack.../>，格式如下：

　　<interceptor-stack name = "拦截器栈名">

　　　　<interceptor-ref name = "拦截器一"></interceptor-ref>

　　　　<interceptor-ref name = "拦截器二"></interceptor-ref>

　　　　<interceptor-ref name = "拦截器三"></interceptor-ref>

　　</interceptor-stack>

　　注意：在配置拦截器栈时，用到的拦截器必须是已经存在的拦截器。拦截器栈也可以引用拦截器栈。

　　

　　拦截器实现类：

　　Struts 2 提供了一些接口或类供程序员自定义拦截器。如：com.opensymphony.xwork2.interceptor.Interceptor 接口。

该接口中有三个方法：

　　void init () ：用于初始化资源。

　　String intercept (ActionInvocation invocation) ：用于实现拦截的动作。

　　destroy () ：用于销毁在init()方法中打开的资源。

1.web.xml配置： 
FilterDispatcher是一个过滤器。注意，在Struts2.0.X的时候，使用的是 
org.apache.struts2.dispatcher.FilterDispatcher作为核心控制器,而Struts2.1 中改成了org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter。它是整个web应用的配置项，需要在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>

如果是一个基本的web应用，这样就足够了，剩下的就是配置web应用的一些执行环境配置（全局配置）和web应用中使用到的组件的配置，如action配置，拦截器的配置。 
web应用的执行环境主要是通过struts.properties来完成。应用中的组件配置主要是通过strtus.xml来完成。 

2. struts.properties 文件 
这个文件提供了一种更改框架默认行为方式的机制。在一般情况下，如果不是打算让调试更加方便的话，我们没有必要更改这个文件。哪么这些默认的属性在哪里存放呢？ 
在项目的src目录中可以自己编写一个名称为struts.properties文件，编译以后就放到了/WEB-INF/classes中，Struts2框架在启动的时候，会自动读取这个文件，但是在读取这个文件之前，会先到struts2-core-xxx.jar包中加载名为default.properties文件，这个文件中定义了默认的配置，所以我们可以在strtus.properties中定义一些配置覆盖default.properties中的配置，如果没有struts.properties文件，则采用默认配置。 
打开default.properties文件我们会看到如下部分类容： 
打开该文件，可以看到一些全局的配置选项，在这些选项中，我们发现了有一些这样的配置，其中struts.action.extension 配置的就是Struts默认的请求后缀名。关于更多的配置的含义，后面用到了再讲解，现在暂时不必理会这些配置的含义. 

 

### Used by the DefaultActionMapper
### You may provide a comma separated list, e.g. struts.action.extension=action,jnlp,do
### The blank extension allows you to match directory listings as well as pure action names
### without interfering with static resources.
struts.action.extension=action,,
### This can be used to set your default locale and encoding scheme
# struts.locale=en_US
struts.i18n.encoding=UTF-8

更改默认设置： 

 

### Used by the DefaultActionMapper
### You may provide a comma separated list, e.g. struts.action.extension=action,jnlp,do
### The blank extension allows you to match directory listings as well as pure action names
### without interfering with static resources.
struts.action.extension=action,,
### This can be used to set your default locale and encoding scheme
# struts.locale=en_US
struts.i18n.encoding=UTF-8

 

 

因为default.properties文件是存放在jar包中的，struts2启动的时候自动会寻找到。我们不能直接修改这个文件，但是我们可以使用struts.properties文件来覆盖default.properties文件中的内容。 
在web项目的src的根目录中新建一个struts.properties,然后将想要修改的属性添加到该文件中，就可以覆盖掉原来的配置.注意:这个文件存放在src的根目录中（编译之后放到了/WEB-INF/classes根目录中）： 

 

##激活重新载入国际化文件的功能
struts.i18n.reload=true
##修改请求后缀为action或者do
struts.action.extension=action,do
##打开开发者模式，打开之后，我们修改配置文件之后不用重新启动服务器
struts.devMode =true

 

 

3. struts-default.xml 
这个文件用来加载默认启动的组件。它存放在struts2-core-xxx.jar包的根目录下，系统启动的时候会加载这个文件。这个文件中配置的组件有类型转换组件，拦截器组件还有结果类型组件等等，关于这些组件的概念后面将会讲到，这里只需要了解。 
4. struts-plugin.xml 
可以在struts2中使用插件，Struts2在启动的时候，会自动搜索classpath中的jar包中的struts-plugin.xml文件来加载插件。关于插件的应用，将会在后面讲到。 
5. struts.xml 
struts.xml文件中包含的是我们开发的Action的配置。如前面登录例子中的配置: 

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd" >
<struts>
<!-- 配置常量，覆盖default.properties中的配置 -->
<constant name="struts.action.extension" value="do" />
<!-- struts2的Action必须放在指定的包空间下 -->
<package name="com.wq" extends="struts-default">
<!-- 定义action -->
<action name="login" class="com.wq.web.action.LoginAction">
<!-- 定义处理结果和资源之间的映射关系 -->
<result name="success">/welcome.jsp</result>
<result name="error">/error.jsp</result>
</action>
</package>
</structs>

5.1在struts.xml中覆盖default.properties中的全局配置 
我们修改全局配置的时候，使用struts.properties文件来覆盖default.properties文件中的内容。实际上我们可以不用创建struts.properties文件也可以做到覆盖default.properties文件中的配置，就是直接在strtuts.xml文件中使用<constant>配置:见上面的例子中 

5.2将struts.xml拆分成多个配置文件 
可以想象，在web应用中还会不断的有action需要定义，这样struts.xml的配置会越来越多，文件会越来越大。 
为了避免struts.xml文件过于庞大，臃肿，提高strtus.xml文件的可读性，我们可以将一个struts.xml文件分解成多个配置文件，然后在strtus.xml文件中包含其它配置文件.这样struts2就可以使用模块化的方式来管理struts.xml配置文件了。 
我们可以在配置中使用<include> 来包含另外一个配置文件.下面我们新建一个struts-hello.xml文件，然后在struts.xml文件中包含该文件 

在structs2中配置文件中 
Structs标签中：<include file="struts-hello.xml" />   来引入structs-hello.xml文件实现模块化管理。 


6. 配置文件加载顺序 
配置文件的加载顺序从上到下依次是:我们可以打开struts的源代码，设置断点来跟踪启动顺序。通过分析源代码，得到如下结论： 
1.default.properties： 
该文件存放在strtus2-core-XXX.jar中的org.apache.struts2包中，默认全局配置 
2.struts-default.xml 
该文件存放在strtus2-core-XXX.jar中的根目录下，加载默认的组件，这些组件包括一系列的拦截器和转换器等 
3.struts-plugin.xml 
如果为应用配置了插件，则插件的jar文件中会存在这个文件，它会被自动加载 
4.struts.xml 
自己创建的配置文件，不能改名，用于存放自定义的组件如Action或者拦截器等。这个文件中也可以覆盖default.properties文件中的默认配置 
5.struts.properties 
自己创建的配置文件,不能改名，用于修改全局配置，一般我们将要修改的全局配置放到了struts.xml文件中，所以不需要配置这个文件.如果在struts.xml和struts.properteis中同时配置，则以strtus.properties中的为准 

7. struts.xml—包配置： 
在strtuts2中，核心组件就是Action,拦截器等，struts2 框架使用包来管理Action和拦截器等。每个包就是多个Action，多个拦截器等的集合.package中有下面几个属性： 
 name：这是一个必填属性，该属性指定该包的名字，该名字是该包被其它包引用的key 
 extends:可选属性。指定该包继承其它包。继承其它包，可以继承其它包中的Action定义。 
 abstract：可选属性。指定该包是不是一个抽象包。抽象包中不能包含Action定义。 

在前面的配置中：继承了stuts2的默认包struts-default,那么这个默认包在哪里定义的呢？我们可以查看struts2-core-XXX.jar包中有一个struts-default.xml文件 

这个文件中配置了很多的<bean> 标签和一个<package>标签，<package>标签的name就是struts-default.这个默认的包空间中定义了struts2内建的Result类型，拦截器等。Struts2 框架每次都会自动加载该文件。我们在strtus.xml文件中继承了默认的包空间，所以struts-default.xml文件一定比strtus.xml文件先加载. 
只有继承了正确的父Package，才能用到所需的预先配置好的特性。在大多数情况下，我们都应该继承“struts-default.xml”配置文件中的“strust-default”Package 

8.struts.xml—Action配置： 
Action只是一个控制器，它并不直接对请求者生成任何响应。因此，Action处理完用户请求后，Action需要将指定的视图资源呈现给用户。因此，配置Action的时候，应该配置逻辑视图和物理视图资源之间的映射。 
配置逻辑视图和物理视图之间的映射关系是通过<result>来定义的，每个<result> 元素定义逻辑视图和物理视图之间的一次映射，如下面的配置: 

<struts>
<constant name="struts.action.extension" value="do"></constant>
<package name="com.wq" extends="struts-default">
<action name="login" class="com.wq.web.action.LoginAction">
<result name="success">/welcome.jsp</result>
<result name="error">/error.jsp</result>
</action>
</package>
</struts>

 

下面是Action配置中属性的说明： 
name:提供了执行Action所对应的URL地址，上面是“login.do” （我们已经将请求路径的后缀改成了*.do） ，默认是 login.action。 
class: Action类的完整的类名 

下面我们再看看<result>标记: 
我们可以看到在result节点中多了“name”属性，实际上这个属性是一直都存在的，如果开发人员没有显式指定它的值，那么它的默认值就是“success”,所以上面的配置可以改成: 

<action name="login" class="com.wq.web.action.LoginAction">
<result >/welcome.jsp</result>
<result name="error">/error.jsp</result>
</action>
</package>
</struts>

 

使用通配符匹配Action： 
先看一个domo：

<?xml version="1.0"?>
<!DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN"
    "http://struts.apache.org/dtds/struts-2.1.7.dtd">
<struts>
     <constant name="s" value=""></constant>
    <!-- 设置开发模式 -->
    <constant name="struts.devMode" value="true" />
    <constant name="struts.action.extension" value="action,do" />
    <!-- 此三行为了解决不换行问题而加上的 -->
    <constant name="struts.ui.theme" value="simple" />
    <constant name="struts.ui.templateDir" value="template" />
    <constant name="struts.ui.templateSuffix" value="ftl" />


    <package name="cn.ouuo.action" extends="struts-default" >

         <action name="SearchUser_*" class="searchAction" method="{1}">
            <result name="listResult">/listResult.jsp</result>
            <result name="listData">/more.jsp</result>

            <result name="wordPre">/officePre.jsp</result>
             <result name="manager">/manager.jsp</result>
            <result name="success">/success.jsp</result>
        </action>

    </package>
</struts>

 

在这里我主要是想说一下自己以前比较迷惑的地方，主要就是在action配置的几个参数，其实name属性就是要访问的Url地址，method中的1就是与 name里的* 进行匹配的，方法就是你在action中定义的各个方法，result里的name属性就是你action里返回的字符串，根据这个属性来确定跳转页面 

比如要访问：http:localhost:8080/SearchUser_Manager.action