struts2
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表达式