struts2-輸入校驗

Struts2中的多個驗證方法的共存細節一
在Struts2中默認的,使用validateAbc()作爲abc()的驗證方法
所以,如果還存在xyz()方法的話,那麼它的驗證方法就是validateXyz()方法
執行時,首先執行validateAbc()方法
而無論validateAbc()方法執行後的結果如何,都會去執行validate()方法
也就是說,如果一個Action中提供validate()方法的話,那麼它是一定會被執行的
執行完validate()之後,如果沒有發現存在Field或者Action級別的ERROR的話
那麼纔會執行相應的業務邏輯的方法,如abc()方法


Struts2中的多個驗證方法的共存細節二
很顯然這種機制不是很合理。因爲不同的業務邏輯存在着不同的驗證方式
如果不同的驗證方式驗證完之後,還要去驗證一下validate()的話,顯然這是不合理的
這種情況下有兩種解決的策略
1..不再複寫validate()方法,由於父類的validate()方法的方法體是空的
    儘管它也會被調用,但是它什麼也不會做,不會對我們的程序造成任何影響
2..重命名validate()方法,即命名爲validateExecute()
    所以本例若需執行execute()的話,則可通過validateExecute()驗證表單


提示Struts2的默認錯誤信息
如果intlong發生類型轉換錯誤的話,Struts2會將該屬性值自動設爲零
如果String發生類型轉換錯誤的話,它會將該屬性值自動設爲null
但若前臺頁面輸入的age是字符串的話,那麼它是無法轉換成int型的
這時在前臺頁面就會提示Invalid field value for field "age".信息
在這個錯誤提示信息中的age對應的是前臺頁面中<input name="">爲age的值
這是因爲Struts2在遇到類型轉換錯誤的時候,也就是說無法進行類型轉換的時候
struts2框架會自動生成一條錯誤信息,並將該錯誤信息放到addFieldError()
然後就可以通過全局或局部的國際化資源轉換文件來自定義更爲人性化的錯誤提示信息
然後就可以在前臺使用<s:fielderror/>標籤輸出資源文件中自定義的錯誤提示信息
另外,在Struts1.x中若想在頁面中提示關於表單填寫的信息,則要增加<html:errors/>標籤


全局的國際化資源轉換文件自定義Struts2提示的錯誤信息
類型轉換出現錯誤時Struts2中的conversionError攔截器負責將錯誤封裝成表單錯誤中的Fielderror
xwork-2.0.4.jar中的com.opensymphony.xwork2包裏面有一個xwork-messages.properties文件
將它裏面的xwork.default.invalid.fieldvalue屬性在資源文件中覆蓋就可以輸出人性化的信息了
在struts.xml中配置了message.properties之後,就可以建立該文件了
建好後輸入xwork.default.invalid.fieldvalue = {0} error
由於是進行資源轉換,所以xwork.default.invalid.fieldvalue寫法是固定的
{0}則對應前臺頁面中<input name="">裏面的name值
比如在age輸入域中輸入字符串之後,就會提示age error
如果在birthday輸入域中輸入字符串的話,同樣會提示birthday error


局部的國際化資源轉換文件
全局的資源文件有些時候並不是特別好用,因爲它顯示的效果過於單一枯板
而Struts2也已經認識到了這一點,因此它又給我們提供了使用局部的資源文件的方式
局部的國際化資源轉換文件也是在項目開發中使用的最多的
雖然它顯得比較麻煩,但是它能夠爲用戶提供一種更友好的視圖表現方式
局部的資源文件必須與它所要驗證的類在同一個目錄下,並且要與類同名
比如驗證RegisterAction的某些屬性,那麼它必須與RegisterAction位於同一目錄下
並且的它名字也必須是RegisterAction.properties,然後編輯它的內容
比如相對於age屬性來說invalid.fieldvalue.age = age conversion error
其中invalid.fieldvalue.是固定的後面跟RegisterAction類中的屬性
所以這句話的意思就是:當age發生類型轉換錯誤時,則顯示age conversion error信息
並且局部的先級要高於全局的國際化資源轉換文件,所以將優先顯示局部資源文件中的提示信息



 

下面是示例工程,這是一個Struts2.0.11應用

