Struts2干货笔记-JobPlus

目录1. Struts2提供了三种数据封装的方式2. 封装数据到Collection和Map3. Struts2类型转换器4. 类型转换器中的错误处理5. 请求参数验证6. 对action中的指定方法进行校验Struts2提供了三种数据封装的方式1. 属性驱动

Action本身作为model对象，通过setter封装
页面：
用户名 <input type="text" name="username" />

Action ：
public class RegistAction extends ActionSupport {
private String username;
public void setUsername(String username) {
this.username = username;
}
}
创建独立的model对象，页面通过ognl表达式封装
页面：
用户名 <input type="text" name="user.username" />
// 基于OGNL表达式的写法
Action：
public class RegistAction2 extends ActionSupport {
private User user;
public void setUser(User user) {
this.user = user;
}
public User getUser() { return user; } }

2. 模型驱动(主流)

使用ModelDriven接口，对请求参数进行封装
页面：
用户名 <input type="text" name="username" />

Action ：
public class RegistAction3 extends ActionSupport implements ModelDriven<User> {
private User user = new User(); // 必须手动实例化
public User getModel() {
return user;
}
}

封装数据到Collection和Map

封装数据到Collection，常见于需要快速录入批量数据的场景
页面：
产品名称 <input type="text" name="products[0].name" />

Action ：
public class ProductAction extends ActionSupport {
private List<Product> products;
public List<Product> getProducts() { return products; } public void setProducts(List<Product> products) { this.products = products; } }

页面：
产品名称 <input type="text" name="map['one'].name" />
-- one是map的键值
Action :
public class ProductAction2 extends ActionSupport {
private Map<String, Product> map;

public Map<String, Product> getMap() { return map; } public void setMap(Map<String, Product> map) { this.map = map; } }

Struts2类型转换器

当我们发送一个HTTP请求时，请求的内容都以字符串的形式发送给服务器，所以需要转换成Action里定义的类型，例如，如果你的Action类中有一个integer属性，你不需要执行任何操作，Struts会自动将请求参数转换为integer属性。对于大部分常用类型，无需创建转换器，Struts2内置了很多常见数据类型的转换器。

boolean 和 Boolean
char和 Character
int 和 Integer
long 和 Long
float 和 Float
double 和 Double
Date 可以接收 yyyy-MM-dd格式字符串
数组可以将多个同名参数，转换到数组中
集合支持将数据保存到 List 或者 Map 集合

struts2中的类型转换器根接口是：com.opensymphony.xwork2.conversion.TypeConverter。

自定义类型转换器

Date类型的属性可以接收格式为2000-02-20的请求参数，但是如果要接收格式为20000220的请求参数，就必须要自定义类型转换器，否则struts2无法自动完成类型转换。

步骤:

创建一个类实现TypeConverter接口.
重写接口中方法，实现类型转换操作.
注册类型转换器.

** 创建自定义类型转换器的方法 **

实现TypeConverter，重写方法
public Object convertValue(Map<String, Object> context, Object target,
Member member, String propertyName, Object value, Class toType);
继承 DefaultTypeConverter类
public Object convertValue(Map<String, Object> context, Object value, Class toType) {
return convertValue(value, toType);
}
继承DefaultTypeConverter类的一个子类StrutsTypeConverter(推荐)
public abstract Object convertFromString(Map context, String[] values, Class toClass);
public abstract String convertToString(Map context, Object o);

** 注册一个自定义类型转换器 **

局部--针对于action
配置文件所在位置以及名称: 在Action类所在包创建 Action类名-conversion.properties ,
配置文件书写: 格式：属性名称=类型转换器的全类名
局部--针对于model
配置文件所在位置以及名称: 在model类所在包创建 model类名-conversion.properties ,
配置文件书写: 格式：属性名称=类型转换器的全类名
全局
配置文件所在位置以及名称:在src下创建一个xwork-conversion.properties
配置文件书写: 格式: 要转换的类型全名=类型转换器的全类名
类型转换器中的错误处理

我们希望用户输入abc,def模式的字符串，输入的字符串包含一个英文逗号作为用户名和密码的分隔符，如果用户输入了多个英文逗号，或者没有输入英文逗号，都将引起系统异常，因为上面的类型转换器将无法正常解出用户名和密码，实际上，表现层数据涉及两个处理：数据校验和类型转换是紧密相关的，只有当输入数据时有效数据时，系统才可以进行有效的类型转换——当然，有时候即使用户输入的数据能进行有效转换，但依然是非法数据（假设需要输入一个人的年龄，输入200则是非法数据）。因此，可以进行有效的类型转换时基础，只有当数据完成了有效的类型转换后，下一步才去做数据校验。

