Struts 2之校驗器
validate()方法
支持校驗的Action必須實現Validateable接口,一般直接繼承ActionSupport就可以了
public void validate() {//會對所有的Action起作用
if(username == null ||"".equals(this.username.trim())){
this.addFieldError("username", "用戶名不能為空");
}
if(mobile == null ||"".equals(this.mobile.trim())){
this.addFieldError("mobile","手機號不能為空") ;
}else{
if(!Pattern.compile( "^1[3,5,8]\\d{9}$").matcher(this.mobile).matches()){
this.addFieldError("mobile", "手機號格式不正確");
}
}
super.validate();
}
public void validateUpdate(){ //假設此Action有個名為update()的方法
//只對update()方法進行校驗validateXxx,方法名第一個必須大寫
if(username == null ||"".equals(this.username.trim())){
this.addFieldError("username", "用戶名不能為空");
}
if(mobile == null ||"".equals(this.mobile.trim())){
this.addFieldError("mobile", "手機號不能為空");
}else{
if(!Pattern.compile("^1[3,5,8]\\d{9}$").matcher(this.mobile).matches()){
this.addFieldError("mobile","手機號格式不正確") ;
}
}
super.validate() ;
}
對這些錯誤信息,在JSP頁面可以使用標簽<s:fielderror/>來顯示
基于XML的校驗方式
基于XML方式實現校驗時,Action類也需要繼承ActionSupport類,并且提供校驗文件,校驗文件同Action類放在一個包內,文件的取名格式為:ActionClassName-validation.xml,其中ActionClassName為Action類的簡單名字
<!DOCTYPEvalidators PUBLIC
"-//OpenSymphony Group//XWorkValidator 1.0.3//EN"
"http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd">
<validators>
<fieldname="username">
<field-validatortype="requiredstring">
<paramname="trim">true</param>
<message>用戶名不能為空</message>
</field-validator>
</field>
<field name="mobile">
<field-validator type="requiredstring">
<paramname="trim">true</param>
<message>手機號不能為空</message>
</field-validator>
<field-validatortype="regex">
<paramname="expression"><![CDATA[^1[358]\d{9}$]]></param>
<message>手機號格式不正確</message>
</field-validator>
</field>
</validators>
Struts 2常用內置校驗器
位于xwork-2.0.4.jar壓縮包中(com.opensymphony.xwork2.validator.validators)有個文件default.xml ,該文件中定義了Struts2框架內建的校驗器。default.xml文件定義了常用的校驗器類型。
1、類型轉換檢驗器:
(1)非字段校驗:
<validator type="conversion">
<param name="fieldName">myField</param>
<message>類型轉換錯誤</message>
<param name="repopulateField">true</param>
</validator>
(2)字段校驗:
<field name="myField">
<field-validator type="conversion">
<message>類型轉換錯誤</message>
<param name="repopulateField">true</param>
</field-validator>
</field> fieldName:該參數指定檢查是否存在轉換異常的字段名稱,如果是字段校驗,則不用指定該參數。
repopulateField:該參數指定當類型轉換失敗后,返回input頁面時,類型轉換失敗的表單是否保留原來的錯誤輸入。true為保留,false為不保留。
2、日期校驗器:
(1)非字段校驗:
<validator type="date">
<param name="fieldName">birthday</param>
<param name="min">1990-01-02</param>
<param name="max">2010-07-28</param>
<message>生日數據錯誤</message>
</validator> (2)字段校驗:
<field name="birthday">
<field-validatortype="date">
<param name="min">1990-01-01</param>
<param name="max">2010-07-28</param>
<messagekey="error.birthday"></message>
</field-validator>
</field> min:指定字段日期值的最小值,該參數為可選參數。
max:指定字段日期值的最大值,該參數為可選參數。
3、浮點數值校驗器:
(1)非字段校驗:
<validator type="double">
<param name="fieldName">percentage</param>
<param name="minInclusive">20.1</param>
<param name="maxInclusive">50.1</param>
<message>生日數據錯誤</message>
</validator>
(2)字段校驗:
<field name="percentage">
<field-validatortype="double">
<param name="minInclusive">20.1</param>
<param name="maxInclusive">50.1</param>
<message key="error.percentage"></message>
</field-validator>
</field> minInclusive|minExclusive:指定字段的最小值,包含該值|不包含該值。
maxInclusive|maxExclusive:指定字段的最大值, 包含該值|不包含該值。
4、郵件地址校驗器:
(1)非字段校驗:
<validator type="email">
<param name="fieldName">MyEmail</param>
<message>非法的郵件地址</message>
</validator> (2)字段校驗:
<field name="MyEmail">
<field-validator type="email">
<message>非法的郵件地址</message>
</field-validator>
</field>
5、表達式校驗器:
<validator type="expression">
<param name="expression">.......</param>
<message>Failed to meet OgnlExpression...</message>
</validator>
expression:該參數為一個邏輯表達式,該參數使用OGNL表達式,并基于值棧計算,返回一個Boolean類型值。
6、字段表達式校驗器:
(1)非字段校驗:
<validator type="fieldexpression">
<param name="fieldName">myField</param>
<param name="expression"><![CDATA[#myCreditLimit >#myGirfriendCreditLimit]]></param>
<message>My credit limit shouldbe MORE than my girlfriend</message>
</validator> (2)字段校驗:
<field name="myField">
<field-validatortype="fieldexpression">
<param name="expression"><![CDATA[#myCreditLimit >#myGirfriendCreditLimit]]></param>
<message>My credit limitshould be MORE than my girlfriend</message>
</field-validator>
</field>
7、整數校驗器:
(1)非字段校驗:
<validator type="int">
<param name="fieldName">age</param>
<param name="min">10</param>
<param name="max">100</param>
<message>年齡必須在在${min}到${max}之間</message>
</validator> (2)字段校驗:
<field name="age">
<field-validator type="int">
<param name="min">10</param>
<param name="max">100</param>
<message>年齡必須在在${min}到${max}之間</message>
</field-validator>
</field>
8、正則表達式校驗器:
(1)非字段校驗:
<validator type="regex">
<param name="fieldName">myStrangePostcode</param>
<param name="expression"><![CDATA[([aAbBcCdD][123][eEfFgG][456])]></param>
</validator>
(2)字段校驗:
<field name="myStrangePostcode">
<field-validator type="regex">
<param name="expression"><![CDATA[#myCreditLimit >#myGirfriendCreditLimit]]></param>
<message>My credit limitshould be MORE than my girlfriend</message>
</field-validator>
</field>
expression:為必選參數,指定匹配有的表達式。
caseSensitive:指明進行匹配時,是否區分大小寫,為可選參數,默認為true。
9、必填校驗器:
(1)非字段校驗:
<validator type="required">
<param name="fieldName">username</param>
<message>用戶名不能為空</message>
</validator> (2)字段校驗:
<field name="username">
<field-validator type="required">
<message>用戶名不能為空</message>
</field-validator>
</field>
10、必填字符串校驗器:
(1)非字段校驗:
<validator type="requiredstring">
<param name="fieldName">username</param>
<param name="trim">true</param>
<message>用戶名不能為空</message>
</validator>
(2)字段校驗:
<field name="username">
<field-validato rtype="requiredstring">
<param name="trim">true</param>
<message>用戶名不能為空</message>
</field-validator>
</field> trim:可選參數,用于指定是否在校驗之前對字符串進行整理,默許為true。
11、字符串長度校驗器:
(1)非字段校驗:
<validator type="stringlength">
<param name="fieldName">username</param>
<param name="minLength">4</param>
<param name="maxLength">10</param>
<message>用戶名長度在${minLength}到${maxLength}之間</message>
</validator> (2)字段校驗:
<field name="username">
<field-validato rtype="stringlength">
<param name="minLength">4</param>
<param name="maxLength">10</param>
<param name="trim">true</param>
<message key="error.length.username"></message>
</field-validator>
</field>
12、網址校驗器:
(1)非字段校驗:
<validator type="url">
<param name="fieldName">myHomePage</param>
<message>Invalid homepageurl</message>
</validator> (2)字段校驗:
<field name="myHomePage">
<field-validator type="url">
<message>Invalid homepageurl</message>
</field-validator>
</field>
13、visitor校驗器:
該校驗器名稱為:visitor,用來校驗Action中定義的復合類型屬性,支持簡單的復合類型、數組類型、Map等集合類型。
(1)非字段校驗:
<validator type="visitor">
<param name="fieldName">user</param>
<param name="context">myContext</param>
<param name="appendPrefix">true</param>
</validator>
(2)字段校驗:
<field name="user">
<field-validator type="visitor">
<param name="context">myContext</param>
<param name="appendPrefix">true</param>
</field-validator>
</field>
如果想自定義一個自己的校驗器,可以在Web工程的WEB-LIB\lib目錄下增加一個validators.xml配置文件,在該文件中定義自己的校驗器。
注意:如果使用validators.xml配置文件,則系統默認的default.xml配置文件不會加載,所以需要將default.xml的內容復制到validators.xml配置文件中。否則不能使用系統內建的校驗器。