Struts2的相关配置文件

    * default.properties        -- 在org/apache/struts2/目录下，代表的是配置的是Struts2的常量的值

    * struts-default.xml        -- 在Struts2的核心包下，代表的是Struts2核心功能的配置（Bean、拦截器、结果类型等）

    * struts-plugin.xml         -- 配置插件的信息

    * struts.xml                -- 重点中的重点配置，代表WEB应用的默认配置，可以配置常量，基本就配置它就可以

    * struts.properties         -- 该文件是Struts的默认配置文件  (可以配置常量 )

    * web.xml                   -- 配置前端控制器（可以配置常量）

注意：后加载的配置文件会覆盖掉之前加载的配置文件（在这些配置文件中可以配置常量）

Struts2核心配置文件Struts2.xml的配置入门

  <package>标签

如果要配置<Action>的标签，那么必须要先配置<package>标签，代表的包的概念。

包含的属性

name         包的名称，要求是唯一的，管理action配置。

extends      继承，可以继承其他的包，只要继承了，那么该包就包含了其他包的功能，一般都是继承struts-default

namespace  名称空间，一般与<action>标签中的name属性共同决定访问路径，常见的配置如下：

                * namespace=""      -- 默认的名称空间（访问的方式和namespace="/"是一样的）

                * namespace="/"     -- 根名称空间

                * namespace="/aaa"  -- 带有名称的名称空间

                * abstract          -- 抽象的。这个属性基本很少使用，值如果是true，那么编写的包是被继承的。     

<action>标签

 代表配置action类，包含的属性

name              和<package>标签的namespace属性一起来决定访问路径的。

class                配置Action类的全路径（默认值是ActionSupport类）

 method          Action类中执行的方法，如果不指定，默认值是execute

<result>标签

action类中方法执行，返回的结果跳转的页面

name      结果页面逻辑视图名称

type        结果类型（默认值是转发，也可以设置其他的值）

默认的Action和Action默认的处理类

 默认的Action

 在地址栏上输入一个不存在的action请求，程序会报404的异常。

 但是在<package>标签中通过<default-action-ref name="指定action标签name属性"></default-action-ref>来该请求。

Action默认处理类

 在地址栏上输入一个正确的action请求，但是<action>标签中的class属性没有写具体的Action类

 在<package>标签中通过<default-class-ref class="指定action类的全路径"></default-class-ref>

Struts2配置常用的常量

可以在Struts2框架中的哪些配置文件中配置常量

struts.xml

 <constant name="key" value="value"></constant>

web.xml

在StrutsPrepareAndExecuteFilter配置文件中配置初始化参数

struts.i18n.encoding=UTF-8            指定默认编码集,作用于HttpServletRequest的setCharacterEncoding方法 

struts.action.extension=action,,       该属性指定需要Struts 2处理的请求后缀，该属性的默认值是action，即所有匹配*.action的请求都由Struts2处理。如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号（,）隔开

 struts.serve.static.browserCache=true     设置浏览器是否缓存静态内容,默认值为true(生产环境下使用),开发阶段最好关闭 

struts.configuration.xml.reload=false     当struts的配置文件修改后,系统是否自动重新加载该文件,默认值为false(生产环境下使用),开发阶段最好打开 

struts.devMode = false                    开发模式下使用,这样可以打印出更详细的错误信息 

struts.enable.DynamicMethodInvocation = true  开启对Action的动态方法访问

指定多个struts的配置文件

在大部分应用里，随着应用规模的增加，系统中Action的数量也会大量增加，导致struts.xml配置文件变得非常臃肿。

为了避免struts.xml文件过于庞大、臃肿，提高struts.xml文件的可读性，我们可以将一个struts.xml配置文件分解成多个配置文件，然后在struts.xml文件中包含其他配置文件。

可以在<package>标签中，使用<include>标签来引入其他的struts_xx.xml的配置文件。例如：

    <struts>
<include file="struts-part1.xml"/>
<include file="struts-part2.xml"/>
    </struts>

实现Action的三种方式

Action类就是一个POJO类

POJO类：

POJO（Plain Ordinary Java Object）简单的Java对象。简单来说，没有继承某个类，没有实现接口，就是POJO的类。

Action类可以实现Action接口

Action接口中定义了5个常量，5个常量的值对应的是5个逻辑视图跳转页面（跳转的页面还是需要自己来配置），还定义了一个方法，execute方法。

