Spring MVC自動配置

Spring Boot為Spring MVC提供了自動配置，可以在大多數(shù)應(yīng)用程序中很好地工作。

自動配置在Spring默認(rèn)的基礎(chǔ)上添加了以下特性：

• 包含ContentNegotiatingViewResolver和BeanNameViewResolver bean。
• 支持提供靜態(tài)資源，包括對WebJars的支持。
• 自動注冊Converter、GenericConverter和Formatter
• 對HttpMessageConverters的支持。
• MessageCodesResolver的自動注冊。
• 靜態(tài)index.html支持。
• 自動使用ConfigurableWebBindingInitializer bean。

如果你想保留這些Spring Boot MVC自定義并進(jìn)行更多的MVC自定義(攔截器、格式化器、視圖控制器和其他特性)，你可以自定義配置類實現(xiàn)WebMvcConfigurer類型的@Configuration類，但不需要@EnableWebMvc。

如果你想提供RequestMappingHandlerMapping、RequestMappingHandlerAdapter或ExceptionHandlerExceptionResolver的自定義實例，并且仍然保持Spring Boot MVC自定義，你可以聲明一個WebMvcRegistrations類型的bean，并使用它來提供這些組件的自定義實例，源碼如下：

public interface WebMvcRegistrations {


  default RequestMappingHandlerMapping getRequestMappingHandlerMapping() {
    return null;
  }
  default RequestMappingHandlerAdapter getRequestMappingHandlerAdapter() {
    return null;
  }
  default ExceptionHandlerExceptionResolver getExceptionHandlerExceptionResolver() {
    return null;
  }
}

EnableWebMvcConfiguration

public static class EnableWebMvcConfiguration {
  private final WebMvcRegistrations mvcRegistrations;
  public EnableWebMvcConfiguration(ObjectProvider<WebMvcRegistrations> mvcRegistrationsProvider) {
    this.mvcRegistrations = mvcRegistrationsProvider.getIfUnique();
  }
  @Override
  protected RequestMappingHandlerAdapter createRequestMappingHandlerAdapter() {
    // 如果自定義了WebMvcRegistrations,則使用自定義的，其他的默認(rèn)配置行為不變
    if (this.mvcRegistrations != null) {
      RequestMappingHandlerAdapter adapter = this.mvcRegistrations.getRequestMappingHandlerAdapter();
      if (adapter != null) {
        return adapter;
      }
    }
    return super.createRequestMappingHandlerAdapter();
  }
}

如果你想要完全控制Spring MVC，你可以添加你自己的@Configuration注解@EnableWebMvc，或者自定義配置類該類繼承DelegatingWebMvcConfiguration并使用@Configuration注解。

消息轉(zhuǎn)換HttpMessageConverters

SpringMVC使用HttpMessageConverter接口來轉(zhuǎn)換HTTP請求和響應(yīng)。明智的默認(rèn)值是開箱即用的。例如，對象可以自動轉(zhuǎn)換為JSON（通過使用Jackson庫）或XML（通過使用JacksonXML擴展（如果可用），或者通過使用JAXB（如果Jackson XML擴展不可用））。默認(rèn)情況下，字符串以UTF-8編碼。

如果需要添加或自定義轉(zhuǎn)換器，可以使用Spring Boot的HttpMessageConverters類，如以下列表所示：

@Configuration(proxyBeanMethods = false)
public class CustomHttpMessageConvertersConfiguration {


  @Bean
  public HttpMessageConverters customConverters() {
    HttpMessageConverter<?> additional = new AdditionalHttpMessageConverter();
    HttpMessageConverter<?> another = new AnotherHttpMessageConverter();
    return new HttpMessageConverters(additional, another);
  }
}

系統(tǒng)默認(rèn)也提供了HttpMessageConverters Bean，其實我們可以直接將自定義的HttpMessageConverter注冊為Bean即可：

public class HttpMessageConvertersAutoConfiguration {
  @Bean
  @ConditionalOnMissingBean
  // 這里的參數(shù)就能夠收集所有HttpMessageConverter類型的Bean
  public HttpMessageConverters messageConverters(ObjectProvider<HttpMessageConverter<?>> converters) {
    return new HttpMessageConverters(converters.orderedStream().collect(Collectors.toList()));
  }  
}

自定義JSON序列化和反序列化

