Struts2 的基本应用

1搭建Struts2开发环境

Struts2是在WebWork2基础发展而来的。和struts1一样， Struts2也属于MVC框架。不过有一点大家需要注意的是：尽管Struts2和struts1在名字上的差别不是很大，但Struts2和struts1在代码编写风格上几乎是不一样的。那么既然有了struts1，为何还要推出struts2。主要是因为struts2有以下优点： 
1 > 在软件设计上Struts2没有像struts1那样跟Servlet API和struts API有着紧密的耦合，Struts2的应用可以不依赖于Servlet API和struts API。 Struts2的这种设计属于无侵入式设计，而Struts1却属于侵入式设计。 

 public class OrderListAction extends Action {
     public ActionForward execute(ActionMapping mapping, ActionForm form,
             HttpServletRequest request, HttpServletResponse response)
             throws Exception {
     }
 }

2> Struts2提供了拦截器，利用拦截器可以进行AOP编程，实现如权限拦截等功能。 
3> Strut2提供了类型转换器，我们可以把特殊的请求参数转换成需要的类型。在Struts1中，如果我们要实现同样的功能，就必须向Struts1的底层实现BeanUtil注册类型转换器才行。 
4> Struts2提供支持多种表现层技术，如：JSP、freeMarker、Velocity等 
5> Struts2的输入校验可以对指定方法进行校验，解决了Struts1长久之痛。 
6> 提供了全局范围、包范围和Action范围的国际化资源文件管理实现 


搭建Struts2环境时，我们一般需要做以下几个步骤的工作： 
1》找到开发Struts2应用需要使用到的jar文件. 
2》编写Struts2的配置文件 
3》在web.xml中加入Struts2 MVC框架启动配置 
------ 
struts2-core-2.x.x.jar :Struts 2框架的核心类库 
xwork-core-2.x.x.jar :XWork类库，Struts 2在其上构建 
ognl-2.6.x.jar :对象图导航语言（Object Graph Navigation Language），struts2框架通过其读写对象的属性 
freemarker-2.3.x.jar :Struts 2的UI标签的模板使用FreeMarker编写 
commons-logging-1.x.x.jar :ASF出品的日志包，Struts 2框架使用这个日志包来支持Log4J和JDK 1.4+的日志记录。 
commons-fileupload-1.2.1.jar 文件上传组件，2.1.6版本后必须加入此文件 
------ 
Struts2默认的配置文件为struts.xml ，该文件需要存放在WEB-INF/classes下，该文件的配置模版如下： 

 <?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>
 </struts>