Struts2提供了一个名为conversion-Error的拦截器，这个拦截器被注册在默认的拦截器栈中，我们查看Struts2框架的默认配置文件：struts-default.xml文件，
<interceptor name="conversionError" class="org.apache.struts2.interceptor.StrutsConversionErrorInterceptor"/>

通过分析拦截器作用，得知当类型转换出错时，自动跳转input视图，在input视图页面中 <s:fieldError/> 显示错误信息
在Action所在包中，创建 ActionName.properties，在局部资源文件中配置提示信息： invalid.fieldvalue.属性名= 错误信息

请求参数验证

两种方式：

手动校验
配置校验（xml）

** 1. 手动校验(了解) **

继承ActionSupport，重写validate()方法，在该方法中完成验证,validate()方法在其他的业务方法之前执行
验证出错后转向的页面
struts.xml配置<result name="input">/validate/login.jsp</result>
什么时候表示验证出错？
this.addFieldError("a","错误信息");方法指向的一个集合
当集合不为空时，转向错误页面。
在jsp页面中使用
<s:fielderror> 展示所有错误信息
<s:fielderror fieldName="">展示特定名称的错误信息

** 2. 配置校验(重点) **
要求:action类必须继承自ActionSupport
配置文件：

位置:xml文件要与action类在同一个包下
名称:action类名-validation.xml
约束: xwork-core-2.3.7.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">
写法:
1)根元素<validators>
2)子元素<field name="属性名称"></field>，name为页面被验证的表单字段的名称
3)<field>的子元素<field-validator type="校验器"> 这个是指定校验器
校验器有哪些?
在xwork-core-2.3.7.jar 中 /com/opensymphony/xwork2/validator/validators/default.xml下
<validator name="required" class="com.opensymphony.xwork2.validator.validators.RequiredFieldValidator"/>
<validator name="requiredstring" class="com.opensymphony.xwork2.validator.validators.RequiredStringValidator"/>
<validator name="int" class="com.opensymphony.xwork2.validator.validators.IntRangeFieldValidator"/>
<validator name="long" class="com.opensymphony.xwork2.validator.validators.LongRangeFieldValidator"/>
<validator name="short" class="com.opensymphony.xwork2.validator.validators.ShortRangeFieldValidator"/>
<validator name="double" class="com.opensymphony.xwork2.validator.validators.DoubleRangeFieldValidator"/>
<validator name="date" class="com.opensymphony.xwork2.validator.validators.DateRangeFieldValidator"/>
<validator name="expression" class="com.opensymphony.xwork2.validator.validators.ExpressionValidator"/>
<validator name="fieldexpression" class="com.opensymphony.xwork2.validator.validators.FieldExpressionValidator"/>
<validator name="email" class="com.opensymphony.xwork2.validator.validators.EmailValidator"/>
<validator name="url" class="com.opensymphony.xwork2.validator.validators.URLValidator"/>
<validator name="visitor" class="com.opensymphony.xwork2.validator.validators.VisitorFieldValidator"/>
<validator name="conversion" class="com.opensymphony.xwork2.validator.validators.ConversionErrorFieldValidator"/>
<validator name="stringlength" class="com.opensymphony.xwork2.validator.validators.StringLengthFieldValidator"/>
<validator name="regex" class="com.opensymphony.xwork2.validator.validators.RegexFieldValidator"/>
<validator name="conditionalvisitor" class="com.opensymphony.xwork2.validator.validators.ConditionalVisitorFieldValidator"/>
4)<field-validator>的子元素<message>错误信息</message>
5)<field-validator>子元素的<param name="">值</param>用于指定校验器中的参数

** 系统提供的校验器：**

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指定最大值)

目录1. Struts2提供了三种数据封装的方式2. 封装数据到Collection和Map3. Struts2类型转换器4. 类型转换器中的错误处理5. 请求参数验证6. 对action中的指定方法进行校验Struts2提供了三种数据封装的方式1. 属性驱动<ul><li>Action本身作为model对象，通过setter封装 页面： 用户名  <input type="text" name="username" /> Action ： public class RegistAction extends ActionSupport { private String username; public void setUsername(String username) { this.username = username; } }</li><li>创建独立的model对象，页面通过ognl表达式封装 页面： 用户名  <input type="text" name="user.username" />  // 基于OGNL表达式的写法 Action： public class RegistAction2 extends ActionSupport { private User user; public void setUser(User user) { this.user = user; }</li><li>  public User getUser() {
       return user;
   }
 }</li></ul>2. 模型驱动(主流)<ul><li>使用ModelDriven接口，对请求参数进行封装 页面： 用户名  <input type="text" name="username" />   Action ： public class RegistAction3 extends ActionSupport implements ModelDriven<User> { private User user = new User(); // 必须手动实例化 public User getModel() { return user; } }</li></ul>封装数据到Collection和Map<ol><li>封装数据到Collection，常见于需要快速录入批量数据的场景 页面： 产品名称 <input type="text" name="products[0].name" /> Action ： public class ProductAction extends ActionSupport { private List<Product> products;    public List<Product> getProducts() {
         return products;
     }