大家需要掌握5个逻辑视图的常量

SUCCESS       -- 成功.

INPUT         -- 用于数据表单校验.如果校验失败,跳转INPUT视图.

LOGIN         -- 登录.

ERROR         -- 错误.

NONE          -- 页面不转向.

Action类可以去继承ActionSupport类

对请求参数进行校验

设置错误信息

读取国际化信息

在Action中获取Servlet相关API的三种方式

在Action类中也可以获取到Servlet一些常用的API，有如下三种方式获取

    * 完全解耦合的方式

    * 使用接口注入的方式

    * 使用ServletActionContext中静态方法直接访问Servlet的API

完全解耦合的方式

如果使用该种方式，Struts2框架中提供了一个类，ActionContext类，该类中提供一些方法，通过方法获取Servlet的API

 一些常用的方法如下：

static ActionContext getContext()        获取ActionContext对象实例

java.util.Map<java.lang.String,java.lang.Object> getParameters()      获取请求参数，相当request.getParameterMap();

 java.util.Map<java.lang.String,java.lang.Object> getSession()     获取的代表session域的Map集合，就相当于操sessio域

 java.util.Map<java.lang.String,java.lang.Object> getApplication()    获取代表application域的Map集合

  void put(java.lang.String key, java.lang.Object value)         注意：向request域中存入值。

使用接口注入的方式

Struts2框架中提供了一些接口，编写的Action类可以是去实现这些接口，然后实现这些接口中的方法，这些方法都是把一些Servlet的常用对象通过参数的方式传递进来。

    常用的接口如下：

        * ServletRequestAware       -- 注入request

        * ServletContextAware       -- 注入ServletContext

        * ServletResponseAware      -- 注入response.

使用ServletActionContext中静态方法直接访问Servlet的API

    Struts2框架提供了一个类，ServletActionContext，该类中提供了一些静态的方法

     具体的方法如下

        * getPageContext();

        * getRequest()

        * getResponse();

        * getServletContext();

访问Action的三种方式

通过<action>标签中的method属性，访问到Action中的具体的方法

传统的配置方式

    具体的实例如下：

        页面代码

      <a href="${pageContext.request.contextPath}/addBook.action">添加图书</a>
            <a href="${pageContext.request.contextPath}/deleteBook.action">删除图书</a>

         配置文件的代码

            <package name="demo" extends="struts-default" namespace="/">
                <action name="addBook" class="cn.zlq.demo.BookAction" method="add"></action>
                <action name="deleteBook" class="cn.zlq.demo.BookAction" method="delete"></action>
            </package>

         Action的代码

            public String add(){
                System.out.println("添加图书");
                return NONE;
            }
            public String delete(){
                System.out.println("删除图书");
                return NONE;
            }

通配符的访问方式

使用通配符的方式可以简化配置文件的代码编写，而且扩展和维护比较容易。

具体实例如下：

  页面代码

  <a href="${pageContext.request.contextPath}/order_add.action">添加订单</a>
            <a href="${pageContext.request.contextPath}/order_delete.action">删除订单</a>

 配置文件代码

 <action name="order_*" class="cn.zlq.demo.OrderAction" method="{1}"></action>

  Action的代码

    public String add(){
                System.out.println("添加订单");
                return NONE;
            }
            public String delete(){
                System.out.println("删除订单");
                return NONE;
            }

 通配符更抽象的写法

具体的实例如下：

页面的代码

   <a href="${pageContext.request.contextPath}/OrderAction_add.action">添加订单</a>

配置文件代码

 <action name="*_*" class="cn.zlq.demo.{1}" method="{2}"></action>

 Action的代码

            public class OrderAction extends ActionSupport{
                public String add(){
                    System.out.println("添加订单");
                    return NONE;
                }
            }

动态方法访问的方式 

 如果想完成动态方法访问的方式需要开启一个常量，struts.enable.DynamicMethodInvocation = false，把值设置成true。

 注意：不同的Struts2框架的版本，该常量的值不一定是true或者false，需要自己来看一下。如果是false，需要自己开启。

 在struts.xml中开启该常量。

             

<constant name="struts.enable.DynamicMethodInvocation" value="true"></constant>

具体代码如下

