• 【Struts2学习笔记(11)】对action的输入校验和XML配置方式实现对action的全部方法进行输入校验



    在struts2中,我们能够实现对action的全部方法进行校验或者对action的指定方法进行校验。


    对于输入校验struts2提供了两种实现方法:
    1. 採用手工编写代码实现。


    2. 基于XML配置方式实现。

    一、採用手工编写代码实现

    1.手工编写代码实现对action中全部方法输入校验

    通过重写validate() 方法实现。 validate()方法会校验action中全部与execute方法签名同样的方法。

    当某个数据校验失败时。我们应该调用addFieldError()方法往系统的fieldErrors加入校验失败信息

    (为了使用addFieldError()方法。action能够继承ActionSupport ),假设系统的fieldErrors包括失败信息,

    struts2会将请求转发到名为input的result。在input视图中能够通过<s:fielderror/>显示失败信息。

    validate()使用样例:

    表单提交内容:

    <form
    		action="${pageContext.request.contextPath}/person/manage_update.action"
    		method="post">
    		用户名:<input type="text" name="username" />不能为空<br /> 
    		手机号:<input type="text" name="mobile" />不能为空,而且要符合手机号的格式1,3/5/8,后面是9个数字<br /> 
    		<input type="submit" value="提 交" />
    	</form>
    校验代码:

    package cn.lc.action;
    
    import java.util.regex.Pattern;
    
    import com.opensymphony.xwork2.ActionContext;
    import com.opensymphony.xwork2.ActionSupport;
    
    public class PersonAction extends ActionSupport {
    	private String username;
    	private String mobile;
    
    	//省略get/set方法
    
    	/*
    	 * 一下是校验的方法
    	 */
    	public String update() {
    		ActionContext.getContext().put("message", "更新成功");
    		return "message";
    	}
    
    	public String save() {
    		ActionContext.getContext().put("message", "保存成功");
    		return "message";
    	}
    
    	@Override
    	public void validate() {// 会对action中的全部方法校验
    		if (this.username == null || "".equals(this.username.trim())) {
    			this.addFieldError("username", "用户名不能为空");
    		}
    		if (this.mobile == null || "".equals(this.mobile.trim())) {
    			this.addFieldError("mobile", "手机号不能为空");
    		} else {
    			if (!Pattern.compile("^1[358]\d{9}$").matcher(this.mobile).matches()) {
    				this.addFieldError("mobile", "手机号格式不对");
    			}
    		}
    	}
    
    }
    配置文件:
    <struts>     
    	 <package name="person" namespace="/person" extends="struts-default">
    	        <action name="manage_*" class="cn.lc.action.PersonAction" method="{1}">
    	        	<result name="input">/index.jsp</result>
    	        	<result name="message">/WEB-INF/page/message.jsp</result>
    	        </action>
    	 </package>
    </struts>


    验证失败后。请求转发至input视图:
    <result name="input">/WEB-INF/page/addUser.jsp</result>

    在addUser.jsp页面中使用<s:fielderror/>显示失败信息。

    2.手工编写代码实现对action指定方法输入校验

    通过validateXxx()方法实现。 validateXxx()仅仅会校验action中方法名为Xxx的方法。当中Xxx的第一个字母要大写。当某个数据校验失败时,我们应该调用addFieldError()方法往系统的fieldErrors加入校验失败信息(为了使用addFieldError()方法,action能够继承ActionSupport ),假设系统的fieldErrors包括失败信息,struts2会将请求转发到名为input的result。

    在input视图中能够通过<s:fielderror/>显示失败信息。

    validateXxx()方法使用样例:

    public class PersonAction extends ActionSupport {
    	private String username;
    	private String mobile;
    	
    	//get/set方法
    
    	public String update() {
    		ActionContext.getContext().put("message", "更新成功");
    		return "message";
    	}
    	public String save() {
    		ActionContext.getContext().put("message", "保存成功");
    		return "message";
    	}
    	public void validateUpdate() {// 会对update()方法校验
    		if (this.username == null || "".equals(this.username.trim())) {
    			this.addFieldError("username", "用户名不能为空");
    		}
    		if (this.mobile == null || "".equals(this.mobile.trim())) {
    			this.addFieldError("mobile", "手机号不能为空");
    		} else {
    			if (!Pattern.compile("^1[358]\d{9}$").matcher(this.mobile)
    					.matches()) {
    				this.addFieldError("mobile", "手机号格式不对");
    			}
    		}
    	}
    
    }
    

    配置文件没有变化 表单提交代码也没有变化!

    3.输入校验的流程

    1、类型转换器对请求參数运行类型转换。并把转换后的值赋给action中的属性。

    2、假设在运行类型转换的过程中出现异常,系统会将异常信息保存到ActionContext,conversionError拦截器将异常信息加入到fieldErrors里。

    无论类型转换是否出现异常,都会进入第3步。

    3、系统通过反射技术先调用action中的validateXxx()方法,Xxx为方法名。



    4、再调用action中的validate()方法。



    5、经过上面4步,假设系统中的fieldErrors存在错误信息(即存放错误信息的集合的size大于0),系统自己主动将请求转发至名称为input的视图。

    假设系统中的fieldErrors没有不论什么错误信息。系统将运行action中的处理方法。


    二、基于xml文件配置的实现

    1.基于XML配置方式实现对action的全部方法进行输入校验

    (1)使用基于XML配置方式实现输入校验时。Action也须要继承ActionSupport,而且提供校验文件。校验文件和action类放在同一个包下,文件的取名格式为:ActionClassName-validation.xml,当中ActionClassName为action的简单类名。-validation为固定写法。
    假设Action类为cn.itcast.UserAction,那么该文件的取名应为:UserAction-validation.xml。
    以下是校验文件的模版:(PersonAction-validation.xml文件例如以下:)
    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0.3//EN" "http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd"> 
    <validators>
        <field name="username">
            <field-validator type="requiredstring">
                <param name="trim">true</param>
                <message>用户名不能为空!</message>
            </field-validator>
        </field>
        <field name="mobile">
            <field-validator type="requiredstring">
                <message>手机号不能为空!</message>
            </field-validator>
            <field-validator type="regex">
    <span style="white-space:pre">	</span>   <param name="expression"><![CDATA[^1[358]d{9}$]]></param>
    <span style="white-space:pre">	</span>   <message>手机号格式不对!</message>
    <span style="white-space:pre">	</span></field-validator>
        </field>
    </validators>
    

    (2)<field>指定action中要校验的属性。<field-validator>指定校验器。上面指定的校验器requiredstring是由系统提供的,系统提供了能满足大部分验证需求的校验器,这些校验器的定义能够在xwork-2.x.jar中的com.opensymphony.xwork2.validator.validators下的default.xml中找到。
    <message>为校验失败后的提示信息,假设须要国际化,能够为message指定key属性,key的值为资源文件里的key。


    在这个校验文件里,对action中字符串类型的username属性进行验证,首先要求调用trim()方法去掉空格,然后推断用户名是否为空。

    (3)struts2提供的校验器列表
    系统提供的校验器例如以下:
    required (必填校验器,要求field的值不能为null)
    requiredstring (必填字符串校验器,要求field的值不能为null,而且长度大于0,默认情况下会对字符串去前后空格)
    stringlength(字符串长度校验器,要求field的值必须在指定的范围内,否则校验失败,minLength參数指定最小长度,maxLength參数指定最大长度,trim參数指定校验field之前是否去除字符串前后的空格)
    regex(正則表達式校验器,检查被校验的field是否匹配一个正則表達式.expression參数指定正則表達式,caseSensitive參数指定进行正則表達式匹配时,是否区分大写和小写,默认值为true)
    int(整数校验器,要求field的整数值必须在指定范围内,min指定最小值,max指定最大值)
    double(双精度浮点数校验器,要求field的双精度浮点数必须在指定范围内,min指定最小值,max指定最大值)
    fieldexpression(字段OGNL表达式校验器,要求field满足一个ognl表达式,expression參数指定ognl表达式,该逻辑表达式基于ValueStack进行求值,返回true时校验通过,否则不通过)
    email(邮件地址校验器,要求假设field的值非空,则必须是合法的邮件地址)
    url(网址校验器,要求假设field的值非空,则必须是合法的url地址)
    date(日期校验器,要求field的日期值必须在指定范围内,min指定最小值,max指定最大值)
    conversion(转换校验器,指定在类型转换失败时,提示的错误信息)
    visitor(用于校验action中的复合属性,它指定一个校验文件用于校验复合属性中的属性)
    expression(OGNL表达式校验器,expression參数指定ognl表达式,该逻辑表达式基于ValueStack进行求值,返回true时校验通过,否则不通过,该校验器不可用在字段校验器风格的配置中)
    

    (4)校验器的使用样例
    required  必填校验器
    <field-validator type="required">
           <message>性别不能为空!</message>
    </field-validator>
    
    requiredstring  必填字符串校验器
    <field-validator type="requiredstring">
           <param name="trim">true</param>
           <message>username不能为空!</message>
    </field-validator>
    email:邮件地址校验器
    <field-validator type="email">
    <span style="white-space:pre">	</span><message>电子邮件地址无效</message>
    </field-validator>
    
    
    regex:正則表達式校验器
    <field-validator type="regex">
         <param name="expression"><![CDATA[^1[358]d{9}$]]></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">
    <span style="white-space:pre">	</span><param name="min">1</param>
    <span style="white-space:pre">	</span><param name="max">150</param>
    <span style="white-space:pre">	</span><message>年龄必须在1-150之间</message>
    </field-validator>
    
    
    字段OGNL表达式校验器
    <field name="imagefile">
    <span style="white-space:pre">	</span><field-validator type="fieldexpression">
    <span style="white-space:pre">		</span><param name="expression"><![CDATA[imagefile.length() <= 0]]></param>
    <span style="white-space:pre">		</span><message>文件不能为空</message>
    <span style="white-space:pre">	</span></field-validator>
    </field>
    

    2、基于XML配置方式实现对action的部分方法进行输入校验

    (1)当校验文件的取名为ActionClassName-validation.xml时,会对 action中的全部处理方法实施输入验证。

    假设你仅仅须要对action中的某个action方法实施校验,那么,校验文件的取名应为:ActionClassName-ActionName-validation.xml,当中ActionName为struts.xml中action的名称。

    比如:在实际应用中。常有下面配置:

    <action name="user_*" class="cn.itcast.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

    <?xml version="1.0" encoding="UTF-8"?

    > <!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0.3//EN" "http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd"> <validators> <field name="username"> <field-validator type="requiredstring"> <param name="trim">true</param> <message>用户名不能为空!</message> </field-validator> </field> <field name="mobile"> <field-validator type="requiredstring"> <message>手机号不能为空!</message> </field-validator> <field-validator type="regex"> <param name="expression"><![CDATA[^1[358]d{9}$]]></param> <message>手机号格式不对!</message> </field-validator> </field> </validators>


    3、基于XML校验的一些特点

    当为某个action提供了ActionClassName-validation.xml和ActionClassName-ActionName-validation.xml两种规则的校验文件时。系统按以下顺序寻找校验文件:
    1。

    AconClassName-validation.xml
    2。

    ActionClassName-ActionName-validation.xml
    系统寻找到第一个校验文件时还会继续搜索后面的校验文件,当搜索到全部校验文件时。会把校验文件里的全部校验规则汇总,然后全部应用于action方法的校验。假设两个校验文件里指定的校验规则冲突。则仅仅使用后面文件里的校验规则。

    当action继承了还有一个action,父类action的校验文件会先被搜索到。

    如果UserAction继承BaseAction:
    <action name="user" class="cn.itcast.action.UserAction" method="{1}">
    </action>

    訪问上面action,系统先搜索父类的校验文件:BaseAction-validation.xml, BaseAction-user-validation.xml,接着搜索子类的校验文件: UserAction-validation.xml, UserAction-user-validation.xml。应用于上面action的校验规则为这四个文件的总和。


    注:转载请注明出处。



  • 相关阅读:
    OutputCache详解
    C#数值类型的转换
    C#变量类型转换
    C#和.net
    数组
    mvc
    C#部分基础知识
    项目开发-->高级功能汇总
    项目开发-->基础功能汇总
    C#基础篇
  • 原文地址:https://www.cnblogs.com/yxwkf/p/5105834.html
Copyright © 2020-2023  润新知