详解@EnableWebMvc
最近看了《Spring in Action》的开头,就被Spring注解开发(完全不写web.xml)惊叹了,也第一次知道了@EnableWebMvc是SpringMVC的注解
@EnableWebMvc注解
@EnableWebMvc的javaDoc注释有点长。 从下图得到的几个信息: href="mailto:1.@EnableWebMvc">1.@EnableWebMvc没有任何属性,只是@Import了一个类叫DelegatingWebMvcConfiguration
2. 注释中说明:将@EnableWebMvc添加给@Configuration类来导入SpringMvc的配置;3.自定义MVC配置,实现接口WebMvcConfigurer或更可能继承WebMvcConfigurerAdapter,并且使用@EnableWebMvc;
4.如果还想要自定义配置,移除@EnableWebMvc,并且继承WebMvcConfigurationSupport或DelegatingWebMvcConfiguration。
5.@EnableWebMvc出现自Spring3.1的版本
@EnableWebMvc的注释文档说的很详细,先记录第一点,@Import的类是干啥的!
@Import的多种用法看我这篇文档:Spring @Import . @Import导入了一个类DelegatingWebMvcConfiguration,这个类标注了@Configuration类,这个类下方法上标注了@Bean的都会纳入Spring容器管理。
DelegatingWebMvcConfiguration类如下,但是类里面搜索却没有@Bean标注! 在其父类WebMvcConfigurationSupport里面搜索到了19个@Bean.
这19个@Bean基本上和<mvc:annotation-driven/>实现的功能无差,甚至提供了一种很便捷的方式扩展<mvc:annotation-driven/>
举两个栗子,说明下:1. <mvc:annotation-driven/> @ResponseBody 返回String中文乱码 Spring @ResponseBody String中文乱码
@EnableWebMvc同样存在这个问题,默认字符集为ISO-8859-1,解决方案:继承WebMvcConfigurerAdapter,重写extendMessageConverters方法!
栗子2:比如需要添加拦截器,原先写法可能是<mvc:interceptors></mvc:interceptors>这种形式添加,现在不用XML,方式就是这样:
在继承WebMvcConfigurerAdapter基础上,重写addInterceptor方法。
@EnableWebMvc可扩展的结构
图片可以从processOn拷贝,RequestMappingHandlerMapping地址:https://www.processon.com/view/5c9d8480e4b035b243ba651b
RequestMappingHandlerAdapter地址:https://www.processon.com/view/5c9d86cee4b034408de5663d 红框代表可继承扩展WebMvcConfigurerAdapter等扩展的方法。
想到为什么继承WebMvcConfigurerAdapter或者实现WebMvcConfigurer,就能够在@EnableWebMvc继承上扩展呢?
@EnableWebMvc导入的是DelegatingWebMvcConfiguration类,和WebMvcConfigurer完全没有联系啊?
说明:DelegatingWebMvcConfiguration类,有这样一个属性WebMvcConfigurerComposite,维护着WebMvcConfigurer的集合,有点类似组合模式。
初始化DelegatingWebMvcConfiguration时如果发现了WebMvcConfigurer的实现类,就注入到WebMvcConfigurerComposite中,这样就把我们实现了WebMvcConfigurer的类和@EnableWebMvc联系到一起了,
就可以在<mvc:annotation-driven/>基础上扩展.
这里很神奇,在我理解中Spring没法自动判断两个Bean作为集合注入的啊! 这里起作用的就是required=false 少了这句话就抛出异常!
@EnableWebMvc默认是没有静态资源放行的,比如.css .js文件默认 也会被 dispatchServelt / 形式的拦截到
原来在web.xml文件中可以这样配置,静态资源后缀为.js .css不拦截
01 02 03 04 05 06 07 | < servlet-mapping > < servlet-name >default</ servlet-name > < url-pattern >*.html</ url-pattern > < url-pattern >*.htm</ url-pattern > < url-pattern >*.css</ url-pattern > < url-pattern >*.js</ url-pattern > </ servlet-mapping > |
在没有web.xml的文件中解决方案:继承WebMvcConfigurerAdapter,并且重写configureDefaultServletHandling方法,即可达到和上面一样的效果,就可以访问 .css .js等文件!
原理解析:如果这篇博客前面看过了,直接看到WebMvcConfigurationSupport,@Bean注册了一个bean defaultServletHandlerMapping,最终configureDefaultServletHandling会制定我们上面的方法。
DefaultServletHandlerConfigurer只是个配置类,Bean实际返回的是hanlderMapping!=null?handlerMapping:new EmptyHandlerMapping(); EmptyHandlerMapping不对请求做任何处理,而configurer的getHandlerMapping方法如下: handler不为空,就会返回一个SimpleUrlHandlerMapping,而configurer.enable()方法等价于configurer.enable(null),就是初始化handler的。总的来说就是,configurer.enable()方法就是注册了一个SimpleUrlHandlerMapping对象,handler就是DefaultServletHttpRequestHandler.
DefaultServletHttpRequestHandler如何处理静态资源请求?
通过获取 服务器默认的servlet进行转发,因为/** 会匹配所有的URI,所以SimpleUrlHandlerMapping必须放在RequestMappingHandlerMapping之后;核心方式就是servletContext.getNamedDispatcher(“default”).forward(request,response);
总结@EnableWebMvc替我们做了什么?
引入了这样一个类DelegatingWebMvcConfiguration,通过@Bean注册了和<mvc:annotation-driven/>一样的组件,RequestMappingHandlerMapping、RequestMappingHandlerAdatper、HandlerExceptionResolver等等,只要有个Spring管理的bean继承WebMvcConfigurer或WebMvcConfigurerAdapter,重写方法即可自定义<mvc:annotation-driven/>.
其实@EnableWebMvc == @Import({DelegatingWebMvcConfiguration.class})
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 用 C# 插值字符串处理器写一个 sscanf
· Java 中堆内存和栈内存上的数据分布和特点
· 开发中对象命名的一点思考
· .NET Core内存结构体系(Windows环境)底层原理浅谈
· C# 深度学习:对抗生成网络(GAN)训练头像生成模型
· 趁着过年的时候手搓了一个低代码框架
· 本地部署DeepSeek后,没有好看的交互界面怎么行!
· 为什么说在企业级应用开发中,后端往往是效率杀手?
· 用 C# 插值字符串处理器写一个 sscanf
· 乌龟冬眠箱湿度监控系统和AI辅助建议功能的实现