页面的代码

            <a href="${pageContext.request.contextPath}/product!add.action">添加商品</a>
            <a href="${pageContext.request.contextPath}/product!delete.action">删除商品</a>

配置文件代码

   

        <action name="product" class="cn.zlq.demo.ProductAction"></action>

 Action的类的代码

         

  public class ProductAction extends ActionSupport{
                public String add(){
                    System.out.println("添加订单");
                    return NONE;
                }
                public String delete(){
                    System.out.println("删除订单");
                    return NONE;
                }
            }

对结果页面的跳转

结果页面存在两种方式

 全局结果页面

条件：

如果<package>包中的一些action都返回success，并且返回的页面都是同一个JSP页面，这样就可以配置全局的结果页面。

 全局结果页面针对的当前的包中的所有的Action，但是如果局部还有结果页面，会优先局部的。

使用的标签是

            <global-results>
                <result>/demo/suc.jsp</result>
            </global-results>

局部结果页面

        <result>/demo/suc.jsp</result>

结果页面的类型

结果页面使用<result>标签进行配置，包含两个属性

        name  -- 逻辑视图的名称

        type  -- 跳转的类型，值一些，需要掌握一些常用的类型。常见的结果类型去struts-default.xml中查找。

            * dispatcher        -- 转发.type的默认值.Action--->JSP

            * redirect          -- 重定向. Action--->JSP

            * chain             -- 多个action之间跳转.从一个Action转发到另一个Action.  Action---Action

            * redirectAction    -- 多个action之间跳转.从一个Action重定向到另一个Action. Action---Action

            * stream            -- 文件下载时候使用的.

 注意：当使用一个Action标签完成多个Action配置时，会出现Input结果视图冲突的情况，也就是说，在不同逻辑中跳入的input逻辑视图是同一个，此时我们可以在自己的Action方法上加上 @InputConfig(resultName="逻辑视图的名称")的注解然后再在Result中配置即可。

    这个为什么这样呢？大家可以看源码：

Struts2的Action对数据封装的两种方式

属性驱动

提供对应属性的set方法进行数据的封装

    * 表单的哪些属性需要封装数据，那么在对应的Action类中提供该属性的set方法即可。

    * 表单中的数据提交，最终找到Action类中的setXxx的方法，最后赋值给全局变量。

    * 注意：Struts2的框架采用的拦截器完成数据的封装。

    * 注意：这种方式不是特别好:因为属性特别多,提供特别多的set方法,而且还需要手动将数据存入到对象中.

    * 注意：这种情况下，Action类就相当于一个JavaBean，就没有体现出MVC的思想，Action类又封装数据，又接收请求处理，耦合性较高。

在页面上，使用OGNL表达式进行数据封装

    * 在页面中使用OGNL表达式进行数据的封装，就可以直接把属性封装到某一个JavaBean的对象中。

    * 在页面中定义一个JavaBean，并且提供set方法：例如：private User user;

    * 页面中的编写发生了变化，需要使用OGNL的方式，表单中的写法：<input type="text" name="user.username">

    * 注意：只提供一个set方法还不够，如果没有user实例化，必须还需要提供user属性的get和set方法，先调用get方法，判断一下是否有user对象的实例对象，如果没有，调用set方法把拦截器创建的对象注入进来。

模型驱动

使用模型驱动的方式，也可以把表单中的数据直接封装到一个JavaBean的对象中，并且表单的写法和之前的写法没有区别！

编写的页面不需要任何变化，正常编写name属性的值。

模型驱动的编写步骤

    * 手动实例化JavaBean，即：private User user = new User();

    * 必须实现ModelDriven<T>接口，实现getModel()的方法，在getModel()方法中返回user即可！！

Struts2的Action对集合对象的封装的两种方式

封装复杂类型的参数（集合类型 Collection 、Map接口等）

需求：页面中有可能想批量添加一些数据，那么现在就可以使用上述的技术了。把数据封装到集合中。

把数据封装到Collection中

    * 因为Collection接口都会有下标值，所有页面的写法会有一些区别，注意：

 <input type="text" name="products[0].name" />

    * 在Action中的写法，需要提供products的集合，并且提供get和set方法。

把数据封装到Map中

    * Map集合是键值对的形式，页面的写法

<input type="text" name="map['one'].name" />

    * Action中提供map集合，并且提供get和set方法。

