SpringBoot中MVC的配置讲解

0.前言

原来项目中关于SpringMVC的配置都是采用xml方式的，现在需要进行SpringBoot化改造，需要将配置项改成java bean的方式配置。

1.依赖引入

想要启用SpringMVC相关配置，首先需要在pom中引入依赖

        
        
            org.springframework.boot
            spring-boot-starter-web
        

2.创建配置类

首先需要新建一个mvc的配置类，通过@Configuration注解进行初始化，然后还需要实现WebMvcConfigurer接口。

在SpringBoot1.X的版本中都是使用继承WebMvcConfigurerAdapter的方式，因为这种方式可以只覆盖并重写想要自定义的配置项，但到了SpringBoot2.0后该类就被废弃了，取而代之的是实现WebMvcConfigurer接口的方式，这是因为SpringBoot2.0的默认JDK版本为1.8，这个版本开始支持接口中方法的default修饰符，可以不用再去实现不想实现的方法，因此官方也是推荐这种配置方式。另外要说的一点是，看了网上一些文章都写着要在类上配置@EnableWebMvc注解，但亲测根本不需要。

@Configuration
public class WebConfig implements WebMvcConfigurer {

}

2.1 interceptors配置

interceptors起到拦截器的功能，配置如下

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Bean
    public ConnectInterceptor connectInterceptor() {
        return new ConnectInterceptor();
    }

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(userInterceptor()).addPathPatterns("/**").excludePathPatterns("/admin/**").order(1);
        registry.addInterceptor(connectInterceptor()).addPathPatterns("/provinceExtend/**").order(2);
        registry.addInterceptor(connectInterceptor()).addPathPatterns("/gatewayExtend/**").order(3);
    }
}

这里实现的addInterceptors方法对应的是xml文件中配置

2.2 formatters和converters配置

formatters和converters用于对日期格式进行转换，默认已注册了Number和Date类型的formatters，支持@NumberFormat和@DateTimeFormat注解，需要自定义formatters和converters可以实现addFormatters方法

    @Override
    public void addFormatters(FormatterRegistry registry) {
        // Add formatters and/or converters
    }

对应的xml配置为

2.3 View Resolvers配置

View Resolvers对视图进行相关配置，主要是配置视图的前后缀，配置如下

    @Override
    public void configureViewResolvers(ViewResolverRegistry registry) {
        InternalResourceViewResolver irvr = new InternalResourceViewResolver("/", ".jsp");
        registry.viewResolver(irvr);
    }

也可以采用简化版配置

    @Override
    public void configureViewResolvers(ViewResolverRegistry registry) {
        registry.jsp("/", ".jsp");
    }

对应的xml配置为

2.4 MessageConverter配置

MessageConverter用于对http请求的返回结果进行转换，以fastjon、编码格式application/json;charset=UTF-8进行转换，配置如下

    @Override
    public void configureMessageConverters(List> converters) {
        //创建fastJson消息转换器
        FastJsonHttpMessageConverter fastConverter = new FastJsonHttpMessageConverter();
        //创建配置类
        FastJsonConfig fastJsonConfig = new FastJsonConfig();
        //修改配置返回内容的过滤
        fastJsonConfig.setSerializerFeatures(
                SerializerFeature.DisableCircularReferenceDetect,
                SerializerFeature.WriteMapNullValue,
                SerializerFeature.WriteNullStringAsEmpty
        );
        fastConverter.setFastJsonConfig(fastJsonConfig);
        MediaType jsonUtf8 = MediaType.APPLICATION_JSON_UTF8;
        List medias = new ArrayList<>();
        medias.add(jsonUtf8);
        fastConverter.setSupportedMediaTypes(medias);
        //将fastjson添加到视图消息转换器列表内
        converters.add(fastConverter);
    }

总结

目前项目里用到的MVC配置项都已经列出来了，转换上也没有什么问题，但我个人的感受是SpringBoot这种配置方式没有使用xml的方式直观，而且配置上改动比较大，也有不少的模板痕迹，没有起到简化配置的目的，后续继续看看SpringBoot其他方面的优点是否值得项目做出如此大的改动。