public void setProducts(List<Product> products) {
         this.products = products;
     }
 }</li></ol>页面： 产品名称 <input type="text" name="map['one'].name" />  --  one是map的键值 Action : public class ProductAction2 extends ActionSupport { private Map<String, Product> map;       public Map<String, Product> getMap() {
            return map;
        }

public void setMap(Map<String, Product> map) {
            this.map = map;
        }
    }  <h3>Struts2类型转换器</h3>当我们发送一个HTTP请求时，请求的内容都以字符串的形式发送给服务器，所以需要转换成Action里定义的类型，例如，如果你的Action类中有一个integer属性，你不需要执行任何操作，Struts会自动将请求参数转换为integer属性。对于大部分常用类型，无需创建转换器，Struts2内置了很多常见数据类型的转换器。<ul><li>boolean 和 Boolean</li><li>char和 Character</li><li>int 和 Integer</li><li>long 和 Long</li><li>float 和 Float</li><li>double 和 Double</li><li>Date 可以接收 yyyy-MM-dd格式字符串</li><li>数组  可以将多个同名参数，转换到数组中</li><li>集合  支持将数据保存到 List 或者 Map 集合</li></ul>struts2中的类型转换器根接口是：com.opensymphony.xwork2.conversion.TypeConverter。自定义类型转换器Date类型的属性可以接收格式为2000-02-20的请求参数，但是如果要接收格式为20000220的请求参数，就必须要自定义类型转换器，否则struts2无法自动完成类型转换。步骤:<ol><li>创建一个类实现TypeConverter接口.</li><li>重写接口中方法，实现类型转换操作.</li><li>注册类型转换器.</li></ol>** 创建自定义类型转换器的方法 **<ol><li>实现TypeConverter，重写方法 public Object convertValue(Map<String, Object> context, Object target, Member member, String propertyName, Object value, Class toType);</li><li>继承 DefaultTypeConverter类 public Object convertValue(Map<String, Object> context, Object value, Class toType) { return convertValue(value, toType); }</li><li>继承DefaultTypeConverter类的一个子类StrutsTypeConverter(推荐) public abstract Object convertFromString(Map context, String[] values, Class toClass); public abstract String convertToString(Map context, Object o);</li></ol>** 注册一个自定义类型转换器 **<ol><li>局部--针对于action 配置文件所在位置以及名称:  在Action类所在包 创建 Action类名-conversion.properties , 配置文件书写:    格式 ： 属性名称=类型转换器的全类名</li><li>局部--针对于model 配置文件所在位置以及名称:  在model类所在包 创建 model类名-conversion.properties , 配置文件书写:    格式 ： 属性名称=类型转换器的全类名</li><li>全局 配置文件所在位置以及名称:在src下创建一个xwork-conversion.properties 配置文件书写:  格式:  要转换的类型全名=类型转换器的全类名</li><li>类型转换器中的错误处理</li></ol>我们希望用户输入abc,def模式的字符串，输入的字符串包含一个英文逗号作为用户名和密码的分隔符，如果用户输入了多个英文逗号，或者没有输入英文逗号，都将引起系统异常，因为上面的类型转换器将无法正常解出用户名和密码，实际上，表现层数据涉及两个处理：数据校验和类型转换是紧密相关的，只有当输入数据时有效数据时，系统才可以进行有效的类型转换——当然，有时候即使用户输入的数据能进行有效转换，但依然是非法数据（假设需要输入一个人的年龄，输入200则是非法数据）。因此，可以进行有效的类型转换时基础，只有当数据完成了有效的类型转换后，下一步才去做数据校验。Struts2提供了一个名为conversion-Error的拦截器，这个拦截器被注册在默认的拦截器栈中，我们查看Struts2框架的默认配置文件：struts-default.xml文件， <interceptor name="conversionError" class="org.apache.struts2.interceptor.StrutsConversionErrorInterceptor"/>通过分析拦截器作用，得知当类型转换出错时，自动跳转input视图 ，在input视图页面中 <s:fieldError/> 显示错误信息 在Action所在包中，创建 ActionName.properties，在局部资源文件中配置提示信息 ： invalid.fieldvalue.属性名= 错误信息<h3>请求参数验证</h3>两种方式：<ul><li>手动校验</li><li>配置校验（xml）</li></ul>** 1. 手动校验(了解) **<ul><li>继承ActionSupport，重写validate()方法，在该方法中完成验证,validate()方法在其他的业务方法之前执行</li><li>验证出错后转向的页面 struts.xml配置<result name="input">/validate/login.jsp</result></li><li>什么时候表示验证出错？ this.addFieldError("a","错误信息");方法指向的一个集合 当集合不为空时，转向错误页面。 在jsp页面中使用 <s:fielderror> 展示所有错误信息 <s:fielderror fieldName="">展示特定名称的错误信息</li></ul>** 2. 配置校验(重点) ** 要求:action类必须继承自ActionSupport 配置文件：<ul><li>位置:xml文件要与action类在同一个包下</li><li>名称:action类名-validation.xml</li><li>约束: xwork-core-2.3.7.jar 中 xwork-validator-1.0.3.dtd 下 <!DOCTYPE validators PUBLIC "-//Apache Struts//XWork Validator 1.0.3//EN" "<a href="http://#" onclick="return false;">http://struts.apache.org/dtds/xwork-validator-1.0.3.dtd</a>"></li><li>写法: 1)根元素<validators> 2)子元素<field name="属性名称"></field>，name为页面被验证的表单字段的名称 3)<field>的子元素<field-validator type="校验器"> 这个是指定校验器 校验器有哪些? 在xwork-core-2.3.7.jar 中 /com/opensymphony/xwork2/validator/validators/default.xml下 <validator name="required" class="com.opensymphony.xwork2.validator.validators.RequiredFieldValidator"/> <validator name="requiredstring" class="com.opensymphony.xwork2.validator.validators.RequiredStringValidator"/> <validator name="int" class="com.opensymphony.xwork2.validator.validators.IntRangeFieldValidator"/> <validator name="long" class="com.opensymphony.xwork2.validator.validators.LongRangeFieldValidator"/> <validator name="short" class="com.opensymphony.xwork2.validator.validators.ShortRangeFieldValidator"/> <validator name="double" class="com.opensymphony.xwork2.validator.validators.DoubleRangeFieldValidator"/> <validator name="date" class="com.opensymphony.xwork2.validator.validators.DateRangeFieldValidator"/> <validator name="expression" class="com.opensymphony.xwork2.validator.validators.ExpressionValidator"/> <validator name="fieldexpression" class="com.opensymphony.xwork2.validator.validators.FieldExpressionValidator"/> <validator name="email" class="com.opensymphony.xwork2.validator.validators.EmailValidator"/> <validator name="url" class="com.opensymphony.xwork2.validator.validators.URLValidator"/> <validator name="visitor" class="com.opensymphony.xwork2.validator.validators.VisitorFieldValidator"/> <validator name="conversion" class="com.opensymphony.xwork2.validator.validators.ConversionErrorFieldValidator"/> <validator name="stringlength" class="com.opensymphony.xwork2.validator.validators.StringLengthFieldValidator"/> <validator name="regex" class="com.opensymphony.xwork2.validator.validators.RegexFieldValidator"/> <validator name="conditionalvisitor" class="com.opensymphony.xwork2.validator.validators.ConditionalVisitorFieldValidator"/> 4)<field-validator>的子元素<message>错误信息</message> 5)<field-validator>子元素的<param name="">值</param>用于指定校验器中的参数</li></ul>** 系统提供的校验器：**<ul><li>required (必填校验器,要求被校验的属性值不能为null)</li><li>requiredstring (必填字符串校验器,要求被校验的属性值不能为null，并且长度大于0,默* 认情况下会对字符串去前后空格)</li><li>stringlength (字符串长度校验器，要求被校验的属性值必须在指定的范围内，否则校验失败,minLength参数指定最小长度，maxLength参数指定最大长度，trim参数指定校验</li><li>field之前是否去除字符串前后的空格)</li><li>regex (正则表达式校验器，检查被校验的属性值是否匹配一个正则表达式，expression参数指定正则表达式，caseSensitive参数指定进行正则表达式匹配时，是否区分大小写,默认值为true)</li><li>int(整数校验器，要求field的整数值必须在指定范围内，min指定最小值，max指定最大值)</li><li>double(双精度浮点数校验器,要求field的双精度浮点数必须在指定范围内,min指定最小值,max指定最大值)</li><li>fieldexpression (字段OGNL表达式校验器,要求field满足一个ognl表达式，expression参数指定ognl表达式,该逻辑表达式基于ValueStack进行求值,返回true时校验通过，否则不通过)</li><li>email(邮件地址校验器，要求如果被校验的属性值非空，则必须是合法的邮件地址)</li><li>url(网址校验器,要求如果被校验的属性值非空,则必须是合法的url地址)</li><li>date(日期校验器,要求field的日期值必须在指定范围内,min指定最小值,max指定最大值)</li></ul>