SpringBoot对SpringMVC的自动配置，你知道多少？-51CTO.COM

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;
  }


}

完毕！！！