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中进行配置. 

 
[html] view plain copy
 
  1.    
  2. <filter>  
  3. <filter-name>struts2</filter-name>  
  4. <filter-class>  
  5. org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter  
  6. </filter-class>  
  7. </filter>  
  8. <filter-mapping>  
  9. <filter-name>struts2</filter-name>  
  10. <url-pattern>/*</url-pattern>  
  11. </filter-mapping>  
  12.    




如果是一个基本的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默认的请求后缀名。关于更多的配置的含义,后面用到了再讲解,现在暂时不必理会这些配置的含义. 

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



更改默认设置: 

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


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

 
[html] view plain copy
 
  1. ##激活重新载入国际化文件的功能   
  2. struts.i18n.reload=true   
  3. ##修改请求后缀为action或者do   
  4. struts.action.extension=action,do   
  5. ##打开开发者模式,打开之后,我们修改配置文件之后不用重新启动服务器   
  6. 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的配置。如前面登录例子中的配置: 

[html] view plain copy
 
  1. <?xml version="1.0" encoding="UTF-8"?>   
  2. <!DOCTYPE struts PUBLIC   
  3. "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"   
  4. "http://struts.apache.org/dtds/struts-2.0.dtd" >   
  5. <struts>   
  6. <!-- 配置常量,覆盖default.properties中的配置 -->   
  7. <constant name="struts.action.extension" value="do" />  
  8. <!-- struts2的Action必须放在指定的包空间下 -->   
  9. <package name="com.wq" extends="struts-default">   
  10. <!-- 定义action -->   
  11. <action name="login" class="com.wq.web.action.LoginAction">   
  12. <!-- 定义处理结果和资源之间的映射关系 -->   
  13. <result name="success">/welcome.jsp</result>   
  14. <result name="error">/error.jsp</result>   
  15. </action>   
  16. </package>  
  17. </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> 元素定义逻辑视图和物理视图之间的一次映射,如下面的配置: 

[html] view plain copy
 
  1. <struts>   
  2. <constant name="struts.action.extension" value="do"></constant>   
  3. <package name="com.wq" extends="struts-default">   
  4. <action name="login" class="com.wq.web.action.LoginAction">   
  5. <result name="success">/welcome.jsp</result>   
  6. <result name="error">/error.jsp</result>   
  7. </action>   
  8. </package>   
  9. </struts>  


 


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

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

[html] view plain copy
 
  1. <action name="login" class="com.wq.web.action.LoginAction">   
  2. <result >/welcome.jsp</result>   
  3. <result name="error">/error.jsp</result>   
  4. </action>   
  5. </package>   
  6. </struts>  


 

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

[html] view plain copy
 
  1. <?xml version="1.0"?>  
  2. <!DOCTYPE struts PUBLIC  
  3.     "-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN"  
  4.     "http://struts.apache.org/dtds/struts-2.1.7.dtd">  
  5. <struts>  
  6.      <constant name="s" value=""></constant>  
  7.     <!-- 设置开发模式 -->    
  8.     <constant name="struts.devMode" value="true" />  
  9.     <constant name="struts.action.extension" value="action,do" />  
  10.     <!-- 此三行为了解决不换行问题而加上的 -->  
  11.     <constant name="struts.ui.theme" value="simple" />  
  12.     <constant name="struts.ui.templateDir" value="template" />  
  13.     <constant name="struts.ui.templateSuffix" value="ftl" />  
  14.       
  15.       
  16.     <package name="cn.ouuo.action" extends="struts-default" >  
  17.       
  18.          <action name="SearchUser_*" class="searchAction" method="{1}">  
  19.             <result name="listResult">/listResult.jsp</result>  
  20.             <result name="listData">/more.jsp</result>  
  21.               
  22.             <result name="wordPre">/officePre.jsp</result>  
  23.              <result name="manager">/manager.jsp</result>  
  24.             <result name="success">/success.jsp</result>  
  25.         </action>  
  26.             
  27.     </package>  
  28. </struts>  
 


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

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

posted @ 2017-02-20 20:22  欧阳平  阅读(177)  评论(0编辑  收藏  举报