Struts2【四】

校验

Struts有许多内置校验器，同时也可以自定义校验规则。输入校验分两类：

服务器端校验

java代码

• validate() 校验action中所有与execute方法签名相同的方法
• validateXxx() 校验指定方法

.java
class action extends ActionSupport
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", "手机号的格式不正确"); 
    }
}

.xml
<result name="input">/addUser.jsp</result>

.jsp 
<s:fielderror/>

当某个数据校验失败时，调用addFieldError()方法往系统的fieldErrors中添加校验失败信息。
如果系统的fieldErrors包含失败信息，struts2会将请求转发到名为input的result。
在input的视图中可以通过 < s:fielderror /> 显示失败信息。

xml配置

Action.java：也需要继承ActionSupport
ActionClassName-validation.xml：校验所有方法，和action类放在同一个包下
ActionClassName-ActionName-validation.xml：校验指定方法

<?xml version="1.0" encoding="UTF-8"?>
<validators>
    <!--指定action中要校验的属性-->
    <field name="username">
        <!--指定校验器，short-circut保证只显示一个错误提示信息-->
        <field-validator type="requiredstring" short-circuit="true">
            <param name="trim">true</param>
            <!--校验失败的提示信息-->
            <message>用户名不能为空!</message>
        </field-validator>
    </field>
</validators>

使用xml校验时，系统先找所有方法.xml，再找指定方法.xml，然后汇总校验规则，如果冲突，则使用后面文件的规则。
如果一个action继承了另一个action，那么先找父action的.xml，然后汇总这四个.xml。

内置校验器

required 必填校验器
requiredstring 必填字符串校验器，不为null，且长度大于0，默认去前后空格

stringlength 字符串长度校验器，要求在指定的范围内
regex 正则表达式校验器

<field-validator type="regex">
     <param name="expression"><![CDATA[^1[358]\d{9}$]]></param>
     <message>手机号格式不正确!</message>
</field-validator>

email 邮件地址校验器，要求如果非空，则必须是合法的邮件地址
url 网址校验器，要求如果非空，则必须是合法的url地址
date 日期校验器，要求必须在指定范围内

客户端校验

1.使用Struts2标签生成表单
2.在< s:form >中添加 validate=”true”属性
3.网页放在web-inf目录下，通过发送action请求访问。 Result跳转到webInfo/1.jsp
客户端校验只支持八种校验器：

required	requiredstring	stringlength	regex
int	double	url	email

字段/非字段校验器

字段校验器

<field name="username">
    <field-validator type="requiredstring" >
        <param name="trim">true</param>
        <message>用户名不能为空!</message>
    </field-validator>
</field>

非字段校验器

<validator type="requiredstring">
    <param name="fieldName">username</param>
    <param name="trim">true</param>
    <message>用户名不能为空!</message>
</validator>

校验器的执行顺序：
1.非字段优先于字段校验器
2.所有非字段校验器排在前面的会先执行。
3.所有字段校验器排在前面的先执行。

短路原则：
1.执行非字段校验器时，某个非字段校验失败，该字段上的所有的校验器不会执行
2.非字段校验器校验失败，不会阻止其他非字段的校验器执行。如果要阻止，设置短路。

3.执行字段时，某个字段校验失败，该字段上的所有的校验器不会执行。和短路没关系。
4.字段校验器校验失败，不会阻止其他字段的校验器执行。

国际化

国际化是指在程序运行过程中，可根据客户端请求来自的国家/语言，显示不同的界面。

<struts>
    <!--注册资源文件-->
    <constant name="struts.custom.i18n.resources" value="baseName" />
</struts>

baseName_language_country.propertie	jsp	action.java
key1 = str a key2 = str b key 3 = {0} is a {1}	hello! <s:text name=”key 1”>，welcome to <s:text name=”key 2”>	getText(String key, String[] args)

OGNL表达式

Struts2采用OGNL—Object Graphic Navigation Language（对象图导航语言）作为默认表达式语言。
相对于EL表达式，OGNL支持对象方法调用，类静态方法和值的访问。
@[类全名（包括包路径）]@[方法名 | 值名]
@java.lang.String@format(‘foo %s’, ‘bar’)或@java.lang.Math@PI

访问示例

访问值栈中元素
    <s:property value="username" />
访问值栈中对象的属性
    <s:property value="userInfo.name" />
访问值栈中对象的方法
    <s:property value="username.trim().length()" />
访问值栈中action的普通方法
    <s:property value="sayHello()" />

访问静态方法，首先要把struts.ognl.allowStaticMethodAccess设为"true"
    <s:property value="@com.pk.util.TimeHelper@getTime()" />
访问静态属性
    <s:property value="@com.pk.util.Constants@TITLE" />

访问List中某个元素
    <s:property value="userList[1]" />
访问List中元素某个属性的集合
    <s:property value="userList.{age}" />
List的大小
    <s:property value="userList.size()" />
    <s:property value="userList.size" />

访问Map中某个元素
    <s:property value="userMap.key1" />
    <s:property value="userMap[‘key1']" />
访问Map中所有的key
    <s:property value="userMap.keys" />
访问Map中所有的value
    <s:property value="userMap.values" />

直接生成List集合的语法为： {e1, e2, e3}
    <s:select  name="name" list="{'北京','上海','天津'}" value="'天津'" />
直接生成Map的语法为
    <s:select  name="name" list="#{'001':'北京', '002':'上海'}" value="'002'" />

对于集合，OGNL提供了两个元素符: in , not in 
    in判定某个元素是否在指定的集合中， not in 判定某个元素是否不在指定的计划中
    <s:if test="'foo' in {'foo','bar'}"> 包含</s:if>
    <s:else> 不包含 </s:else>

原理

在struts2中，根对象ValueStack的实现类为OgnlValueStack，该对象不是我们想像的只存放单个值，而是存放一组对象。
在OgnlValueStack类里有一个List类型的root变量，就是使用他存放一组对象
context
    |–request
    |–application
    |–OgnlValueStack root变量[action, OgnlUtil, … ]
    |–session
    |–attr
    |–parameters
在root变量中处于第一位的对象叫栈顶对象。通常我们在OGNL表达式里直接写上属性的名称即可访问root变量里对象的属性。
如果访问其他Context中的对象，由于他们不是根对象，所以在访问时，需要添加#前缀。如#session