首先是web.xml文件

  1. <?xml version="1.0" encoding="UTF-8"?>  
  2. <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"  
  3.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
  4.     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee   
  5.     http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">  
  6.     <filter>  
  7.         <filter-name>struts2</filter-name>  
  8.         <filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class>  
  9.     </filter>  
  10.     <filter-mapping>  
  11.         <filter-name>struts2</filter-name>  
  12.         <url-pattern>/*</url-pattern>  
  13.     </filter-mapping>  
  14.     <welcome-file-list>  
  15.         <welcome-file>validateInput.jsp</welcome-file>  
  16.     </welcome-file-list>  
  17. </web-app>  

然後是用於提供表單輸入的validateInput.jsp頁面

  1. <%@ page language="java" pageEncoding="UTF-8"%>  
  2. <%@ taglib prefix="s" uri="/struts-tags"%>  
  3.   
  4. <s:fielderror cssStyle="font-size:20px;color:red;text-align:left;font-weight:bold"/>  
  5.   
  6. <s:form action="validateInput" theme="simple">  
  7.     <table border="9">  
  8.         <tr>  
  9.             <td>姓名</td>  
  10.             <td><s:textfield name="username"/></td>  
  11.         </tr>  
  12.         <tr>  
  13.             <td>密碼</td>  
  14.             <td><s:password name="password"/></td>  
  15.         </tr>  
  16.         <tr>  
  17.             <td>重複密碼</td>  
  18.             <td><s:password name="repassword"/></td>  
  19.         </tr>  
  20.         <tr>  
  21.             <td>年齡</td>  
  22.             <td><s:textfield name="age"/></td>  
  23.         </tr>  
  24.         <tr>  
  25.             <td>出日</td>  
  26.             <td><s:textfield name="birthday"/></td>  
  27.         </tr>  
  28.         <tr>  
  29.             <td>畢業時間</td>  
  30.             <td><s:textfield name="graduation"/></td>  
  31.         </tr>  
  32.         <tr>  
  33.             <td>&nbsp;</td>  
  34.             <td><s:submit value="輸入校驗"/></td>  
  35.         </tr>  
  36.     </table>  
  37. </s:form>  
  38. <!--  
  39. ================================================================================================  
  40. 也可以使用普通<form/>替代<s:form/>來編寫上面的第6--37行的表單內容,一樣可以實現相同的功能  
  41. ================================================================================================  
  42. 【類型轉換與輸入校驗的流程】  
  43. 1. 首先Struts2對客戶端傳來的數據進行類型轉換  
  44. 2. 類型轉換完畢後再進行輸入校驗  
  45. 3. 如果類型轉換和輸入校驗都沒有錯誤發生,那麼進入execute方法,調用商業邏輯  
  46. 注意:如果類型轉換不成功,也同樣要進行輸入校驗  
  47. ================================================================================================  
  48. 幾乎Struts2的每一個標籤都有它的theme屬性  
  49. 如果未設置該屬性的話,在運行時Struts2會自動生成表格,這樣不便於排版  
  50. 我們可以通過設置標籤的theme="simple"屬性使得它不自動生成表格  
  51. 這是很重要的一個屬性,有了它就可以很方便的佈局了  
  52. ================================================================================================  
  53. theme="simple"】  
  54. 當將<s:form/>設置爲theme="simple"時,它的子標籤也就不會自動生成表格了  
  55. 而且此時<s:form/>中的自動輸出FieldError信息的功能就會失效  
  56. 這時我們可以在頁面中添加<s:fielderror/>或者<s:actionerror/>標籤來統一顯示錯誤信息  
  57. 並且這個時候所顯示的錯誤提示信息中,總會在前面出現一個黑色圓點  
  58. 如果想把這個圓點去掉的話,是一件比較困難的事情  
  59. 可以查看struts2-core-2.0.11.jar中的template.simple中的fielderror.ftl  
  60. 打開這個模板之後可以發現,我們頁面顯示的信息都是由這個模板定義的  
  61. 我們也可以手工寫這個模板,但這將會是一件相當困難的事情  
  62. 如果想把這個黑色圓點去掉的話,就只能修改這個模板,不過挺困難的,很不好改  
  63. 一般情況下都不會去手動的寫這個模板,我們多數都是參考已有模板,然後對其稍稍加工  
  64. ================================================================================================  
  65. -->  

當表單輸入域均正確時顯示的validateSuccess.jsp頁面

  1. <%@ page language="java" pageEncoding="UTF-8"%>  
  2. <%@ taglib prefix="s" uri="/struts-tags"%>  
  3. 姓名:<s:property value="username"/><br/>  
  4. 密碼:<s:property value="password"/><br/>  
  5. 年齡:<s:property value="age"/><br/>  
  6. 生日:<s:property value="birthday"/><br/>  
  7. 畢業:<s:property value="graduation"/>  

然後是struts.xml文件

  1. <?xml version="1.0" encoding="UTF-8"?>  
  2. <!DOCTYPE struts PUBLIC   
  3.     "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"  
  4.     "http://struts.apache.org/dtds/struts-2.0.dtd">  
  5. <struts>  
  6.     <constant name="struts.custom.i18n.resources" value="message"/>  
  7.     <package name="struts2" extends="struts-default">  
  8.         <action name="validateInput" class="com.jadyer.action.ValidateInputAction" method="abc">  
  9.             <result>/validateSuccess.jsp</result>  
  10.             <result name="input">/validateInput.jsp</result>  
  11.         </action>  
  12.     </package>  
  13. </struts>  

用到的核心驗證邏輯的ValidateInputAction.java

  1. package com.jadyer.action;  
  2.   
  3. import java.util.Calendar;  
  4. import java.util.Date;  
  5.   
  6. import com.opensymphony.xwork2.ActionSupport;  
  7.   
  8. @SuppressWarnings({"serial""unused"})  
  9. public class ValidateInputAction extends ActionSupport {  
  10.     private String username;  
  11.     private String password;  
  12.     private String repassword;  
  13.     private int age;  
  14.     private Date birthday;  
  15.     private Date graduation;  
  16.       
  17.     /* 以上六個屬性對應的setter和getter略 */  
  18.   
  19. //  /**  
  20. //   * INPUT頁面中需要添加<s:actionerror/>標籤方可顯示此處的錯誤消息  
  21. //   */  
  22. //  public String abc() throws Exception {  
  23. //      if(null==username || username.trim().equals("")){  
  24. //          this.addActionError("用戶名不能爲空");  
  25. //      }else if(!Pattern.matches("^[a-zA-Z][a-zA-Z0-9_]{3,14}$", username)){  
  26. //          this.addActionError("用戶名必須以字母開始,後面跟字母、數字或下劃線,且長度必須爲4--15位");  
  27. //      }  
  28. //      if(null==password || password.equals("")){  
  29. //          this.addActionError("密碼不能爲空");  
  30. //      }else if(!Pattern.matches("^[a-zA-Z0-9@#]{4,15}$", password)){  
  31. //          this.addActionError("密碼可以由 字母、數字、@、# 組成,且長度必須爲4--15位");  
  32. //      }  
  33. //      if(this.hasActionErrors()){  
  34. //          return INPUT; //如果在驗證的過程中,發現用戶輸入的內容不合理,則返回輸入頁面  
  35. //      }  
  36. //      return SUCCESS;  
  37. //  }  
  38.       
  39.     public String abc() throws Exception {  
  40.         return SUCCESS;  
  41.     }  
  42.       
  43.     /** 
  44.      * public void addFieldError(String fieldName, String errorMessage) 
  45.      * 第一個參數是頁面中表單裏的輸入域的name值,如<input/>或<s:textfield/>等等 
  46.      * 第二個參數是提示信息。這個提示信息顯示在第一個參數所對應的字段的正上方居中位置 
  47.      * 若頁面中提供了<s:fielderror/>標籤,那麼在<s:fielderror/>的位置就會顯示相應的提示信息 
  48.      */  
  49.     public void validateAbc() {  
  50.         if (null == username || username.length() < 6 || username.length() > 10) {  
  51.             this.addFieldError("username""用戶名不能爲空,且長度必須爲6--10位");  
  52.         }  
  53.         if (null == password || password.length() < 6 || password.length() > 10) {  
  54.             this.addFieldError("password""密碼不能爲空,且長度必須爲6--10位");  
  55.         } else if (null == repassword || repassword.length() < 6 || repassword.length() > 10) {  
  56.             this.addFieldError("repassword""重複密碼不能爲空,且長度必須爲6--10位");  
  57.         } else if (!password.equals(repassword)) {  
  58.             this.addFieldError("password""輸入的重複密碼與設定密碼不一致");  
  59.         }  
  60.         if (null != birthday && null != graduation) {  
  61.             Calendar c1 = Calendar.getInstance();  
  62.             c1.setTime(birthday);  
  63.             Calendar c2 = Calendar.getInstance();  
  64.             c2.setTime(graduation);  
  65.             if (!c1.before(c2)) {  
  66.                 this.addFieldError("birthday","出生日期應該在畢業時間的前面");  
  67.             }  
  68.         }  
  69.     }  
  70. }  

用到的局部的國際化資源轉換文件ValidateInputAction.properties

  1. invalid.fieldvalue.age        = /u5E74/u9F84/u5E94/u8BE5/u662F/u4ECB/u4E8E 1 /u5230 100 /u4E4B/u95F4/u7684/u6B63/u6574/u6570  
  2. invalid.fieldvalue.birthday   = /u51FA/u751F/u65E5/u671F/u8F93/u5165/u6709/u8BEF  
  3. invalid.fieldvalue.graduation = /u6BD5/u4E1A/u65F6/u95F4/u8F93/u5165/u6709/u8BEF  

用到的全局的國際化資源轉換文件message.properties

  1. xwork.default.invalid.fieldvalue = {0} /u8F93/u5165/u6709/u8BEF  

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章