0.前言
原来项目中关于SpringMVC的配置都是采用xml方式的,现在需要进行SpringBoot化改造,需要将配置项改成java bean的方式配置。
1.依赖引入
想要启用SpringMVC相关配置,首先需要在pom中引入依赖
<!--添加web依赖配置-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
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文件中<mvc:interceptors>
配置
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配置为
<mvc:annotation-driven conversion-service="conversionService"/>
<bean id="conversionService" class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
<property name="converters">
<list>
<bean class="com.cmcc.zeus.base.core.convert.StringToDateConverter" />
</list>
</property>
</bean>
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配置为
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/" />
<property name="suffix" value=".jsp" />
</bean>
2.4 MessageConverter配置
MessageConverter用于对http请求的返回结果进行转换,以fastjon、编码格式application/json;charset=UTF-8
进行转换,配置如下
@Override
public void configureMessageConverters(List<HttpMessageConverter<?>> 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<MediaType> medias = new ArrayList<>();
medias.add(jsonUtf8);
fastConverter.setSupportedMediaTypes(medias);
//将fastjson添加到视图消息转换器列表内
converters.add(fastConverter);
}
总结
目前项目里用到的MVC配置项都已经列出来了,转换上也没有什么问题,但我个人的感受是SpringBoot这种配置方式没有使用xml的方式直观,而且配置上改动比较大,也有不少的模板痕迹,没有起到简化配置的目的,后续继续看看SpringBoot其他方面的优点是否值得项目做出如此大的改动。