在Action中不推荐使用模型驱动的方式来封装数据到集合中。

Struts2对数据的类型转换

Struts2中自带类型转换拦截器

Struts2内部提供了大量转换器，用来完成数据类型转换的问题，有如下

    * boolean 和 Boolean

    * char和 Character

    * int 和 Integer

    * long 和 Long

    * float 和 Float

    * double 和 Double

    * Date 可以接收 yyyy-MM-dd 格式字符串

    * 数组 可以将多个同名参数，转换到数组中

    * 集合 支持将数据保存到 List 或者 Map 集合

当发生类型转换错误的时候，根据报错的信息提示，跳转input类型的结果视图。

    * 说明如果程序出现异常，会跳转到input结果视图，那可以在<action>标签中配置input结果视图

在跳转的页面中可以通过一个固定的标签来显示错误的信息：

* 可以先需要先引入Struts2的标签库，然后使用标签显示错误！

<%@ taglib prefix="s" uri="/struts-tags" %>

* <s:fielderror/>，这是Struts2提供的标签，使用它显示错误的提示信息。

如果类型转换的拦截器中发生了错误，那么会把错误信息放在Struts2错误区域中（Struts2的错误区域分成两部分，一部分是字段错误，一部分是Actionc错误）

* 等执行到最后一个拦截器（workflow）时，workflow拦截器会去Struts2的错误区域中找是否存在错误。

* 如果存在错误，就跳转到input视图。

* 如果不存在错误，执行目标Action类中具体的方法。

自定义类型转换器

如果一些特殊的数据类型不能转换，那么需要自定义数据类型的转换器。

开发自定义类型转换的开发步骤

编写类型转换器

        实现TypeConverter接口，实现一个方法

Object convertValue(Map<String,Object> context,Object target, Member member,String propertyName,Object value,Class toType);

        继承DefaultTypeConverter类，重写一个方法

Object convertValue(Map<String,Object> context,Object value,Class toType)

        继承StrutsTypeConverter类，重写两个方法

  Object convertFromString(Map context,String[] values,Class toClass)

                > 从字符串转换成具体类型

                > values数组，存入的值就是用户输入的值

                > toClass 要转换的数据的类型 Date.class

            * String convertToString(Map context,Object o)

                > 把具体的类型转换成字符串

                > o 代表的要转换的数据

注意：类型转换本身就是一个双向的过程：

* JSP ---> Action   String ---> 某个类型

* Action ---> JSP   某个类型 ---> String                

  * 类型转换的代码，以 1990/10/10 为例，自定义日期转换器，完成转换，下面这段代码是第二种方法，也就是继承了DefaultTypeConverter类。

  public Object convertValue(Map<String, Object> context, Object value,
            Class toType) {
            // 根据toType判断 是请求封装 还是 数据回显
            DateFormat dateFormat = new SimpleDateFormat("yyyy/MM/dd");
            if (toType == Date.class) {
                // 请求参数封装 （value是字符串）
                String[] params = (String[]) value;
                String strVal = params[0]; // 转换为 日期类型
                try {
                    return dateFormat.parse(strVal);
                } catch (ParseException e) {
                    e.printStackTrace();
                }
            } else {
                // 回显(value是 Date)
                Date date = (Date) value;
                return dateFormat.format(date);
            }
            return null;
        }

 注册类型转换器

局部注册：针对某个表单中的某个字段生效的!

            * 属性驱动的方式：使用set方法接收数据

                > 注意：在Action所在的包下创建一个文件，文件的格式是：Action类名-conversion.properties文件，该文件中配置要转换数据的字段和对应的转换器全路径

                    * 例如：birthday=cn.zlq.demo3.MyDateConverter

            * 模型驱动的方式：实现ModelDriven接口的方式

                > 注意：在实体类所在的包下创建一个文件，文件的格式是：实体类名-conversion.properties文件，该文件中配置要转换数据的字段和对应的转换器全路径

                    * 例如：birthday=cn.zlq.demo3.MyDateConverter

全局注册：针对整个项目的所有的日期类型都会生效的!

            * 在src的目录下，创建一个xwork-conversion.properties  （名称是固定的）

                > 例如：java.util.Date=cn.zlq.demo3.MyDateConverter

Struts2对数据的校验的两种方式

数据校验包含两种方式，第一种是手动编码完成数据校验方式，第二种是通过配置文件完成数据校验方式。

