Spring Boot 集成 Spring MVC

Spring MVC是一款优秀的、基于MVC思想的应用框架，它是Spring的一个子框架。是当前最优秀的MVC框架。

Spring Boot整合Spring MVC只需在pom.xml中引入

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <version>${version}</version>
</dependency>

配置Spring MVC

application.yml 示例：

server:
  port: 8080 # web服务端口号
  servlet:
    multipart:
      enabled: true # 启用文件上传
      location: # 上传文件临时保存位置
      max-file-size: 50MB # 单个文件上传最大大小限制
      max-request-size: 100MB # 单次请求主体最大大小限制
spring:
  mvc:
    format:
      date: yyyy-MM-dd # 日期格式
      date-time: yyyy-MM-dd HH:mm:ss # 日期时间格式
      time: HH:mm:ss # 时间格式
    servlet:
      path: / # servlet路径
      static-path-pattern: # 匹配静态资源路径
    view:
      prefix: # view前缀
      suffix: # view后缀，如：.jsp

以上是Spring MVC常用配置，更多配置可参见Spring Boot Web Properties

---

除了以上在 application.yml 中配置Spring MVC，也可以用Java代码实现。这种方式更加灵活。

在Spring Boot中使用Java代码配置Spring MVC很简单，只需要实现 WebMvcConfigurer 接口中相应的方法。

@Configuration
public class WebConfiguration implements WebMvcConfigurer {
}

Spring Boot中MVC配置相关类和接口：

1. WebMvcConfigurer 接口
2. WebMvcConfigurerAdapter WebMvcConfigurer 的实现类(废弃)
3. WebMvcConfigurationSupport MVC的基本实现并包含了WebMvcConfigurer接口中的方法
4. WebMvcAutoConfiguration MVC的自动装在类并部分包含了 WebMvcConfigurer 接口中的方法

以下列举 WebMvcConfigurer 常用的配置方法：

拦截器

拦载器一般用于做登录效验，权限认证等统一操作。

@Override
public void addInterceptors(InterceptorRegistry registry) {
    registry.addInterceptor(自定义拦载器)
            .addPathPatterns(拦载的路径);
}

自定义拦载器继承 HandlerInterceptor 接口。

跨域设置

@Override
public void addCorsMappings(CorsRegistry registry) {
    registry.addMapping("/**") // 允许跨域访问的路径
            .allowedOrigins("*")// 允许跨域访问的源
            .allowedMethods("POST", "GET", "PUT", "OPTIONS", "DELETE") // 允许请求方法
            .maxAge(86400) // 预检间隔时间
            .allowedHeaders("*") // 允许头部设置
            .allowCredentials(true); // 是否发送cookie
}

如果在拦截器的request中设置跨域，此处不生效。

映射静态资源

用于映射如图片，js，css文件等资源，访问这些静态资源不经过拦截器。

@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
    registry.addResourceHandler("/**").addResourceLocations("classpath:/statics/");
}

消息转换器

Spring MVC序列化与反序列化时调用，多用于参数转换。比如自定义日期格式，用 gson 替换默认的 jackson 实现json转换。

@Override
public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
    MappingJackson2HttpMessageConverter jackson2HttpMessageConverter = new MappingJackson2HttpMessageConverter();
    ObjectMapper objectMapper = new ObjectMapper();
    /**
     * 序列换成json时,将所有的long变成string
     * 因为js中得数字类型不能包含所有的java long值
     */
    SimpleModule simpleModule = new SimpleModule();
    simpleModule.addSerializer(Long.class, ToStringSerializer.instance);
    simpleModule.addSerializer(Long.TYPE, ToStringSerializer.instance);
    simpleModule.addSerializer(Date.class, DateSerializer.instance);

    objectMapper.registerModule(simpleModule);

//  objectMapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
    objectMapper.configure(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS, false);
    objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
    objectMapper.configure(DeserializationFeature.READ_UNKNOWN_ENUM_VALUES_AS_NULL, true);
    objectMapper.setTimeZone(TimeZone.getTimeZone("GMT+8"));
    objectMapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"));

    jackson2HttpMessageConverter.setObjectMapper(objectMapper);
    converters.add(0, jackson2HttpMessageConverter);
}

@Override
public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {

}

configureMessageConverters 会覆盖系统的转换器,而 extendMessageConverters 不会。

自定义轩换器实现 Converter 接口。

格式化数据

在认识这个方法时，以前日期格式化都用的Converter，用它可以专门处理数据格式。需要实现 Formatter 接口。

@Override
public void addFormatters(FormatterRegistry registry) {
    DateTimeFormatterRegistrar registrar = new DateTimeFormatterRegistrar();
    registrar.setTimeFormatter(DateTimeFormatter.ofPattern(DatePattern.NORM_TIME_PATTERN));
    registrar.setDateFormatter(DateTimeFormatter.ofPattern(DatePattern.NORM_DATE_PATTERN));
    registrar.setDateTimeFormatter(DateTimeFormatter.ofPattern(DatePattern.NORM_DATETIME_PATTERN));
    registrar.registerFormatters(registry);
}

参数解析器

当请求进入Controller方法时，Spring MVC会自动封装参数。可以通过实现 HandlerMethodArgumentResolver 接口自定义参数封装。比如通过自定义注解验证签名。

@Override
public void addArgumentResolvers(List<HandlerMethodArgumentResolver> resolvers) {
    resolvers.add(new VerifySignatureResolver());
}

视图解析器

视图解析器决定Controller返回数据的类型和型式，可以配置多个，order值越小越优先。

@Override
public void configureViewResolvers(ViewResolverRegistry registry) {

    // jsp视图解析器
    InternalResourceViewResolver jspView = new InternalResourceViewResolver();
    jspView.setOrder(1);
    jspView.setPrefix("/WEB-INFO");
    jspView.setSuffix(".jsp");
    registry.viewResolver(jspView);

    // xml
    XmlViewResolver xmlView = new XmlViewResolver();
    xmlView.setOrder(2);
    registry.viewResolver(xmlView);
}

简单的自动控制器

某些单纯页面跳，比如登录页面。无需写在 Controller 里，可以在这里添加。

@Override
public void addViewControllers(ViewControllerRegistry registry) {
    registry.addViewController("/hello").setViewName("/hello");
    //可以添加更多
}

---

更多配置可以查看该文档：WebMvcConfigurer