Tapestry 5輸入驗證的實現方法
表單輸入與驗證
表單輸入是任何應用的生命之血；這是一種從用戶收集有用信息的最有效的方式。不管它是一個搜索表單、一個登錄還是一個多頁的注冊向導，用戶借助表單在應用中真正地表達他們。
Tapestry 5輸入驗證在創建和驗證輸入有很好的表現。輸入驗證是聲明式的，意味首我們簡單地告訴Tapestry一個表單域應用哪種驗證，然后Tapestry會在服務器端（已實現）與客戶端維護這種驗證。
最后，Tapestry不僅能夠將錯誤的信息表現給用戶，而且還能對表單域及其標注（labels）進行裝飾，標記它們包含錯誤（主要利用CSS效果）。
表單組件
Tapestry的表單支持的核心即是表單組件，表單組件封裝著其他所有表單域組件，如TextField、TextArea、Checkbox等等。
表單組件產生許多組件事件，我們可以給其提供事件處理方法。
呈現時，表單組件發出一個“prepare”通知，以使表單容器創建將要在表單中引用的表單域或屬性。如，這是一個創建被呈現的臨時實體對像或者載入一個源自數據庫的可被編輯的實體的好機會。
在Tapestry 5輸入驗證中，當用戶在客戶端提交表單時，服務器端會執行一系列的步驟。
首先，表單呈現時會發出一個“prepare”通知。
其次，所有的表單域被激活并將從請求中得到相應的值，驗證它們及（如果有效）保存現有的變化。
對Tapestry 4的用戶：Tapestry 5不使用Tapestry 4中脆弱的表單刷新（form rewind）方法，而是在表單呈現時產生一個存放是否需要處理表單提交信息的隱藏域。
表單域流程處理完后，表單發出一個“validate”事件，這是一個執行跨表單驗證（還不能公布其詳情）的機會。
然后，表單確定是否存在任何Tapestry 5輸入驗證錯誤。如果存在，表單提交失敗并發出一個"failure"事件。如果沒有驗證錯誤，些時將發出一個"success"事件。
最后，表單發出一個"submit"事件（邏輯上，它不考慮成功與否）。
跟蹤驗證錯誤
一個與表單關聯的就是驗證跟蹤器（ValidationTracker），它跟蹤著表單域對應的所有的用戶輸入與用戶驗證錯誤。跟蹤器可以通過跟蹤器參數提供給表單，不過很少用到。
表單（Form）包括兩個isValid() 和 getHasErrors()方法，用來查看表單驗證跟蹤器是否存在任何錯誤。
在我們的邏輯中，我們可以記錄驗證錯誤。表單（Form）包括兩個不同版本的recordError()方法，一個是指定一個表單域（Field，一個被所有表單元素組件實現的接口），另外一個是全局驗證錯誤（"global" errors），與具體的表單域無關。
在請求間保存數據
因為其他的動作請求，表單提交的結果會向客戶端發出一個重定向來重新呈現頁面。驗證跟蹤器必須在請求間被持久化地（persistently）保存下來，否則所有的Tapestry 5輸入驗證信息會丟失（表單提供一個persisten形式的默認驗證跟蹤器）。
同樣地，組件更新單獨的表單域也應該被持久化。
比如，一個用來收集用戶名與密碼的登錄頁面，應該如下：
- public class Login
- {
- @Persist
- private String _userName;
- private String _password;
- @Inject
- private UserAuthenticator _authenticator;
- @Component(id = "password")
- private PasswordField _passwordField;
- @Component
- private Form _form;
- String onSuccess()
- {
- if (!_authenticator.isValid(_userName, _password))
- {
- _form.recordError(_passwordField, "Invalid user name or password.");
- return null;
- }
- return "PostLogin";
- }
- public String getPassword()
- {
- return _password;
- }
- public void setPassword(String password)
- {
- _password = password;
- }
- public String getUserName()
- {
- return _userName;
- }
- public void setUserName(String userName)
- {
- _userName = userName;
- }
- }
因為Form表單提交實際上是兩個請求（提交自己，然后重新呈現頁面），所以需要在兩個請求間持久化保存在_userName屬性里的值。屬性_password同樣需要，除非PasswordField組件從不呈現值。
注意onSuccess()方法不是公共的（public）；事件處理方法可以具有任何的可見性，甚至私有的。包可見性（即無可見性修飾）比較常用，這時它允許組件可被相同包下的測試用例類測試。
假如Form先前沒有存在驗證錯誤，它僅產生一個"success"事件，這意味著沒有必要在方法的第一行寫上if (_form.getHasErrors()) return;這樣的語句。
最后，注意業務邏輯如何與表單驗證相關聯。UserAuthenticator服務用來保證userName 和 (文本的) password的有效性。當它返回false時，我們用Form組件來記錄一個錯誤。我們提供一個PasswordField實例作為它的第一個參數，這保證了密碼表單域和它的標注（label）會在Form表單重新呈現時被修飾以表現錯誤給用戶看。
Tapestry 5輸入驗證的配置表單域及標注
頁面模板包含少量的Tapestry 標識（instrumentation）：
- ﹤html xmlns:t="http://tapestry.apache.org/schema/tapestry_5_0_0.xsd"﹥
- ﹤head﹥
- ﹤title﹥Login﹤/title﹥
- ﹤/head﹥
- ﹤body﹥
- ﹤h1﹥Please Login﹤/h1﹥
- ﹤t:form﹥
- ﹤t:errors/﹥
- ﹤t:label for="userName"/﹥:
- ﹤input t:type="TextField" t:id="userName" t:validate="required,minlength=3" size="30"/﹥
- ﹤br/﹥
- ﹤t:label for="password"/﹥:
- ﹤input t:type="PasswordField" t:id="password" t:validate="required,minlength=3" size="30"/﹥
- ﹤br/﹥
- ﹤input type="submit" value="Login"/﹥
- ﹤/t:form﹥
- ﹤/body﹥
- ﹤/html﹥
Tapestry的Form組件負責創建form表單提交所需的URL（這個Tapestry的責任，不是你的）。
Errors組件必須放在Form里，它將Form組件里表單域的所有錯誤信息作為一個列表輸出，并應用一此簡單的樣式使得結果更顯眼。
每一個表單域組件，比如TextField，與Label組件成對。Label將呈現一個與表單域相連的＜label＞元素。這個組件對方便使用非常重要，特別對那些有視覺障礙（殘疾）的用戶。它意味著你可以能過點擊標注（label）文本將光標移動到相應的表單域中。Label組件的for參數即是一組件的id。
對于TextField，我們提供了一個組件id為userName。我們可以指定一個value參數，默認情況下這個value參數是匹配TextField的id，TextField的id又對應于組件容器（Login頁）的一個屬性（假如這個屬性存在）。
根據經驗，你通常應該為表單域指定一個特定的id（這個id將會被用來呈現標簽的name與id屬性）。允許省略value參數有利于防止模板變得更加混亂。
用來驗證表單域的validate參數標識，是一個驗證器的名字列表。驗證器在Tapestry中被配置，可用的驗證器都是可擴展的。"required"是一個內置驗證器的名字，用以保證提交的值不為空串，此外，"minlen"用來保證值具有最小的指定長度。
Validate參數用t:前綴被放置在Tapestry的命名空間里。這不是嚴格需要的，只是讓模板有個良好的格式。然而，在Tapestry命名空間放置Tapestry特定的值保證了模板的有效性。
錯誤及修飾Errors and Decorations
注意：這部分并沒有更新到涉及客戶端驗證的介紹。
在Tapestry 5輸入驗證中，當你第一次激活Login頁里，表單域及表單會被正常呈現等待輸入：
注意這里的Label組件怎樣顯示表單域的文本名字。我們未曾做過任何顯式地配置，組件的id （"User Name" 和 "Password"）已經轉換成"User Name" 和 "Password"，倒底發生了什么？。
如果你就這樣提交了表單，表單域就會違反了"required"約束，頁面將會重新顯示以呈現給用戶錯誤信息。
這里有兩個微妙事情，首先，Tapestry跟蹤了所有表單域的所有錯誤信息，Errors組件顯示在表單的最頂端；其次，默認的驗證修飾給標注（labels）和表單域的class屬性加上了t-error CSS樣式。Tapestry提供了默認的t-error CSS樣式使得它們變紅。
接下來，我們將在user name欄上填值，但不給password欄提供足夠的字符：User name欄正常，僅password欄有一個錯誤存在。PasswordField組件默認下通常顯示一空值，另外我們會看到僅password顯示在…
如果你輸入了足夠的字符后提交，我們會看到Login頁面是如何將邏輯錯誤加入到表單域的錯誤里：
這真是天衣無縫，基于應用的邏輯錯誤看起來感覺就像內置驗證器的行為。
【編輯推薦】