手动编码校验方式

开发的步骤

        > 步骤一： 封装数据 

        > 步骤二： 实现校验Action ，必须继承ActionSupport 类 

        > 步骤三： 覆盖validate方法，完成对Action的业务方法 数据校验 this.addFieldError (ActionSupport提供)

        > 步骤四： 在jsp中 通过 <s:fieldError/> 显示错误信息

针对的是Action中所有的方法进行校验

 让Action继承ActionSupport类，重写ActionSupport类中的validate()方法，在该方法中完成数据校验。

 针对的是Action中某个方法完成校验

 手动在Action中编写一个方法，方法名称是validate方法名称()  例如：public void validateAdd(){  }

            * Action中有一个save的方法，只校验save方法。

            * validateSave()    -- 使用该方法去校验save的方法

通过XML配置文件的方式完成数据的校验

 xml配置校验原理 ： 将很多校验规则代码已经写好，只需要在xml中定义数据所使用校验规则就可以了 

开发的步骤

        > 步骤一 ：编写jsp

        > 步骤二 ：编写Action 继承ActionSupport 或者 实现 Validateable 接口 

        > 步骤三 ：封装请求参数

            * 使用xml校验 必须提供get方法

        > 步骤四 ：编写校验规则xml文件 

            * 具体的配置文件相关标签和属性详解

<field name="password">
                    <!-- 校验器类型 -->
                    <field-validator type="requiredstring">
                        <message>密码不能为空</message>
                    </field-validator>
                    <!-- 规定密码的长度 -->
                    <field-validator type="stringlength">
                        <param name="minLength">3</param>
                        <param name="maxLength">8</param>
                        <message>密码在3-8位之间</message>
                    </field-validator>
                </field>

针对的是Action中所有的方法进行校验

        > 在Action所在的包中创建一个XML文件，命名规则：Action类名-validation.xml。并且需要引入指定的DTD的约束：xwork-core-2.3.15.3.jar/xwork-validator-1.0.3.dtd

        > 具体的值：

<!DOCTYPE validators PUBLIC
                "-//Apache Struts//XWork Validator 1.0.3//EN"
                "http://struts.apache.org/dtds/xwork-validator-1.0.3.dtd">

针对的是Action中的某个方法进行校验

 在Action所在的包中创建一个XML文件，命名规则：Action类名-方法对应的访问路径-validation.xml。引入DTD文件等。

            * 例如：Reg6Action-reg6-validation.xml

Struts2框架提供的XML校验规则

    * required (必填校验器,要求被校验的属性值不能为null)，空格没问题。

    * requiredstring (必填字符串校验器,要求被校验的属性值不能为null，并且长度大于0,默认情况下会对字符串去前后空格)

    * stringlength (字符串长度校验器，要求被校验的属性值必须在指定的范围内，否则校验失败,minLength参数指定最小长度，maxLength参数指定最大长度，trim参数指定校验field之前是否去除字符串前后的空格)

    * regex (正则表达式校验器，检查被校验的属性值是否匹配一个正则表达式，expression参数指定正则表达式，caseSensitive参数指定进行正则表达式匹配时，是否区分大小写,默认值为true)

    * int(整数校验器，要求field的整数值必须在指定范围内，min指定最小值，max指定最大值)

    * double(双精度浮点数校验器,要求field的双精度浮点数必须在指定范围内,min指定最小值,max指定最大值)

    * fieldexpression (字段OGNL表达式校验器,要求field满足一个ognl表达式，expression参数指定ognl表达式,该逻辑表达式基于ValueStack进行求值,返回true时校验通过，否则不通过)

    * email(邮件地址校验器，要求如果被校验的属性值非空，则必须是合法的邮件地址)

    * url(网址校验器,要求如果被校验的属性值非空,则必须是合法的url地址)

    * date(日期校验器,要求field的日期值必须在指定范围内,min指定最小值,max指定最大值)

Struts2的拦截器

原理

* 拦截器就是AOP（Aspect-Oriented Programming）的一种实现。

    * 过滤器:过滤从客服端发送到服务器端请求的.

    * 拦截器:拦截对目标Action中的某些方法进行拦截.

        * 拦截器不能拦截JSP.

        * 拦截到Action中某些方法.