-------- 
在struts1.x中， struts框架是通过Servlet启动的。在struts2中，struts框架是通过Filter启动的。他在web.xml中的配置如下： 

 <filter>
     <filter-name>struts2</filter-name>
     <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
 <!-- 自从Struts 2.1.3以后，下面的FilterDispatcher已经标注为过时
     <filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class> -->
 </filter>
 <filter-mapping>
     <filter-name>struts2</filter-name>
     <url-pattern>/*</url-pattern>
 </filter-mapping>

在StrutsPrepareAndExecuteFilter的init()方法中将会读取类路径下默认的配置文件struts.xml完成初始化操作。 

注意：struts2读取到struts.xml的内容后，以javabean形式存放在内存中，以后struts2对用户的每次请求处理将使用内存中的数据，而不是每次都读取struts.xml文件 
--------- 

试验版本：struts2.3.1 
还需要添加：commons-io-2.0.1.jar、commons-lang-2.5.jar、javassist-3.11.0.GA.jar

2第一个struts2应用

第一个Struts2应用--HelloWorld 

在默认的配置文件struts.xml 中加入如下配置： 

 <?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>
     <package name="partner4java" namespace="/test" extends="struts-default">
         <action name="helloworld" class="com.partner4java.action.HelloWorldAction"
             method="execute">
             <result name="success">/WEB-INF/page/hello.jsp</result>
         </action>
     </package>
 </struts>

Struts.xml配置中的包介绍

 <package name="partner4java" namespace="/test" extends="struts-default">
     <action name="helloworld" class="com.partner4java.action.HelloWorldAction"
         method="execute">
         <result name="success">/WEB-INF/page/hello.jsp</result>
     </action>
 </package>

在struts2框架中使用包来管理Action，包的作用和java中的类包是非常类似的，它主要用于管理一组业务功能相关的action。在实际应用中，我们应该把一组业务功能相关的Action放在同一个包下。 

配置包时必须指定name属性，该name属性值可以任意取名，但必须唯一，他不对应java的类包，如果其他包要继承该包，必须通过该属性进行引用。包的namespace属性用于定义该包的命名空间，命名空间作为访问该包下Action的路径的一部分，如访问上面例子的Action，访问路径为：/test/helloworld.action。 namespace属性可以不配置，对本例而言，如果不指定该属性，默认的命名空间为“”（空字符串）。 

通常每个包都应该继承struts-default包， 因为Struts2很多核心的功能都是拦截器来实现。如：从请求中把请求参数封装到action、文件上传和数据验证等等都是通过拦截器实现的。 struts-default定义了这些拦截器和Result类型。可以这么说：当包继承了struts-default才能使用struts2提供的核心功能。 struts-default包是在struts2-core-2.x.x.jar文件中的struts-default.xml中定义。 struts-default.xml也是Struts2默认配置文件。 Struts2每次都会自动加载 struts-default.xml文件。 

包还可以通过abstract=“true”定义为抽象包，抽象包中不能包含action。 


第一个Struts2应用--HellWorld: 
action:

 package com.partner4java.action;

 public class HelloWorldAction {
     private String message;
     public String getMessage() {
         return message;
     }
     public void setMessage(String message) {
         this.message = message;
     }

     public String execute(){
         message = "hello world";

         return "success";
     }
 }

jsp:

 <%@ page language="java" import="java.util.*" pageEncoding="GBK"%>
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <html>
   <head>
   </head>

   <body>
   ${message }
   </body>
 </html>

可以使用EL表达式访问Action中的属性。 


访问HelloWorld应用: 
在struts1中，通过<action path=“/test/helloworld”>节点的path属性指定访问该action的URL路径。在struts2中，情况就不是这样了，访问struts2中action的URL路径由两部份组成：包的命名空间+action的名称，例如访问本例子HelloWorldAction的URL路径为：/test/helloworld (注意：完整路径为：http://localhost:端口/内容路径/test/helloworld)。另外我们也可以加上.action后缀访问此Action。 
如：http://localhost:8080/2/test/helloworld 

4Struts2 Action名称的搜索顺序

Action名称的搜索顺序: 
1．获得请求路径的URI，例如url是：http://server/struts2/path1/path2/path3/test.action 

2．首先寻找namespace为/path1/path2/path3的package，如果不存在这个package则执行步骤3；如果存在这个package，则在这个package中寻找名字为test的action，当在该package下寻找不到action 时就会直接跑到默认namaspace的package里面去寻找action（默认的命名空间为空字符串“” ） ，如果在默认namaspace的package里面还寻找不到该action，页面提示找不到action 

3．寻找namespace为/path1/path2的package，如果不存在这个package，则转至步骤4；如果存在这个package，则在这个package中寻找名字为test的action，当在该package中寻找不到action 时就会直接跑到默认namaspace的package里面去找名字为test的action ，在默认namaspace的package里面还寻找不到该action，页面提示找不到action 

4．寻找namespace为/path1的package，如果不存在这个package则执行步骤5；如果存在这个package，则在这个package中寻找名字为test的action，当在该package中寻找不到action 时就会直接跑到默认namaspace的package里面去找名字为test的action ，在默认namaspace的package里面还寻找不到该action，页面提示找不到action 

5．寻找namespace为/的package，如果存在这个package，则在这个package中寻找名字为test的action，当在package中寻找不到action或者不存在这个package时，都会去默认namaspace的package里面寻找action，如果还是找不到，页面提示找不到action。 

5Struts2 Action配置的各项默认值

<package name="itcast" namespace="/test" extends="struts-default"> 
<action name="helloworld" class="cn.itcast.action.HelloWorldAction" method="execute" > 
<result name="success">/WEB-INF/page/hello.jsp</result> 
</action> 
</package> 
1>如果没有为action指定class，默认是ActionSupport。 
2>如果没有为action指定method，默认执行action中的execute() 方法。 
3>如果没有指定result的name属性，默认值为success。 

6Struts2 result配置的各种视图转发类型

Action中result的各种转发类型： 
<action name="helloworld" class="com.partner4java.action.HelloWorldAction"> 
<result name="success">/WEB-INF/page/hello.jsp</result> 
</action> 
result配置类似于struts1中的forward，但struts2中提供了多种结果类型，常用的类型有： dispatcher(默认值，内部转发)、 redirect(重定向) 、 redirectAction（重定向到一个action的名称中）、 plainText（显示jsp源码）。 

在result中还可以使用${属性名}表达式访问action中的属性，表达式里的属性名对应action中的属性。如下（jsp放到了WEB-INF外面）： 
<result type="redirect">/view.jsp?id=${id}</result> 

下面是redirectAction 结果类型的例子，如果重定向的action中同一个包下： 
<result type="redirectAction">helloworld</result> 
如果重定向的action在别的命名空间下： 
<result type="redirectAction"> 
<param name="actionName">helloworld</param> 
<param name="namespace">/test</param> 
</result> 
plaintext:显示原始文件内容，例如：当我们需要原样显示jsp文件源代码 的时候，我们可以使用此类型。 
<result name="source" type="plainText "> 
<param name="location">/xxx.jsp</param> 
<param name="charSet">UTF-8</param><!-- 指定读取文件的编码 --> 
</result> 

7Struts2 全局result配置

当多个action中都使用到了相同视图，这时我们应该把result定义为全局视图。struts1中提供了全局forward，struts2中也提供了相似功能： 
<package ....> 
<global-results> 
<result name="message">/message.jsp</result> 
</global-results> 
</package> 

8Struts2 为Action的属性注入值

Struts2为Action中的属性提供了依赖注入功能，在struts2的配置文件中，我们可以很方便地为Action中的属性注入值。注意：属性必须提供setter方法。 

 public class HelloWorldAction{
     private String savePath;

     public String getSavePath() {
         return savePath;
     }
     public void setSavePath(String savePath) {
         this.savePath = savePath;
     }
        ......
 }

 <package name="itcast" namespace="/test" extends="struts-default">
     <action name="helloworld" class="com.partner4java.action.HelloWorldAction" >
         <param name="savePath">/images</param>
         <result name="success">/WEB-INF/page/hello.jsp</result>
     </action>
 </package>

上面通过<param>节点为action的savePath属性注入“/images” 

9Struts2 指定Struts 2处理的请求后缀、常量定义、常用常量

指定需要Struts 2处理的请求后缀： 
前面我们都是默认使用.action后缀访问Action。其实默认后缀是可以通过常量”struts.action.extension“进行修改的，例如：我们可以配置Struts 2只处理以.do为后缀的请求路径： 

<?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> 
<constant name="struts.action.extension" value="do"/> 
</struts> 

如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号（,）隔开。如： 
<constant name="struts.action.extension" value="do,go"/> 




细说常量定义： 
常量可以在struts.xml或struts.properties中配置，建议在struts.xml中配置，两种配置方式如下： 
在struts.xml文件中配置常量 
<struts> 
<constant name="struts.action.extension" value="do"/> 
</struts> 

在struts.properties中配置常量 
struts.action.extension=do 

因为常量可以在下面多个配置文件中进行定义，所以我们需要了解struts2加载常量的搜索顺序: 
struts-default.xml 
struts-plugin.xml 
struts.xml 
struts.properties 
web.xml 
如果在多个文件中配置了同一个常量，则后一个文件中配置的常量值会覆盖前面文件中配置的常量值. 


常用的常量介绍： 
<!-- 指定默认编码集,作用于HttpServletRequest的setCharacterEncoding方法 和freemarker 、velocity的输出 --> 
<constant name="struts.i18n.encoding" value="UTF-8"/> 
<!-- 该属性指定需要Struts 2处理的请求后缀，该属性的默认值是action，即所有匹配*.action的请求都由Struts2处理。 
如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号（,）隔开。 --> 
<constant name="struts.action.extension" value="do"/> 
<!-- 设置浏览器是否缓存静态内容,默认值为true(生产环境下使用),开发阶段最好关闭 --> 
<constant name="struts.serve.static.browserCache" value="false"/> 
<!-- 当struts的配置文件修改后,系统是否自动重新加载该文件,默认值为false(生产环境下使用),开发阶段最好打开 --> 
<constant name="struts.configuration.xml.reload" value="true"/> 
<!-- 开发模式下使用,这样可以打印出更详细的错误信息 --> 
<constant name="struts.devMode" value="true" /> 
<!-- 默认的视图主题 --> 
<constant name="struts.ui.theme" value="simple" /> 
<!– 与spring集成时，指定由spring负责action对象的创建 --> 
<constant name="struts.objectFactory" value="spring" /> 
<!–该属性设置Struts 2是否支持动态方法调用，该属性的默认值是true。如果需要关闭动态方法调用，则可设置该属性为false。 --> 
<constant name="struts.enable.DynamicMethodInvocation" value="false"/> 
<!--上传文件的大小限制--> 
<constant name="struts.multipart.maxSize" value=“10701096"/> 

10Struts2 的处理流程与Action的管理方式

StrutsPrepareAndExecuteFilter是Struts 2框架的核心控制器，它负责拦截由<url-pattern>/*</url-pattern>指定的所有用户请求，当用户请求到达时，该Filter会过滤用户的请求。默认情况下，如果用户请求的路径不带后缀或者后缀以.action结尾，这时请求将被转入Struts 2框架处理，否则Struts 2框架将略过该请求的处理。当请求转入Struts 2框架处理时会先经过一系列的拦截器，然后再到Action。与Struts1不同，Struts2对用户的每一次请求都会创建一个Action，所以Struts2中的Action是线程安全的。

11Struts2 为应用指定多个struts配置文件

在大部分应用里，随着应用规模的增加，系统中Action的数量也会大量增加，导致struts.xml配置文件变得非常臃肿。为了避免struts.xml文件过于庞大、臃肿，提高struts.xml文件的可读性，我们可以将一个struts.xml配置文件分解成多个配置文件，然后在struts.xml文件中包含其他配置文件。下面的struts.xml通过<include>元素指定多个配置文件： 

 <?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>
     <include file="struts-user.xml"/>
     <include file="struts-order.xml"/>
 </struts>

通过这种方式，我们就可以将Struts 2的Action按模块添加在多个配置文件中。 

12Struts2 动态方法调用和使用通配符定义action

动态方法调用： 
如果Action中存在多个方法时，我们可以使用!+方法名调用指定方法。如下： 

 public class HelloWorldAction{
     private String message;
     ....
     public String execute() throws Exception{
         this.message = "我的第一个struts2应用";
         return "success";
     }

     public String other() throws Exception{
         this.message = "第二个方法";
         return "success";
     }
 }

假设访问上面action的URL路径为： /struts/test/helloworld.action 
要访问action的other() 方法，我们可以这样调用： 
/struts/test/helloworld!other.action 
如果不想使用动态方法调用，我们可以通过常量struts.enable.DynamicMethodInvocation关闭动态方法调用。 
<constant name="struts.enable.DynamicMethodInvocation" value="false"/> 



使用通配符定义action：  

 <package name="itcast" namespace="/test" extends="struts-default">
     <action name="helloworld_*" class="com.partner4java.action.HelloWorldAction" method="{1}">
         <result name="success">/WEB-INF/page/hello.jsp</result>
     </action>
 </package>
 public class HelloWorldAction{
     private String message;
     ....
     public String execute() throws Exception{
         this.message = "我的第一个struts2应用";
         return "success";
     }

     public String other() throws Exception{
         this.message = "第二个方法";
         return "success";
     }
 }

要访问other()方法，可以通过这样的URL访问：/test/helloworld_other.action 

13Struts2 请求参数接收与采用复合类型接收请求参数及解决中文参数乱码问题

接收请求参数： 
采用基本类型接收请求参数(get/post) 
在Action类中定义与请求参数同名的属性，struts2便能自动接收请求参数并赋予给同名属性。 
请求路径： http://localhost:8080/test/view.action?id=78 

 public class ProductAction {
       private Integer id;
       public void setId(Integer id) {//struts2通过反射技术调用与请求参数同名的属性的setter方法来获取请求参数值
              this.id = id;
       }
       public Integer getId() {return id;}
   }

采用复合类型接收请求参数  
请求路径：  http://localhost:8080/test/view.action?product.id=78  

 public class ProductAction {
    private Product product;
    public void setProduct(Product product) {  this.product = product;  }
    public Product getProduct() {return product;}
 }

Struts2首先通过反射技术调用Product的默认构造器创建product对象,然后再通过反射技术调用product中与请求参数同名的属性的setter方法来获取请求参数值。 

而且，在Struts2中，使用Date这种类型，他可以直接获得，而无需我们再单独设置一个类型转换器。 


关于struts2.1.6接收中文请求参数乱码问题：  
struts2.1.6版本中存在一个Bug，即接收到的中文请求参数为乱码(以post方式提交)，原因是struts2.1.6在获取并使用了请求参数后才调用HttpServletRequest的setCharacterEncoding()方法进行编码设置 ，导致应用使用的就是乱码请求参数。这个bug在struts2.1.8中已经被解决，如果你使用的是struts2.1.6，要解决这个问题，你可以这样做：新建一个Filter，把这个Filter放置在Struts2的Filter之前，然后在doFilter()方法里添加以下代码 

 public void doFilter(...){
     HttpServletRequest req = (HttpServletRequest) request;
     req.setCharacterEncoding("UTF-8");//应根据你使用的编码替换UTF-8
     filterchain.doFilter(request, response);
 }

14Struts2 自定义类型转换器

java.util.Date类型的属性可以接收格式为2009-07-20的请求参数值。但如果我们需要接收格式为20091221的请求参数，我们必须定义类型转换器，否则struts2无法自动完成类型转换。 

 import java.util.Date;
 public class HelloWorldAction {
     private Date createtime;

     public Date getCreatetime() {
         return createtime;
     }

     public void setCreatetime(Date createtime) {
         this.createtime = createtime;
     }
 }

 public class DateConverter extends DefaultTypeConverter {
                 @Override  public Object convertValue(Map context, Object value, Class toType) {
     SimpleDateFormat dateFormat = new SimpleDateFormat("yyyyMMdd");
     try {
         if(toType == Date.class){//当字符串向Date类型转换时
             String[] params = (String[]) value;// Request.getParameterValues()
             return dateFormat.parse(params[0]);
         }else if(toType == String.class){//当Date转换成字符串时
             Date date = (Date) value;
             return dateFormat.format(date);
         }
     } catch (ParseException e) {}
     return null;
     }
 }

将上面的类型转换器注册为局部类型转换器： 
在Action类所在的包下放置ActionClassName-conversion.properties文件，ActionClassName是Action的类名，后面的-conversion.properties是固定写法，对于本例而言，文件的名称应为HelloWorldAction-conversion.properties 。在properties文件中的内容为： 
属性名称=类型转换器的全类名 
对于本例而言， HelloWorldAction-conversion.properties文件中的内容为： 
createtime= com.partner4java.conversion.DateConverter 



自定义全局类型转换器： 
将上面的类型转换器注册为全局类型转换器： 
在WEB-INF/classes下放置xwork-conversion.properties文件 。在properties文件中的内容为： 
待转换的类型=类型转换器的全类名 
对于本例而言， xwork-conversion.properties文件中的内容为： 
java.util.Date= com.partner4java.conversion.DateConverter 

16Struts2 访问或添加request/session/application属性

访问或添加request/session/application属性： 

 public String scope() throws Exception{
    ActionContext ctx = ActionContext.getContext();
    ctx.getApplication().put("app", "应用范围");//往ServletContext里放入app
    ctx.getSession().put("ses", "session范围");//往session里放入ses
    ctx.put("req", "request范围");//往request里放入req
    return "scope";
 }

JSP:

 <body>
    ${applicationScope.app} <br>
    ${sessionScope.ses}<br>
    ${requestScope.req}<br>
 </body>

获取HttpServletRequest / HttpSession / ServletContext / HttpServletResponse对象： 
方法一，通过ServletActionContext.类直接获取：  

 public String rsa() throws Exception{
     HttpServletRequest request = ServletActionContext.getRequest();
     ServletContext servletContext = ServletActionContext.getServletContext();
     request.getSession()
     HttpServletResponse response = ServletActionContext.getResponse();
     return "scope";
 }

方法二，实现指定接口，由struts框架运行时注入：  

 public class HelloWorldAction implements ServletRequestAware, ServletResponseAware, ServletContextAware{
     private HttpServletRequest request;
     private ServletContext servletContext;
     private HttpServletResponse response;
     public void setServletRequest(HttpServletRequest req) {
         this.request=req;
     }
     public void setServletResponse(HttpServletResponse res) {
         this.response=res;
     }
     public void setServletContext(ServletContext ser) {
         this.servletContext=ser;
     }
 }

17Struts2 文件上传

文件上传： 
第一步：在WEB-INF/lib下加入commons-fileupload-1.2.1.jar、commons-io-1.3.2.jar。这两个文件可以从http://commons.apache.org/下载。 
第二步：把form表的enctype设置为：“multipart/form-data“，如下： 
<form enctype="multipart/form-data" action="${pageContext.request.contextPath}/xxx.action" method="post"> 
<input type="file" name="uploadImage"> 
</form> 
第三步：在Action类中添加以下属性： 

 public class HelloWorldAction{
   private File uploadImage;//得到上传的文件
   private String uploadImageContentType;//得到文件的类型
   private String uploadImageFileName;//得到文件的名称
   public String upload() throws Exception{
     String realpath = ServletActionContext.getServletContext().getRealPath("/images");
     File file = new File(realpath);
     if(!file.exists()) file.mkdirs();
     FileUtils.copyFile(uploadImage, new File(file, uploadImageFileName));
     return "success";
   }
 ...
 }

多文件上传:  
第一步：在WEB-INF/lib下加入commons-fileupload-1.2.1.jar、commons-io-1.3.2.jar。这两个文件可以从http://commons.apache.org/下载。 
第二步：把form表的enctype设置为：“multipart/form-data“，如下： 
<form enctype="multipart/form-data" action="${pageContext.request.contextPath}/xxx.action" method="post"> 
<input type="file" name="uploadImages"> 
<input type="file" name="uploadImages"> 
</form> 
第三步：在Action类中添加以下属性： 

 public class HelloWorldAction{
   private File[] uploadImages;//得到上传的文件
   private String[] uploadImagesContentType;//得到文件的类型
   private String[] uploadImagesFileName;//得到文件的名称
   public String upload() throws Exception{
     String realpath = ServletActionContext.getServletContext().getRealPath("/images");
     File file = new File(realpath);
     if(!file.exists()) file.mkdirs();
     for(int i=0 ;i<uploadImages.length; i++){ File uploadImage = uploadImages[i];
     FileUtils.copyFile(uploadImage, new File(file, uploadImagesFileName[i]));
 }
     return "success";
   }
 ...
 }

demo: 

 <?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>
     <!-- 指定默认编码集,作用于HttpServletRequest的setCharacterEncoding方法 和freemarker 、velocity的输出 -->
     <constant name="struts.i18n.encoding" value="GBK" />
     <!-- 该属性指定需要Struts 2处理的请求后缀，该属性的默认值是action，即所有匹配*.action的请求都由Struts2处理。
         如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号（,）隔开。 -->
     <constant name="struts.action.extension" value="do" />
     <!-- 设置浏览器是否缓存静态内容,默认值为true(生产环境下使用),开发阶段最好关闭 -->
     <constant name="struts.serve.static.browserCache" value="false" />
     <!-- 当struts的配置文件修改后,系统是否自动重新加载该文件,默认值为false(生产环境下使用),开发阶段最好打开 -->
     <constant name="struts.configuration.xml.reload" value="true" />
     <!-- 开发模式下使用,这样可以打印出更详细的错误信息 -->
     <constant name="struts.devMode" value="true" />
     <!-- 该属性设置Struts 2是否支持动态方法调用，该属性的默认值是true。如果需要关闭动态方法调用，则可设置该属性为false。 -->
     <constant name="struts.enable.DynamicMethodInvocation" value="false" />
     <!--上传文件的大小限制 -->
     <constant name="struts.multipart.maxSize" value="1000000000" />

     <package name="partner4java" namespace="/test" extends="struts-default">
         <action name="uploadview">
             <result name="success">/WEB-INF/page/upload.jsp</result>
         </action>
         <action name="upload_*" class="com.partner4java.web.action.UploadFileTestAction" method="{1}">
             <result name="view">/WEB-INF/page/viewUpload.jsp</result>
         </action>
     </package>

 </struts>
 ---------------
 package com.partner4java.web.formbean;

 import java.io.File;
 import java.io.Serializable;



 public class UploadTest implements Serializable {
     private String fileName;
     /** 上传文件 */
     private File uploadFile;
     /** 文件类型 */
     private String uploadFileContentType;
     /** 文件名称 */
     private String uploadFileFileName;
     public String getFileName() {
         return fileName;
     }
     public void setFileName(String fileName) {
         this.fileName = fileName;
     }
     public File getUploadFile() {
         return uploadFile;
     }
     public void setUploadFile(File uploadFile) {
         this.uploadFile = uploadFile;
     }
     public String getUploadFileContentType() {
         return uploadFileContentType;
     }
     public void setUploadFileContentType(String uploadFileContentType) {
         this.uploadFileContentType = uploadFileContentType;
     }
     public String getUploadFileFileName() {
         return uploadFileFileName;
     }
     public void setUploadFileFileName(String uploadFileFileName) {
         this.uploadFileFileName = uploadFileFileName;
     }
     @Override
     public int hashCode() {
         final int prime = 31;
         int result = 1;
         result = prime * result
                 + ((fileName == null) ? 0 : fileName.hashCode());
         return result;
     }
     @Override
     public boolean equals(Object obj) {
         if (this == obj)
             return true;
         if (obj == null)
             return false;
         if (getClass() != obj.getClass())
             return false;
         UploadTest other = (UploadTest) obj;
         if (fileName == null) {
             if (other.fileName != null)
                 return false;
         } else if (!fileName.equals(other.fileName))
             return false;
         return true;
     }
     @Override
     public String toString() {
         return "UploadTest [fileName=" + fileName + ", uploadFileContentType="
                 + uploadFileContentType + ", uploadFileFileName="
                 + uploadFileFileName + "]";
     }


 }
 -----------
 package com.partner4java.web.action;

 import java.io.File;
 import java.io.IOException;

 import org.apache.commons.io.FileUtils;
 import org.apache.struts2.ServletActionContext;

 import com.partner4java.web.formbean.UploadTest;

 public class UploadFileTestAction {
     private UploadTest uploadTest;

     public UploadTest getUploadTest() {
         return uploadTest;
     }

     public void setUploadTest(UploadTest uploadTest) {
         this.uploadTest = uploadTest;
     }

     public String upload() throws IOException{
         String realPath = ServletActionContext.getServletContext().getRealPath("/uploadfile");
         File file = new File(realPath);
         if(!file.exists()){
             file.mkdirs();
         }
         FileUtils.copyFile(uploadTest.getUploadFile(), new File(file,uploadTest.getUploadFileFileName()));

         return "view";
     }
 }
 ---------------
 <%@ page language="java" import="java.util.*" pageEncoding="GBK"%>
 <%
 String path = request.getContextPath();
 String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/";
 %>

 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <html>
   <head>
     <base href="<%=basePath%>">

     <title>My JSP 'upload.jsp' starting page</title>

   </head>

   <body>
     <form action="<%=basePath %>test/upload_upload.do" method="post" enctype="multipart/form-data">
         内容简介：<input type="text" name="uploadTest.fileName"/>
         上传文件：<input type="file" name="uploadTest.uploadFile"/>

         <input type="submit" value="上传"/>
     </form>

   </body>
 </html>
 -----------------
 <%@ page language="java" import="java.util.*" pageEncoding="GBK"%>

 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <html>
   <head>

     <title>My JSP 'viewUpload.jsp' starting page</title>

   </head>

   <body>
     fileName:${uploadTest.fileName }<br/>
     uploadFileContentType:${uploadTest.uploadFileContentType }<br/>
     uploadFileFileName:${uploadTest.uploadFileFileName }<br/>
   </body>
 </html>

