自定義WebDataBinder的初始化

為了在Spring的WebDataBinder裡，使用PropertyEditors來自定義請求引數的繫結，你能在你的controller中，使用@InitBinder方法，或在@ControllerAdvice註解了的類中使用@InitBinder，或者自己實現WebBingdingInitializer來自定義請求引數繫結。詳見”使用@ControllerAdvice對controller做橫切通知”這一章節。

使用@InitBinder自定義資料繫結

在controller中的方法上寫上@InitBinder,可以在你的controller類上直接配置web資料繫結。@InitBinder可以識別出初始化了WebDataBinder的方法，這個初始化了的WebDataBinder物件會被註解過的handler處理器方法的指令和表單物件入參所填充。

       這個init-binder(初始化繫結的)方法與@RequestMapping支援的入參型別相同。除了指令/表單物件和匹配驗證結果的物件外，這個初始化繫結的方法必須無返回值。因此，它們通常被宣告為void。一般來講，與WebRequest或java.util.Local結合的WebDataBinder入參，允許在程式碼中註冊特定context的編輯器。

       下面的例子展示了使用@InitBinder來為所有java.util.Data表單屬性配置一個CustomDataEditor。

       在Spring4.2中，可以考慮使用addCustomFormatter來定義Formatter實現，來代替使用PropertyEditor例項。同時，當你在一個共享的FormattingConversionService中存在一個基於Formatter的組織結構時，這也是特別有用的，稍微調整一下繫結規則就可在特定controller中以同樣的方式進行復用。

@Controller
public class MyFormController {
 
    @InitBinder
    public void initBinder(WebDataBinder binder) {
        binder.addCustomFormatter(new DateFormatter("yyyy-MM-dd"));
    }
 
    // ...
}

配置一個自定義的WebBindingInitializer

       為了實現繫結的初始化，你能夠通過實現WebBindingInitializer介面來自定義它。之後，需要為AnnotationMethodHandlerAdapter提供一個自定的bean配置，因此，需要覆寫配置文件中預設的配置。

       下面的例子來自於PetClinic應用，這個配置例子自定義實現了WebBindingInitializer介面，還有在PetClinic應用中，配置了PropertyEditors的controller所需的org.springframework.samples.petclinic.web.ClinicBindingInitialzier。

<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
    <property name="cacheSeconds" value="0"/>
    <property name="webBindingInitializer">
        <bean class="org.springframework.samples.petclinic.web.ClinicBindingInitializer"/>
    </property>
</bean>

       在@ControllerAdvice註解了的類中也能定義@InitBinder方法來匹配對應的controller。這種定義的方法使用了WebBindingInitializer的另一種方式。詳見”使用@ControllerAdvice對controller做橫切通知”。

使用@ControllerAdvice對controller做advice(橫切通知)

@ControllerAdvice的實現類能夠通過classpath掃描自動檢測到。當使用MVC 名稱空間或 MVC  java配置時，這是被自動啟用的。

       註解了@ControllerAdvice的類可以包含@ExceptionHandler,@InitBinder和@ModelAttribute方法。這些方法能夠應用到所有controller結構中的@RequestMapping方法上，而不單是在它所在的類中。

       @ControllerAdvice註解也能指定特定controller，這些controller可以帶有它的屬性:

// 指定所有註釋了@RestController的controller
@ControllerAdvice(annotations = RestController.class)
public class AnnotationAdvice {}
 
// 指定特定包下的所有controller
@ControllerAdvice("org.example.controllers")
public class BasePackageAdvice {}
 
// 指定所有可指定的特定類
@ControllerAdvice(assignableTypes = {ControllerInterface.class, AbstractController.class})
public class AssignableTypesAdvice {}

       詳見@ControllerAdvice的說明文件。

Jackson 序列化檢視的支援

有些時候，過濾那些要在HTTP響應主體中被序列化的context化的物件是很有用的。為了提供這種功能，Spring MVC內建了對使用Jackson’s  Serialization View渲染的支援。

       當與@ResponseBody的controller方法或返回了ResponseEntity的controller方法配合使用時，可以新增@JsonView，這個@JsonView裡帶有需要使用的檢視類或介面的入參:

@RestController
public class UserController {
 
    @RequestMapping(path = "/user", method = RequestMethod.GET)
    @JsonView(User.WithoutPasswordView.class)
    public User getUser() {
        return new User("eric", "7!jd#h23");
    }
}
 
public class User {
 
    public interface WithoutPasswordView {};
    public interface WithPasswordView extends WithoutPasswordView {};
 
    private String username;
    private String password;
 
    public User() {
    }
 
    public User(String username, String password) {
        this.username = username;
        this.password = password;
    }
 
    @JsonView(WithoutPasswordView.class)
    public String getUsername() {
        return this.username;
    }
 
    @JsonView(WithPasswordView.class)
    public String getPassword() {
        return this.password;
    }
}

小提示:

         請注意，雖然@JsonView可以指定多個類，但是在controller方法上使用時只支援一個類的入參。如果需要啟用多個檢視類，可以指定其使用的介面來實現。

對於依賴於檢視解析的controller，可以在模型中新增這個序列化的檢視類:

@Controller
public class UserController extends AbstractController {
 
    @RequestMapping(path = "/user", method = RequestMethod.GET)
    public String getUser(Model model) {
        model.addAttribute("user", new User("eric", "7!jd#h23"));
        model.addAttribute(JsonView.class.getName(), User.WithoutPasswordView.class);
        return "userView";
    }
}

Jackson JSONP支援

       為了在@ResponseBody方法和返回ResponseEntity的方法中啟用JSONP的支援，可以宣告繼承了AbstractJsonpResponseBodyAdvice的@ControllerAdvice的bean，下面的例子展示了在這個構造器入參中，在何處指定JSONP的查詢引數名。

@ControllerAdvice
public class JsonpAdvice extends AbstractJsonpResponseBodyAdvice {
 
    public JsonpAdvice() {
        super("callback");
    }
}

       對於依賴於檢視解析的controller，當請求中存在命名為jsonp或callback的查詢引數時，JSONP會自動啟用，你也能夠在jsonParameterNames屬性中自定義這些命名。