拦截器和过滤器的区别

    1）拦截器是基于JAVA反射机制的，而过滤器是基于函数回调的。

    2）过滤器依赖于Servlet容器，而拦截器不依赖于Servlet容器

    3）拦截器只能对Action请求起作用，而过滤器可以对几乎所有的请求起作用。

    4）在Action的生命周期中，拦截器可以多次被调用，而过滤器只能在容器初始化时被调用一次   

    * 拦截器 采用 责任链 模式

        > 在责任链模式里,很多对象由每一个对象对其下家的引用而连接起来形成一条链。

        > 责任链每一个节点，都可以继续调用下一个节点，也可以阻止流程继续执行

    * 在struts2 中可以定义很多个拦截器，将多个拦截器按照特定顺序 组成拦截器栈 （顺序调用 栈中的每一个拦截器 ）

Struts2的自定义拦截器

编写拦截器

需要实现Interceptor接口，实现接口中的三个方法。

    * interceptor接口有很多的实现类，编写最简单的方式就是继承AbstractInterceptor实现类。      

    * 代码例如：

 public String intercept(ActionInvocation invocation) throws Exception {
        User user = (User) ServletActionContext.getRequest().getSession().getAttribute("existUser");
            if(user == null){
                ActionSupport as = (ActionSupport) invocation.getAction();
                as.addActionError("您没有登陆！");
                return as.LOGIN;
            }else{
                // 放行
                return invocation.invoke();
            }
        }

需要在struts.xml中进行拦截器的配置

配置一共有两种方式

 第一种方式

            在<package>包中定义拦截器，出现在<package>包的上方

  <interceptors>
     <interceptor name="loginInterceptor" class="cn.zlq.interceptor.LoginInterceptor"></interceptor>
   </interceptors>

             在某个action中引入拦截器

  <interceptor-ref name="loginInterceptor"></interceptor-ref>

注意：如果引入了自己定义的拦截器，那么Struts2框架默认的拦截器就不会再执行了，所以需要引入Struts2默认的拦截器。

<interceptor-ref name="defaultStack"></interceptor-ref>

 第二种方式

                在<package>包中定义拦截器的时候，自己直接定义一个拦截器栈

<interceptors>
   <interceptor name="loginInterceptor" class="cn.zlq.interceptor.LoginInterceptor"/>
   <interceptor-stack name="myStack">
           <interceptor-ref name="loginInterceptor"/>
           <interceptor-ref name="defaultStack"/>
    </interceptor-stack>
 </interceptors>

            在Action包中引入自己定义的拦截器栈

<action name="book_*" class="cn.zlq.action.BookAction" method="{1}">
<interceptor-ref name="myStack"/>
</action>

Struts2的文件上传

Struts2框架的使用拦截器完成了文件上传

底层使用也是FileUpload开源的组件。

    * 提供 FileUpload 拦截器，用于解析 multipart/form-data 编码格式请求，解析上传文件的内容 

    * fileUpload拦截器 默认在 defaultStack 栈中， 默认会执行的 

    * 在Action中编写文件上传，需要定义三个属性

        文件类型File ,属性名与表单中file的name属性名一致.

        字符串类型String , 属性名：前段是name属性名一致 +ContentType;

        字符串类型String , 属性名：前段是name属性名一致+FileName;

        最后需要为上述的三个属性提供set方法。

        可以通过FileUtils提供 copyFile 进行文件复制，将上传文件 保存到服务器端 

文件上传中存在的问题

    * 先配置input逻辑视图

    * 在页面中显示错误信息

    * 文件上传的总大小默认值是2M，如果超过了2M，程序会报出异常。可以使用<s:actionError>来查看具体信息！

        > 解决总大小的设置，找到常量：

            * struts.multipart.parser=jakarta       -- 默认文件上传解析器，就是FileUpload组件

            * struts.multipart.saveDir=             -- 文件上传的临时文件存储目录

            * struts.multipart.maxSize=2097152      -- 文件上传的最大值（总大小），默认是2M

        > 可以在struts.xml中设置常量，修改文件上传的默认总大小！！！

          <constant name="struts.multipart.maxSize" value="5000000"></constant>

通过拦截器来设置文件上传的一些属性

 先在<action>标签中引入文件上传的拦截器

     

  <interceptor-ref name="defaultStack">
            <!-- 设置单个上传文件的大小 -->
            <param name="fileUpload.maximumSize">2097152</param>
            <!-- 设置扩展名 -->
            <param name="fileUpload.allowedExtensions">.txt</param>
        </interceptor-ref>