但是，你如果现实情况下，如果上传很大的文件，肯定会被服务器断开，因为http并不是一个长连接。 
如果非要上传大文件，也只能开发一个插件。

18Struts2 自定义拦截器

要自定义拦截器需要实现com.opensymphony.xwork2.interceptor.Interceptor接口：

 public class PermissionInterceptor implements Interceptor {
    private static final long serialVersionUID = -5178310397732210602L;
    public void destroy() {
    }
    public void init() {
    }
    public String intercept(ActionInvocation invocation) throws Exception {
     System.out.println("进入拦截器");
     if(session里存在用户){
         String result = invocation.invoke();
     }else{
         return “logon”;
     }
     //System.out.println("返回值:"+ result);
     //return result;
     }
 }

 <package name="partner4java" namespace="/test" extends="struts-default">
     <interceptors>
              <interceptor name=“permission" class="com.partner4java.aop.PermissionInterceptor" />
              <interceptor-stack name="permissionStack">
             <interceptor-ref name="defaultStack" />
             <interceptor-ref name=" permission " />
               </interceptor-stack>
     </interceptors>
     <action name="helloworld_*" class="com.partner4java.action.HelloWorldAction" method="{1}">
         <result name="success">/WEB-INF/page/hello.jsp</result>
         <interceptor-ref name="permissionStack"/>
     </action>
 </package>