如果你使用Jackson來序列化和反序列化JSON數(shù)據(jù)，你可能需要編寫自己的JsonSerializer和JsonDeserializer類。自定義序列化程序通常通過一個模塊向Jackson注冊，但Spring Boot提供了一個替代的@JsonComponent注釋，可以更容易地直接注冊Spring Beans。

你可以在JsonSerializer、JsonDeserializer或KeyDeserialize實現(xiàn)上直接使用@JsonComponent注釋。您也可以在包含序列化程序/反序列化程序作為內(nèi)部類的類上使用它，如以下示例所示：

@JsonComponent
public class MyJsonComponent {


  public static class Serializer extends JsonSerializer<MyObject> {
    @Override
    public void serialize(MyObject value, JsonGenerator jgen, SerializerProvider serializers) throws IOException {
      jgen.writeStartObject();
      jgen.writeStringField("name", value.getName());
      jgen.writeNumberField("age", value.getAge());
      jgen.writeEndObject();
    }
  }


  public static class Deserializer extends JsonDeserializer<MyObject> {


    @Override
    public MyObject deserialize(JsonParser jsonParser, DeserializationContext ctxt) throws IOException, JsonProcessingException {
      ObjectCodec codec = jsonParser.getCodec();
      JsonNode tree = codec.readTree(jsonParser);
      String name = tree.get("name").textValue();
      int age = tree.get("age").intValue();
      return new MyObject(name, age);
    }
  }
}

ApplicationContext中的所有@JsonComponent bean都會自動注冊到Jackson中。因為@JsonComponent是用@Component進(jìn)行元注釋的，所以應(yīng)用了通常的組件掃描規(guī)則。

MessageCodesResolver

Spring MVC有一個生成錯誤代碼的策略，用于從綁定錯誤中呈現(xiàn)錯誤消息：MessageCodesResolver。如果你設(shè)置
spring.mvc.message-codes-resolver-format屬性PREFIX_ERROR_CODE或POSTFIX_ERROR_CODE，則spring Boot會為你創(chuàng)建一個屬性。

靜態(tài)內(nèi)容

默認(rèn)情況下，Spring Boot從類路徑中名為/static（或/public或/resources或/META-INF/resources）的目錄或ServletContext的根目錄提供靜態(tài)內(nèi)容。它使用Spring MVC中的
ResourceHttpRequestHandler，因此您可以通過添加自己的WebMvcConfigurer并重寫addResourceHandlers方法來修改該行為。

在獨立的web應(yīng)用程序中，不會啟用容器中的默認(rèn)servlet。可以使用
server.servlet.register-default-servlet屬性啟用它。

默認(rèn)的servlet充當(dāng)后備，如果Spring決定不處理ServletContext的根，則從ServletContext提供內(nèi)容。大多數(shù)情況下，這不會發(fā)生（除非您修改默認(rèn)的MVC配置），因為Spring總是可以通過DispatcherServlet處理請求。

