配置关键
- @EnableWebMvc | <mvc:annotation-driven>
- @ComponentScan | <context:component-scan>
- 处理静态文件的请求
- 视图解析器
1. 静态文件
由于Controller处理的是URL请求,对于静态文件的请求应该从DispatcherServlet中过滤出去,可以考虑如下的方法:
- 如果使用了Nginx等Web服务器,通过服务器分发请求
- web.xml中对default Servlet(由Servlet容器Tomcat/Jetty/JBoss声明)的Servlet Mapping进行配置,先于DispatcherServlet的Servlet Mapping,将静态文件请求交由default Servlet处理
- DispatcherServlet的ApplicationContext的配置中进行处理
A. application.xml中<mvc:default-servlet-handler />
B. application.xml中<mvc:resources mapping="" location="">
C. JavaConfig中WebMvcConfigurer#configureDefaultServletHandling(DefaultServletHandlerConfigurer)
D. JavaConfig中WebMvcConfigurer#addResourceHandlers(ResourceHandlerRegistry)
对于A和C来说,通过配置DefaultServletHttpRequestHandler实现,将其余Controller无法处理的请求交给它,
然后它把请求转发给default Servlet。
对于B和D来说,通过配置ResourceHttpRequestHandler实现,它可以实现更为精细的配置,包括了静态文件的位置,处理的请求pattern等,它会自己读取静态文件的内容,然后写到response。
ABCD的Handler都是通过SimpleUrlHandlerMapping进行映射的,所以无需自己配置handler。如果是requestMappingHandlerMapping,需要自行配置Controller。
值得注意的是
虽然ABCD通过<mvc>或是WebMvcConfigurer进行设置,但真正让他们生效,是依靠在ApplicationContext
将他们的SimpleUrlHandlerMapping注册为Bean实现的,而这个工作是由
<mvc:annotation-driven /> | @EnableWebMvc
完成的
2. <mvc:annotation-driven /> | @EnableWebMvc
实现
A. <mvc:annotation-driven /> 通过springweb包下实现了BeanDefinitionParser接口的AnnotationDrivenBeanDefinitionParser来解析
B. @EnableWebMvc 通过引入WebMvcConfigurationSupport类实现
它们主要完成的工作:
(1)注册HandlerMapping:
可以看到最重要的RequestMapping注解的HandlerMapping,还有静态文件请求需要的两个HandlerMapping
(2)注册HandlerAdaptor:
同样包括了@Controller,静态文件Handler,Controller接口实现类。
(3)注册HandlerExceptionResolver:
注意在WebApplicationInitializer中如果没有配置,default和resource的HandlerMapping会是空的,而对于<mvc:annotation-driven>完全不会配置这两个HandlerMapping,这些是由<mvc:resource>和<mvc:default-servlet-handler>配置的。
具体信息可参看WebMvcConfigurationSupport与AnnotationDrivenBeanDefinitionParser的文档。
3. @ComponentScan | <context:component-scan>
通过ComponentScanAnnotationParser与ComponentScanBeanDefinitionParser实现
一般DispatcherServlet中的ApplicationContext只会扫描Controller及其相关的包,中间件以及Dao等的bean会注册到RootApplicationContext。