因为struts2中如文件上传，数据验证，封装请求参数到action等功能都是由系统默认的defaultStack中的拦截器实现的，所以我们定义的拦截器需要引用系统默认的defaultStack，这样应用才可以使用struts2框架提供的众多功能。 
如果希望包下的所有action都使用自定义的拦截器，可以通过<default-interceptor-ref name=“permissionStack”/>把拦截器定义为默认拦截器。注意：每个包只能指定一个默认拦截器。另外，一旦我们为该包中的某个action显式指定了某个拦截器，则默认拦截器不会起作用。 

19Struts2 校验

输入校验： 
在struts2中，我们可以实现对action的所有方法进行校验或者对action的指定方法进行校验。 

对于输入校验struts2提供了两种实现方法: 
1. 采用手工编写代码实现。 
2. 基于XML配置方式实现。 

手工编写代码实现对action中所有方法输入校验： 
通过重写validate() 方法实现， validate()方法会校验action中所有与execute方法签名相同的方法。当某个数据校验失败时，我们应该调用addFieldError()方法往系统的fieldErrors添加校验失败信息（为了使用addFieldError()方法，action可以继承ActionSupport ），如果系统的fieldErrors包含失败信息，struts2会将请求转发到名为input的result。在input视图中可以通过<s:fielderror/>显示失败信息。 
validate()使用例子： 

 public void validate() {
        if(this.mobile==null || "".equals(this.mobile.trim())){  this.addFieldError("username", "手机号不能为空");
         }else{  if(!Pattern.compile("^1[358]\\d{9}").matcher(this.mobile.trim()).matches()){
         this.addFieldError(“mobile", "手机号的格式不正确"); }
        }
 }

验证失败后，请求转发至input视图： 
<result name="input">/WEB-INF/page/addUser.jsp</result> 

在addUser.jsp页面中使用<s:fielderror/>显示失败信息。 


手工编写代码实现对action指定方法输入校验：  
通过validateXxx()方法实现， validateXxx()只会校验action中方法名为Xxx的方法。其中Xxx的第一个字母要大写。当某个数据校验失败时，我们应该调用addFieldError()方法往系统的fieldErrors添加校验失败信息（为了使用addFieldError()方法，action可以继承ActionSupport ），如果系统的fieldErrors包含失败信息，struts2会将请求转发到名为input的result。在input视图中可以通过<s:fielderror/>显示失败信息。 

validateXxx()方法使用例子： 

 public String add() throws Exception{  return "success";}
 public void validateAdd(){
           if(username==null && "".equals(username.trim()))  this.addFieldError("username", "用户名不能为空");
 }

验证失败后，请求转发至input视图： 
<result name="input">/WEB-INF/page/addUser.jsp</result> 

在addUser.jsp页面中使用<s:fielderror/>显示失败信息。 



输入校验的流程：  
1。类型转换器对请求参数执行类型转换，并把转换后的值赋给action中的属性。 

2。如果在执行类型转换的过程中出现异常，系统会将异常信息保存到ActionContext，conversionError拦截器将异常信息添加到fieldErrors里。不管类型转换是否出现异常，都会进入第3步。 

3。系统通过反射技术先调用action中的validateXxx()方法，Xxx为方法名。 

4。再调用action中的validate()方法。 

5。经过上面4步，如果系统中的fieldErrors存在错误信息（即存放错误信息的集合的size大于0)，系统自动将请求转发至名称为input的视图。如果系统中的fieldErrors没有任何错误信息，系统将执行action中的处理方法。 



基于XML配置方式实现对action的所有方法进行输入校验：  
使用基于XML配置方式实现输入校验时，Action也需要继承ActionSupport，并且提供校验文件，校验文件和action类放在同一个包下，文件的取名格式为：ActionClassName-validation.xml，其中ActionClassName为action的简单类名，-validation为固定写法。如果Action类为com.partner4java.UserAction，那么该文件的取名应为：UserAction-validation.xml。下面是校验文件的模版： 

 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0.3//EN" "http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd">
 <validators>
     <field name="username">
         <field-validator type="requiredstring">
             <param name="trim">true</param>
             <message>用户名不能为空!</message>
         </field-validator>
     </field>
 </validators>

<field>指定action中要校验的属性，<field-validator>指定校验器，上面指定的校验器requiredstring是由系统提供的，系统提供了能满足大部分验证需求的校验器，这些校验器的定义可以在xwork-2.x.jar中的com.opensymphony.xwork2.validator.validators下的default.xml中找到。 
<message>为校验失败后的提示信息,如果需要国际化，可以为message指定key属性，key的值为资源文件中的key。 
在这个校验文件中，对action中字符串类型的username属性进行验证，首先要求调用trim()方法去掉空格，然后判断用户名是否为空。 


编写校验文件时，不能出现帮助信息：  
在编写ActionClassName-validation.xml校验文件时,如果出现不了帮助信息,可以按下面方式解决： 
windwos->preferences->myeclipse->files and editors->xml->xmlcatalog 
点“add”,在出现的窗口中的location中选“File system”,然后在xwork-2.1.2解压目录的src\java目录中选择xwork-validator-1.0.3.dtd,回到设置窗口的时候不要急着关闭窗口,应把窗口中的Key Type改为URI 。Key改为http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd 


struts2提供的校验器列表：  
系统提供的校验器如下： 
required (必填校验器,要求field的值不能为null) 
requiredstring (必填字符串校验器,要求field的值不能为null,并且长度大于0,默认情况下会对字符串去前后空格) 
stringlength(字符串长度校验器,要求field的值必须在指定的范围内,否则校验失败,minLength参数指定最小长度,maxLength参数指定最大长度,trim参数指定校验field之前是否去除字符串前后的空格) 
regex(正则表达式校验器,检查被校验的field是否匹配一个正则表达式.expression参数指定正则表达式,caseSensitive参数指定进行正则表达式匹配时,是否区分大小写,默认值为true) 
int(整数校验器,要求field的整数值必须在指定范围内,min指定最小值,max指定最大值) 
double(双精度浮点数校验器,要求field的双精度浮点数必须在指定范围内,min指定最小值,max指定最大值) 
fieldexpression(字段OGNL表达式校验器,要求field满足一个ognl表达式,expression参数指定ognl表达式,该逻辑表达式基于ValueStack进行求值,返回true时校验通过,否则不通过) 
email(邮件地址校验器,要求如果field的值非空,则必须是合法的邮件地址) 
url(网址校验器,要求如果field的值非空,则必须是合法的url地址) 
date(日期校验器,要求field的日期值必须在指定范围内,min指定最小值,max指定最大值) 
conversion(转换校验器,指定在类型转换失败时,提示的错误信息) 
visitor(用于校验action中的复合属性,它指定一个校验文件用于校验复合属性中的属性) 
expression(OGNL表达式校验器,expression参数指定ognl表达式,该逻辑表达式基于ValueStack进行求值,返回true时校验通过,否则不通过,该校验器不可用在字段校验器风格的配置中) 


校验器的使用例子：  

 required  必填校验器