Spring MVC自動配置

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

自動配置在Spring默認的基礎上添加了以下特性：

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

如果你想保留這些Spring Boot MVC自定義并進行更多的MVC自定義(攔截器、格式化器、視圖控制器和其他特性)，你可以自定義配置類實現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,則使用自定義的，其他的默認配置行為不變
    if (this.mvcRegistrations != null) {
      RequestMappingHandlerAdapter adapter = this.mvcRegistrations.getRequestMappingHandlerAdapter();
      if (adapter != null) {
        return adapter;
      }
    }
    return super.createRequestMappingHandlerAdapter();
  }
}

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

消息轉換HttpMessageConverters

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

如果需要添加或自定義轉換器，可以使用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);
  }
}

系統默認也提供了HttpMessageConverters Bean，其實我們可以直接將自定義的HttpMessageConverter注冊為Bean即可：

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

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

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

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

@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進行元注釋的，所以應用了通常的組件掃描規則。

MessageCodesResolver

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

靜態內容

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

在獨立的web應用程序中，不會啟用容器中的默認servlet。可以使用
server.servlet.register-default-servlet屬性啟用它。

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

默認情況下，資源映射在/**上，但您可以使用
spring.mvc.static-path-pattern屬性對其進行調優。例如，將所有資源重新定位到/resources/**可以通過以下方式實現：

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

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

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

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

要為Webjars使用與版本無關的URL，請添加Webjars定位器核心依賴項。然后聲明您的Webjar。以jQuery為例，添加“
/webjars/jQuery/jQuery.min.js”會導致“/Webjar/jQuery/x.y.z/jQuery.min.js”，其中x.y.z是Webjar版本。

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

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

路徑匹配與內容協商

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

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

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

spring:
  mvc:
    contentnegotiation:
      favor-parameter: true

或者自定義參數名稱：

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

大多數標準media type都支持開箱即用，但你也可以定義新的:

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

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

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

ConfigurableWebBindingInitializer

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

錯誤處理

默認情況下，Spring Boot提供了一個/error映射，以合理的方式處理所有錯誤，并且它在servlet容器中注冊為“全局”錯誤頁面。對于機器客戶端，它會生成一個JSON響應，其中包含錯誤、HTTP狀態和異常消息的詳細信息。對于瀏覽器客戶端，有一個“白標簽”錯誤視圖，它以HTML格式呈現相同的數據（要自定義它，請添加一個解決錯誤的視圖）。

服務器有很多。如果要自定義默認錯誤處理行為，可以設置的錯誤屬性。

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

你也可以定義一個帶有@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;
  }


}

完畢！！！