處理命令：當控制器需要根據參數執行工作時，應該繼承命令控制器，如AbstractCommandController（見PPT7）這個控制器會自動將參數綁定到命令對象中，并且提供了插入驗證器的鉤子，確保參數合法性。下面顯示了RantsForVehicleController，一個用于顯示特定車輛已有投訴列表的命令控制器。
public class RantsForVehicleController extends AbstractCommandController{
public RantsForVehicleController() {
setcommandClass(Vehicle.class);
setCommandName("vehicle");
}
protected ModelAndView handle(HttpServletRequest request,HttpServletResponse,Object command,
BindException errors) throws Exception {
Vehicle vehicle = (Vehicle) command;
List vehicleRants = rantService.getRantsForVehicle(vehicle);
Map model =errors.getModel();
model.put("rants", rantService.getRantsForVehicle(vehicle));
model.put("vehicle", vehicle);
return new ModelAndView("vehicleRants",model);
}
private RantService rantService;
public void setRantService(RantService rantService) {
this.rantService = rantService;
}
}
一個命令對象是一個為了簡化對請求參數訪問而設計的Bean。一個Spring命令對象是一個POJO，它不需要實現任何Spring的特定類。你需要在roadrantz-servlet.xml文件中注冊RantsForVehicleController
<bean id="rantsForVehicleController" class="com.roadrantz.mvc.RantsForVehicleController">
<property name="rantService" ref="rantService"/>
</bean>
處理表單提交：表單控制器比命令控制器前進了一步，（見PPT8）它在接收到HTTP GET請求的時候顯示一個表單，接收到一個HTTP POST請求的時候處理這個表單。另外，在處理過程中如果發生錯誤的話，這個控制器會知道重新顯示這個表單，這樣用戶就可以修改錯誤，重新提交。為了顯示表單控制器是如何工作的，考慮以下程序中的AddRantFormController。
public class AddRantFormController extends SimpleFormController {
private static final String[] ALL_STATES = {"AL","AK","AZ"};
public AddRantFormController() {
setCommandClass(Rant.class);
setCommandName("rant");
}
protected Object formBackingObject(HttpServletRequest request) throws Exception {
Rant rantForm = (Rant)super.formBackingObject(request);
rantForm.setVehicle(new Vehicle());
}
protected Map referenceDate(HttpServletRequest request) throws Exception{
Map referenceData = new HashMap();
referenceDate.put("states",ALL_STATES);
return referenceData;
}
protected ModelAndView onSumbit(Object command,BindException bindException)throws Exception{
Rant rant = (Rant)command;
rantService.addRant(rant);
return new ModelAndView(getSuccessView());
}
private RantService rantService;
public void setRantService(RantService rantService) {
this.rantService = rantService;
}
}雖然referenceData()方法是可選的，但是如果需要為 顯示表單提供其他附加的信息，則可以使用這個方法。在正常的情況下，返回表單的命令對象一般是一個簡單的命令類實例。不過對于AddRantFormController,Rant實例不會完成這項工作。表單會使用內嵌的Vehicle屬性作為表單返回對象的一部分。因此，需要覆蓋fromBackingObject()方法，以便設置vehicle屬性。否則，在控制器視圖綁定state和plateNumber屬性時，會拋出NullPointerException異常。
那么控制器是如何知道顯示投訴輸入表單的。如果投訴輸入成功，用戶將到什么頁面也不是很清楚。唯一的線索是對getSuccessView(）的調用結果會提交給ModelAndView。但是，提交成功的視圖又從哪里來呢？SimpleFormController被設計成盡量將視圖詳細信息放在控制器代碼之外。不是將ModelAndView對象硬編碼進來，而是像下面這樣在上下文配置文件中配置控制器：
<bean id="addRantController" class="com.roadrantz.mvc.AddRantFormController">
<property name="formView" value="addRant" />
<property name="successView" value="rantAdded" />
<property name="rantService" ref="rantService" />
</bean> formView屬性是控制器接收到HTTP GET請求或有任何錯誤發生時需要顯示的視圖的邏輯名。同樣，successView是提交的表單成功處理后要顯示的視圖的邏輯名。
驗證表單輸入：org.springframework.validation.Validator接口為Spring MVC提供了驗證功能，定義如下：
public interface Validator {
void validate(Object obj , Errors errors);
boolean supports(Class clazz);
}這個接口的實現必須驗證傳遞給validate()方法的對象的字段，用Errors對象駁回任何非法數據。supports()方法用于幫助Spring判斷該驗證器是否可以用于指定類。 以下是一個用于驗證Rant對象的Validator實現。
public class RantValidator implements Validator {
public boolean supports(Class clazz){
return clazz.equals(Rant.class);
}
public void validate(Object command, Errors errors) {
Rant rant = (Rant) command;
ValidationUtils.rejectIfEmpty(errors,"vehicle.state","required.state","State is required");
ValidationUtils.rejectIfEmptyOrWhitespace(errors, "rantText", "required.rantText","You must enter some rant text.");
validatePlateNumber(rant.getVehicle().getPlateNumber(),errors);
}
private static final String PLATE_REGEXP = "/[a-z0-9]{2,6}/i";
private void validatePlateNumber(String plateNumber,Errors errors) {
Per15Util per15Util = new Per15Util();
if(!per15Util.match(PLATE_REGEXP,plateNumber)){
errors.reject("invalid.plateNumber","Invalid license plate number.");
}
}
}還有一件事情要做，就是讓AddRantFormController使用RantValidator。你可以將一個RantValidator Bean裝配到AddRantFormController Bean中：
<bean id="addRantController" class="com.roadrantz.mvc.AddRantFormController">
<property name="formView" value="addRant"/>
<property name="successView" value="rantAdded"/>
<property name="rantService" ref="rantService"/>
<property name="validator">
<bean class="com.roadrantz.mvc.RantValidator"></bean>
</property>
</bean>通過實現Validation接口，可以通過程序完全控制應用程序命令對象的驗證。如果需要復雜的驗證和特殊的邏輯，利用這項功能將會十分方便。對于簡單的情況，例如保證填入需要的字段并按照基本格式，編寫自己的Validator接口就有點麻煩了。聲明性驗證是一個不錯的選擇。
利用命令驗證器進行驗證：在我們深入研究用于實現聲明性Validator的Spring JavaDoc之前，需要知道Spring并不提供這樣的驗證器。Spring沒有提供任何Validator接口的實現，而是將這個任務留給了程序員。 不過Spring Modules項目(http://springmodules.dev.java.net)是Spring的一個姊妹項目，提供了幾個對Spring的擴展。其中一個是使用Jakarta Commons Validator(http://jakarta.apache.org/commons/validator)提供的聲明性驗證的驗證模塊。
要使用驗證模塊，首先需要添加springmodules-validator,jar 如果使用Ant建立應用程序，需要下載Spring Modules發行包，找到spring-modules-0.6.jar文件，將這個JAR添加到<war>任務的<lib>中。如果使用Maven2建立應用程序，需要在pom.xml中添加下面的<dependency>:
<dependency>
<groupId>org.springmodules</groupId>
<artifactId>springmodules-validation</artifactId>
<version>0.6</version>
<scope>compile</scope>
</dependency>
另外，還需要將Jakarta Commons Validator JAR添加到應用程序的classpath中，在Maven中，按如下所示：
<dependency>
<groupId>commons-validator</groupId>
<artifactId>commons-validator</artifactId>
<version>1.1.4</version>
<scope>compile</scope>
</dependency>
Spring Module提供的Validator實現的名稱為DefaultBeanValidator。DefaultBeanValidator需要按下面的方式配置在roadrantz-servlet.xml中：
<bean id="beanValidator" class="org.springmodules.commons.validator.DefaultBeanValidator">
<property name="validatorFactory" ref="validatorFactory"></property>
</bean>
DefaultBeanValidator并不做任何實際的驗證工作，而是委派Commons Validator來驗證字段的值。validatorFactory Bean需要使用下面的XML進行聲明：
<bean id="validatorFactory" class="org.springmodules.commons.validator.DefaultValidatorFactory">
<property name="validationConfigLocations">
<list>
<value>WEB-INF/validator-rules.xml</value>
<value>WEB-INF/validator.xml</value>
</list>
</property>
</bean> validator-rules.xml文件包含了一組預定義的驗證規則，可以應用于一般的驗證需求。這個文件被包含在Commons Validator發行包中，因此，你不需要自己編寫--值需要簡單的將其添加到應用程序的WEB-INF目錄中。（PPT9）中列出了validator-rules.xml中的所有驗證規則。另一個文件validation.xml定義了應用程序制定的驗證規則，可有直接應用于RoadRantz應用程序。下面展示了應用到RoadRantz的validation.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE form-validation PUBLIC"-//Apache Software Foundation//DTD Commons Validator Rules Configuration 1.1
//EN" "http://jakarta.apache.org/commons/dtds/validator_1_1.dtd" >
<form-validation>
<formet>
<form>
<field property="rantText" depends="required">
<arg0 key="required.rantText"/>
</field>
<field property="vehicle.plateNumber" depends="required,mask">
<arg0 key="invalid.plateNumber"/>
<var>
<var-name>mask</var-name>
<var-value>^[0-9A-Za-z]{2,6}$</var-value>
</var>
</field>
</form>
</formet>
</form-validation>
最后一件要做的事情是改變控制器的聲明，注入新的聲明性Validate實現：
<bean id="addRantController" class="com.roadrantz.mvc.AddRantFormController">
<property name="formView" value="addRant" />
<property name="successView" value="rantAdded" />
<property name="rantService" value="rantService" />
<property name="validator" value="beanValidator" />
</bean>
使用SimpleFormController的一個基本的原因是表單只有一頁。
用向導處理復雜表單：AbstractWizardFormController是Spring提供的功能最強大的控制器（見PPT10）它是一種特殊類型的表單控制器，它將多個頁面中的表單數據聚集到一個用于處理的命令對象中。
-
創建一個基本的向導控制器：構建一個向導控制器，它必須繼承AbstractWizardFormController類，如下：
public class MotoristRegistrationController extends AbstractWizardFormController {
public MotoristRegistrationController() {
setCommandClass(Motorist.class);
setCommandName("motorist");
}
protected Object formBackingObject(HttpServletRequest request) throws Exception{
Motorist formMotorist = new Motorist();
List<Vehicle> vehicles = new ArrayList<Vehicle>();
vehicles.add(new Vehicle());
formMotorist.setVehicles(vehicles);
return formMotorist;
}
protected Map referenceData(HttpServletRequest request,Object command,Errors errors,int page)
throws Exception{
Motorist motorist = (motorist) command;
Map refData = new HashMap();
if(page==1 && request.getParameter("_target1")!= null){
refData.put("nextVehicle", motorist.getVehicles().size()-1);
}
return refData;
}
protected void postProcessPage(HttpServletRequest request,Object command,Errors errors,int page)throws Exception {
Motorist motorist = (Motorist)command;
if(page==1 && request.getParameter("_target1")!= null){
motorist.getVehicles().add(new Vehicle());
}
}
protected ModelAndView processFinish(HttpServletRequest request,HttpServletResponse response,
Object command,BindException errors)throws Exception {
Motorist motorist = (motorist) command;
// the last Vehicle is always blank...remove it
motorist.getVehicles().remove(motorist.getVehicles().size()-1);
rantService.addMotorist(motorist);
return new ModelAndView(getSuccessView(),"motorist",motorist);
}
//inject
private RantService rantService;
public void setRantService(RantService rantService) {
this.rantService = rantService;
}
//returns the last page as the success view
private String getSuccessView() {
return getPages()[getPages().length-1];
}
}
AbstractWizardFormController的唯一一個必須實現的方法是processFinish()。在用戶完成表單后(一般是點擊完成按鈕),這個方法被調用，完成整個表單。 但是AbstractWizardFormController是如何知道哪些頁面構成了整個表單呢？
<bean id="registerMotoristController" class="com.roadrantz.mvc.MotoristRegistrationController">
<property name="rantService" ref="rantService" />
<property name="pages">
<list>
<value>motoristDetailForm</value>
<value>motoristVehicleForm</value>
<value>motoristConfirmation</value>
<value>redirect:home.htm</value>
</list>
</property>
</bean>這樣向導就知道了哪些頁面構成了表單，一個視圖邏輯名列表設置給了pages屬性。這些名字最終被視圖解析器解析成了一個個視圖對象。但現在，只要假設這些名字會被解析成JSP文件名就可以了。
分步顯示表單頁面：任何向導控制器顯示的第一個頁面都是pages屬性中列表的第一個頁面。AbstractWizardFormController詢問它的getTargetPage()方法。這個方法返回一個整數，它是pages屬性中設置的頁面列表的索引值(以0為基數)。getTargetPage()方法的默認實現是根據請求中的一個參數來決定下一步是哪個頁面，這個參數以"_target"開頭，以數字結尾。知道了getTargetPage()的工作原理有助于你知道如何在向導HTML頁面中構造下一步和上一步按鈕。例如，假設用戶在"motoristVehicleForm"頁面上(索引=1)。要在這個頁面上創建下一步和上一步按鈕，你要做就是創建提交按鈕，它的名字是以"_target"開頭：
<form>
...
<input type="submit" value="Back" name="_target0">
<input type="submit" value="Next" name="_target2">
</form>getTargetPage()方法的默認實現對于大多數項目已經夠用了。然后，如果你喜歡為你的向導定義自己的工作流程的話，你可以覆寫這個方法。
完成向導：還有一個特殊請求的參數"_finish"，和"_targetX"參數一樣，它可以被用于在頁面上創建一個結束按鈕：
<form method="POST" action="feedback.htm">
...
<input type="submit" value="Finish" name="_finish">
</form>
當AbstractWizardFormController看到請求中的"_finish"參數時，它會將控制權交給processFinish()方法，讓它對表單做最后的處理。與其他表單控制器不同，AbstractWizardFormController不提供用于設置成功視圖頁面的內容。因此，我們在MotoristRegisttrationController中添加了一個getSuccessView()方法返回頁面列表中的最后一個頁面。所以，當表單已完成的方式提交時，processFinish()方法會返回一個帶有視圖的ModelAndView,這個視圖就是頁面列表中的最后一個視圖。
取消向導：如何用戶完成了部分注冊，決定不再繼續完成，除了選擇直接關閉瀏覽器外，還有另一種選擇，你可以在表單上添加一個取消按鈕。
<form method="POST" action="feedback.htm">
...
<input type="submit" value="Cancel" name="_cancel">
</form>
取消按鈕以"_cancel"作為它的名字，當用戶按下取消按鈕，瀏覽器將一個叫做"_cancel"的參數放到請求中。AbstractWizardFormController接收到這個參數，將控制權交給processCancel()方法。 默認情況下此方法會拋出異常，表示取消操作是不被支持的，我們要覆寫這個方法，將用戶帶到你想讓他們點擊取消時看到的頁面。下面processCancel()方法的實現將用戶帶領到成功視圖。
protected ModelAndView processCancel(HttpServletRequest request, HttpServletResponse response, Object command, BindException bindException) throws Exception {
return new ModelAndView(getSucessView()) ;
}
每次驗證一個向導表單：使用其他類型的命令控制器，命令對象只裝載一個次。但使用向導控制器，用戶每完成向導頁面中的一步，都會有一個命令對象設置進來。使用向導，只做一次驗證是不可行的，太早的話，找到的驗證問題可能是由于用戶沒有完成向導而導致的。太晚的話，在完成按鈕被按下后再做檢查就太遲了，因為發現的問題可能越過了多個頁面(用戶該回到哪個頁面呢？) 向導控制器在每個頁面驗證一次命令對象，不是只驗證一次。這是通過每次頁面跳轉時調用validatePage()方法實現的。validatePage()方法的默認實現是空的（也就是沒有驗證），但是你可以覆寫這個方法，做出自己的判斷。 假設在motoristDetailForm頁面，詢問用戶的郵件地址，這個字段是可選的，但是如果輸入了值，必須輸入一個合法的E-mail地址。下面的validatePage(）方法展示了用戶從motoristDetailForm頁面跳轉出來的時候如何驗證E-mail地址。
protected void validatePage(Object command, Errors errors, int page ) {
Motorist motorist = (Motorist) command;
Motorist Validator validator = (MotoristValidator) getValidator();
if(page == 0){
validator.validateEmail(motorist.getEmail() , errors );
}
} 這里可以直接在validatePage()方法中檢查E-mail。然后，向導一般有好幾項字段需要驗證。如果這樣的話，validatePage(）方法會變得很笨拙。我們建議你將驗證任務委托給控制器的驗證器對象的字段級驗證方法，就像我們在這里調用MotoristValidator的validateEmail()方法一樣。 這意味著當你配置控制器的時候，你要設置validator屬性：
<bean id="registerMotoristController" class="com.roadrantz.mvc.MotoristRegistrationController">
<property name="rantService" ref="rantService" />
<property name="pages">
<list>
<value>motoristDetailForm</value>
<value>motoristVehicleForm</value>
<value>motoristConfirmation</value>
<value>redirect:home.htm</value>
</list>
</property>
<property name="validator">
<bean class="com.roadrantz.mvc.MotoristValidator" />
</property>
</bean>
一個需要注意的重要事項是，不像其他命令控制器，向導控制器從不調用它們的驗證器對象的標準validate()方法。這是因為validate()方法驗證整個命令對象，然而在向導中命令對象將在每個頁面驗證一次。
使用一次性控制器：一次性控制器比其他控制器簡單很多，ThrowawayController接口可以證明：
public interface ThrowawayController {
ModelAndView execute() throws Exception ;
}
ThrowawayController接口和Controller接口不在同一個體系里。一次性控制器自己作為自己作為自己的命令對象，而不是通過一個HttpServletRequest或一個命令對象獲得參數。與WebWork Action相似，都是以同樣的方式工作。我們將RantsForController實現為ThrowawayController：
public class RantsForDayController implements ThrowawayController{
private Day day;
public ModelAndView execute() throws Exception {
List<Rant> dayRants = rantService.getRantsForDay(day);
return new ModelAndView("dayRants","rants",dayRants);
}
public void setDay(Date day){
this.day = day;
}
private RantService rantSrvice;
public void setRantSrvice(RantService rantSrvice) {
this.rantSrvice = rantSrvice;
}
} 你必須在DispatcherServlet的上下文配置文件中聲明一次性控制器。只有一點很小的不同：
<bean id="rantsForDayController" class="com.roadrantz.mvc.RantsForDayController" scope="prototype">
<property name="rantService" ref="rantService">
</bean> scope屬性已經被設置為prototype。這就是一次性控制器獲取它們名字的地方。默認情況下，所有的Bean都是Singleton。 但是因為ThrowawayContoller和Controller不處于同一繼承層次，DispatcherServlet不知道如何通知ThrowawayController。所以你必須告訴DispathcerServlet使用一種不同的 處理適配器。確切的說，你必須像下面這樣配置ThrowawayControllerHandlerAdapter:
<bean id="throwawayHandler" class="org.springframework.web.servlet.mvc.throwaway.ThrowawayControllerHandlerAdapter" />
如果應用程序既使用了常規控制器又使用了一次性控制器，你還應該按如下方式聲明SimpleControllerHandleAdapter:
<bean id="simpleHandler" class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter" />
聲明兩處理器適配器使你可以在用一個應用程序中混合使用兩種類型的控制器。