多文件上传

    * 在Action中还是编写三个属性

        > 属性需要是数组或者List集合，这样就可以完成多文件上传了。        

        > 注意：是数组或者List集合        

        private File [] upload;             // 代表上传的文件

        private String [] uploadContentType;    // 代表文件的类型

        private String [] uploadFileName;       // 上传文件的名称

         提供属性的set方法

Struts2的文件下载

Action类必须要有返回结果，并且返回结果中必须要依赖stream结果类型。

    * 在<action>标签中配置stream的结果类型。

    * 可以通过<result-type name="stream" class="org.apache.struts2.dispatcher.StreamResult"/>源码发现有一些需要设置的属性。

     

  <result name="success" type="stream">
            <param name="contentType">${contentType}</param>
            <param name="contentDisposition">attachment;filename=${downFileName}</param>
            <param name="inputName"></param>
   </result>

上面的代码的${contentType}这种写法需要Action类提供对应的方法，对应的方法如下

  // 获取文件的MIME类型
        public String getContentType(){
            return ServletActionContext.getServletContext().getMimeType(filename);
        }       
        // 设置文件的输入流
        public InputStream getInputStream(){
         return ServletActionContext.getServletContext().getResourceAsStream("/download/"+filename);
        }
        // 设置Content-Disposition属性
        public String getDownFilename() throws IOException{
            String agent = ServletActionContext.getRequest().getHeader("User-Agent");
            return this.encodeDownloadFilename(filename, agent);
        }

解决下载文件中文乱码的问题

  

 public String encodeDownloadFilename(String filename, String agent) throws IOException{
if(agent.contains("Firefox")){ // 火狐浏览器
    filename = "=?UTF-8?B?"+new BASE64Encoder().encode(filename.getBytes("utf-8"))+"?=";
}else{ // IE及其他浏览器
    filename = URLEncoder.encode(filename,"utf-8");
}
return filename;
    }

OGNL表达式

OGNL是Object Graphic Navigation Language（对象图导航语言）的缩写，它是一个开源项目。

    * 所谓对象图，即以任意一个对象为根，通过OGNL可以访问与这个对象关联的其它对象。

    * 通过它简单一致的表达式语法，可以存取对象的任意属性，调用对象的方法，遍历整个对象的结构图，实现字段类型转化等功能。它使用相同的表达式去存取对象的属性。

Struts2框架使用OGNL作为默认的表达式语言

    * OGNL是一种比EL强大很多倍的语言 

    * xwork 提供 OGNL表达式 

OGNL 提供五大类功能 

   * 支持对象方法调用，如xxx.doSomeSpecial()； 

   * 支持类静态的方法调用和值访问

   * 访问OGNL上下文（OGNL context）和ActionContext； （重点 操作ValueStack值栈 ）

   * 支持赋值操作和表达式串联

   * 操作集合对象。

值栈

    * 值栈就相当于Struts2框架的数据的中转站，向值栈存入一些数据。从值栈中获取到数据。

    * ValueStack 是 struts2 提供一个接口，实现类 OgnlValueStack ---- 值栈对象 （OGNL是从值栈中获取数据的 ）

    * Action是多例的，有一起请求，创建Action实例，创建一个ActionContext对象，代表的是Action的上下文对象，还会创建一个ValueStack对象。线程安全的

    * 每个Action实例都有一个ValueStack对象 （一个请求 对应 一个ValueStack对象 ）

    * 在其中保存当前Action 对象和其他相关对象 （值栈中 是有Action 引用的 ）

    * Struts 框架把 ValueStack 对象保存在名为 “struts.valueStack” 的请求属性中,request中 （值栈对象 是 request一个属性）

        * ValueStack vs = (ValueStack)request.getAttribute("struts.valueStack");

