目录
1. Struts2提供了三种数据封装的方式
2. 封装数据到Collection和Map
3. 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指定最大值)
required 必填校验器
<field-validator type="required">
<message>性别不能为空!</message>
</field-validator>
```
requiredstring 必填字符串校验器
```
<field-validator type="requiredstring">
<param name="trim">true</param>
<message>用户名不能为空!</message>
</field-validator>
```
stringlength:字符串长度校验器
```
<field-validator type="stringlength">
<param name="maxLength">10</param>
<param name="minLength">2</param>
<param name="trim">true</param>
<message><![CDATA[产品名称应在2-10个字符之间]]></message>
</field-validator>
```
int:整数校验器
```
<field-validator type="int">
<param name="min">1</param>
<param name="max">150</param>
<message>年龄必须在1-150之间</message>
</field-validator>
```
date: 日期校验器
```
<field-validator type="date">
<param name="min">1900-01-01</param>
<param name="max">2050-02-21</param>
<message>生日必须在${min}到${max}之间</message>
</field-validator>
url: 网络路径校验器
<field-validator type="url">
<message>传智播客的主页地址必须是一个有效网址</message>
</field-validator>
```
email:邮件地址校验器
```
<field-validator type="email">
<message>电子邮件地址无效</message>
</field-validator>
```
regex:正则表达式校验器
```
<field-validator type="regex">
<param name="regexExpression"><![CDATA[^13\d{9}$]]></param>
<message>手机号格式不正确!</message>
</field-validator>
```
fieldexpression : 字段表达式校验
```
<field-validator type="fieldexpression">
<param name="expression"><![CDATA[(password==repassword)]]></param>
<message>两次密码输入不一致</message>
</field-validator>
```
**对action中的指定方法进行校验**
当校验文件的取名为ActionClassName-validation.xml时,会对action中的所有处理方法实施输入验证,如果只需要对action中的某个action方法校验,那么,校验文件的取名应该为ActionClassName-ActionName-validation.xml,**其中ActionName为Struts.xml中action的名称**。例如:
```
<action name="user_*" class="com.java.action.UserAction" method="{1}" >
<result name="success">/WEB-INF/page/message.jsp</result>
<result name="input">/WEB-INF/page/addUser.jsp</result>
</action>
```
在UserAction中有两个处理方法:
public String add() throws Exception{}
public String update() throws Exception{}
要对add()方法实施验证,校验文件取名为:UserAction-user_add-validation.xml
要对update()方法实施验证,校验文件取名为:UserAction-user_update-validation.xml