SpringBoot对SpringMVC的自动配置,你知道多少?

发表于:2023-3-27 09:33

字体: | 上一篇 | 下一篇 | 我要投稿

 作者:Springboot实战案例锦    来源:实战案例锦集

  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;
    }
  }
  完毕!!!
  本文内容不用于商业目的,如涉及知识产权问题,请权利人联系51Testing小编(021-64471599-8017),我们将立即处理
《2023软件测试行业现状调查报告》独家发布~

关注51Testing

联系我们

快捷面板 站点地图 联系我们 广告服务 关于我们 站长统计 发展历程

法律顾问:上海兰迪律师事务所 项棋律师
版权所有 上海博为峰软件技术股份有限公司 Copyright©51testing.com 2003-2024
投诉及意见反馈:webmaster@51testing.com; 业务联系:service@51testing.com 021-64471599-8017

沪ICP备05003035号

沪公网安备 31010102002173号