默認(rèn)情況下，資源映射在/**上，但您可以使用
spring.mvc.static-path-pattern屬性對其進(jìn)行調(diào)優(yōu)。例如，將所有資源重新定位到/resources/**可以通過以下方式實現(xiàn)：

spring:
  mvc:
    static-path-pattern: "/resources/**"

你還可以使用spring.web.resources自定義靜態(tài)資源位置。static-locations屬性(用目錄位置列表替換默認(rèn)值)。根servlet上下文路徑“/”也會自動添加為位置。

除了前面提到的“標(biāo)準(zhǔn)”靜態(tài)資源位置之外，還有一個針對Webjars內(nèi)容的特殊情況。任何路徑在/webjars/**中的資源，如果它們被打包成webjars格式，就會從jar文件中提供。

Spring Boot還支持Spring MVC提供的高級資源處理功能，允許使用緩存破壞靜態(tài)資源或為Webjars使用版本不可知的URL等用例。

要為Webjars使用與版本無關(guān)的URL，請?zhí)砑覹ebjars定位器核心依賴項。然后聲明您的Webjar。以jQuery為例，添加“
/webjars/jQuery/jQuery.min.js”會導(dǎo)致“/Webjar/jQuery/x.y.z/jQuery.min.js”，其中x.y.z是Webjar版本。

要使用緩存破壞，以下配置為所有靜態(tài)資源配置緩存破壞解決方案，從而有效地在URL中添加內(nèi)容哈希，如<link href=“
/css/spring-2a2d595e6ed9a0b24f027f2b63b134d6.css”/>：?

spring:
  web:
    resources:
      chain:
        strategy:
          content:
            enabled: true
            paths: "/**"

路徑匹配與內(nèi)容協(xié)商

Spring MVC可以通過查看請求路徑并將其與應(yīng)用程序中定義的映射（例如，Controller方法上的@GetMapping注釋）進(jìn)行匹配，將傳入的HTTP請求映射到處理程序。

Spring Boot默認(rèn)選擇禁用后綴模式匹配，這意味著像"GET/projects/Spring Boot.json"這樣的請求將不會與@GetMapping("/projects/Spring Boot")映射匹配。這被認(rèn)為是Spring MVC應(yīng)用程序的最佳實踐。這個功能在過去主要適用于沒有發(fā)送正確的“Accept”請求頭的HTTP客戶端；我們需要確保向客戶端發(fā)送正確的內(nèi)容類型。如今，內(nèi)容協(xié)商更加可靠。

還有其他方法可以處理那些不一致地發(fā)送正確的"Accept"請求頭的HTTP客戶端。我們可以使用查詢參數(shù)來確保像"GET/projects/spring-boot?format=json"這樣的請求將被映射到@GetMapping("/projects/spring-boot")，而不是使用后綴匹配：

spring:
  mvc:
    contentnegotiation:
      favor-parameter: true

或者自定義參數(shù)名稱：

spring:
  mvc:
    contentnegotiation:
      favor-parameter: true
      parameter-name: "myparam"

大多數(shù)標(biāo)準(zhǔn)media type都支持開箱即用，但你也可以定義新的:

spring:
  mvc:
    contentnegotiation:
      media-types:
        markdown: "text/markdown"

后綴模式匹配已棄用，并將在將來的版本中刪除。如果你理解注意事項，并且仍然希望你的應(yīng)用程序使用后綴模式匹配，則需要以下配置：

spring:
  mvc:
    contentnegotiation:
      favor-path-extension: true
    pathmatch:
      use-suffix-pattern: true

ConfigurableWebBindingInitializer

Spring MVC使用WebBindingInitializer為特定請求初始化WebDataBinder。如果你創(chuàng)建自己的ConfigurationWebBindingInitializer@Bean，則Spring Boot會自動配置Spring MVC以使用它。

錯誤處理

默認(rèn)情況下，Spring Boot提供了一個/error映射，以合理的方式處理所有錯誤，并且它在servlet容器中注冊為“全局”錯誤頁面。對于機器客戶端，它會生成一個JSON響應(yīng)，其中包含錯誤、HTTP狀態(tài)和異常消息的詳細(xì)信息。對于瀏覽器客戶端，有一個“白標(biāo)簽”錯誤視圖，它以HTML格式呈現(xiàn)相同的數(shù)據(jù)（要自定義它，請?zhí)砑右粋€解決錯誤的視圖）。

服務(wù)器有很多。如果要自定義默認(rèn)錯誤處理行為，可以設(shè)置的錯誤屬性。

要完全替換默認(rèn)行為，可以實現(xiàn)ErrorController并注冊該類型的bean定義，或者添加ErrorAttributes類型的bean以使用現(xiàn)有機制，但替換內(nèi)容。

你也可以定義一個帶有@ControllerAdvice注解的類來定制JSON文檔，以返回特定的控制器和/或異常類型，如下例所示:

@ControllerAdvice(basePackageClasses = SomeController.class)
public class MyControllerAdvice extends ResponseEntityExceptionHandler {


  @ResponseBody
  @ExceptionHandler(MyException.class)
  public ResponseEntity<?> handleControllerException(HttpServletRequest request, Throwable ex) {
    HttpStatus status = getStatus(request);
    return new ResponseEntity<>(new MyErrorBody(status.value(), ex.getMessage()), status);
  }


  private HttpStatus getStatus(HttpServletRequest request) {
    Integer code = (Integer) request.getAttribute(RequestDispatcher.ERROR_STATUS_CODE);
    HttpStatus status = HttpStatus.resolve(code);
    return (status != null) ? status : HttpStatus.INTERNAL_SERVER_ERROR;
  }


}

完畢！！！