值栈的内部结构 

    * 值栈由两部分组成

        > root      -- Struts把动作和相关对象压入 ObjectStack 中--List

        > context   -- Struts把各种各样的映射关系(一些 Map 类型的对象) 压入 ContextMap 中

    * Struts 会把下面这些映射压入ContextMap中

        > parameters: 该 Map 中包含当前请求的请求参数  ?name=xxx&password=123

        > request: 该 Map 中包含当前 request 对象中的所有属性

        > session: 该 Map 中包含当前 session 对象中的所有属性

        > application:该 Map 中包含当前 application  对象中的所有属性

        > attr: 该 Map 按如下顺序来检索某个属性: request, session, application

    * ValueStack中 存在root属性 (CompoundRoot) 、 context 属性 （OgnlContext ）

        > CompoundRoot 就是ArrayList

        > OgnlContext 就是 Map

    * context 对应Map 引入 root对象 

        > context中还存在 request、 session、application、 attr、 parameters 对象引用 

        > OGNL表达式访问值栈中的数据

            * 访问root中数据时 不需要 #

            * 访问 request、 session、application、 attr、 parameters 对象数据 必须写 # 

        > 操作值栈 默认指 操作 root 元素 

值栈对象的创建

    * 值栈对象是请求时创建的

    * ActionContext是绑定到当前的线程上，那么在每个拦截器或者Action中获取到的ActionContext是同一个。

    * ActionContext中存在一个Map集合，该Map集合和ValueStack的contextMap是同一个地址。

    * ActionContext中可以获取到ValueStack的引用。

    

Action中获取值栈对象的三种方法

        * ValueStack vs1 = (ValueStack) ServletActionContext.getRequest().getAttribute("struts.valueStack");

        * ValueStack vs2 = (ValueStack) ServletActionContext.getRequest().getAttribute(ServletActionContext.STRUTS_VALUESTACK_KEY);

        * ValueStack vs3 = ActionContext.getContext().getValueStack();

向值栈保存数据

    向值栈保存数据，主要针对 root

    * 两种方式

        valueStack.push(Object obj);

            * push方法的底层调用root对象的push方法（把元素添加到0位置）

        valueStack.set(String key, Object obj);

            * 源码获取map集合（map有可能是已经存在的，有可能是新创建的），把map集合push到栈中，再把数据存入到map集合中。

        在jsp中 通过 <s:debug /> 查看值栈的内容 

    *属性驱动方式：

当ActionContext中提供了一个JavaBean的get方法，就能不将这个JavaBean放到值栈中而取到这个值

这是因为值栈的中有ActionContext对象，可以通过这个对象取到JavaBean

    *模型驱动方式：

当Action中通过模型驱动获取到对象的时候，会将模型驱动中的对象压入值栈的root栈顶，所以此时可以获取到通过Action模型驱动封装的对象

EL 表达式获取值栈中的数据

* StrutsPreparedAndExecuteFilter的doFilter代码中 request = prepare.wrapRequest(request);    

        对Request对象进行了包装 ，StrutsRequestWrapper 

        增强了request的 getAttribute

            Object attribute = super.getAttribute(s);

            if (attribute == null) {

               attribute = stack.findValue(s);

            }

        访问request范围的数据时，如果数据找不到，去值栈中找 

        request对象 具备访问值栈数据的能力 （查找root的数据）

在JSP页面中获取值栈中的值

具体在Struts2中怎么使用呢？如下步骤：

    * 需要先引入Struts2的标签库

         <%@ taglib prefix="s" uri="/struts-tags" %>

    * 使用Struts2提供的标签中的标签

         <s:property value="OGNL表达式"/>

在JSP页面使用OGNL表达式

    * 访问对象方法:

        <s:property value="'hello'.length()"/>

    * 访问对象的静态方法:

        > struts2中静态方法访问被禁止的.开启一个常量.

        <constant name="struts.ognl.allowStaticMethodAccess" value="true"/>

        > 在页面中:

        <s:property value="@java.lang.Math@random()"/>

使用OGNL表达式获取值栈中的数据

# 符号

        <s:property value="#request.name"/>

        <s:property value="#session.name"/>

        <s:property value="#application.name"/>

        <s:property value="#attr.name"/>

        <s:property value="#parameters.id"/>

        <s:property value="#parameters.name"/>

%号

强制字符串解析成OGNL表达式。

         例如：在request域中存入值，然后在文本框（<s:textfield>）中取值，现在到value上。

         <s:textfield value="%{#request.msg}"/>

{ }中值用''引起来,此时不再是ognl表达式,而是普通的字符串

        例如：<s:property value="%{'#request.msg'}"/> 

$号

在配置文件中可以使用OGNL表达式