>>converters);
ValidatorgetValidator();
/*配置内容裁决的一些选项*/
voidconfigureContentNegotiation(ContentNegotiationConfigurerconfigurer);
voidconfigureAsyncSupport(AsyncSupportConfigurerconfigurer);
/*@since4.0.3*/
voidconfigurePathMatch(PathMatchConfigurerconfigurer);
/*参数解析*/
voidaddArgumentResolvers(ListargumentResolvers);
/*返回值解析*/
voidaddReturnValueHandlers(ListreturnValueHandlers);
/*异常处理*/
voidconfigureHandlerExceptionResolvers(ListexceptionResolvers);
voidextendHandlerExceptionResolvers(ListexceptionResolvers);
voidaddInterceptors(InterceptorRegistryregistry);
MessageCodesResolvergetMessageCodesResolver();
voidaddViewControllers(ViewControllerRegistryregistry);
/**
*这里配置视图解析器
*/
voidconfigureViewResolvers(ViewResolverRegistryregistry);
/**
*静态资源处理
*/
voidaddResourceHandlers(ResourceHandlerRegistryregistry);
voidconfigureDefaultServletHandling(DefaultServletHandlerConfigurerconfigurer);
voidaddCorsMappings(CorsRegistryregistry);
}
下面我们开始着重讲解以下几个常用的方法:
voidconfigureViewResolvers(ViewResolverRegistryregistry);
voidconfigureContentNegotiation(ContentNegotiationConfigurerconfigurer);
voidaddViewControllers(ViewControllerRegistryregistry);
voidaddResourceHandlers(ResourceHandlerRegistryregistry);
voidconfigureDefaultServletHandling(DefaultServletHandlerConfigurerconfigurer);
1.configureViewResolvers(ViewResolverRegistryregistry)
从方法名称我们就能看出这个方法是用来配置视图解析器的,该方法的参数ViewResolverRegistry 是一个注册器,用来注册你想自定义的视图解析器等。
ViewResolverRegistry 常用的几个方法:
1).enableContentNegotiation
/**启用内容裁决视图解析器*/
publicvoidenableContentNegotiation(View...defaultViews){
initContentNegotiatingViewResolver(defaultViews);
}
该方法会创建一个内容裁决解析器ContentNegotiatingViewResolver ,该解析器不进行具体视图的解析,而是管理你注册的所有视图解析器,所有的视图会先经过它进行解析,然后由它来决定具体使用哪个解析器进行解析。
具体的映射规则是根据请求的mediatypes来决定的。
2). UrlBasedViewResolverRegistration
publicUrlBasedViewResolverRegistrationjsp(Stringprefix,Stringsuffix){
InternalResourceViewResolverresolver=newInternalResourceViewResolver();
resolver.setPrefix(prefix);
resolver.setSuffix(suffix);
this.viewResolvers.add(resolver);
returnnewUrlBasedViewResolverRegistration(resolver);
}
该方法会注册一个内部资源视图解析器InternalResourceViewResolver 显然访问的所有jsp都是它进行解析的。
该方法参数用来指定路径的前缀和文件后缀,如:
registry.jsp("/WEB-INF/jsp/",".jsp");
对于以上配置,假如返回的视图名称是example,它会返回/WEB-INF/jsp/example.jsp给前端,找不到则报404。
3). beanName
publicvoidbeanName(){
BeanNameViewResolverresolver=newBeanNameViewResolver();
this.viewResolvers.add(resolver);
}
该方法会注册一个BeanNameViewResolver 视图解析器,这个解析器是干嘛的呢?
它主要是将视图名称解析成对应的bean。
什么意思呢?
假如返回的视图名称是example,它会到spring容器中找有没有一个叫example的bean,并且这个bean是View.class类型的?
如果有,返回这个bean。
4). viewResolver
publicvoidviewResolver(ViewResolverviewResolver){
if(viewResolverinstanceofContentNegotiatingViewResolver){
thrownewBeanInitializationException(
"addViewResolvercannotbeusedtoconfigureaContentNegotiatingViewResolver.PleaseusethemethodenableContentNegotiationinstead.");
}
this.viewResolvers.add(viewResolver);
}
这个方法想必看名字就知道了,它就是用来注册各种各样的视图解析器的,包括自己定义的。
2.configureContentNegotiation(ContentNegotiationConfigurerconfigurer)
上面一节我们讲了configureViewResolvers 方法,假如在该方法中我们启用了内容裁决解析器,那么configureContentNegotiation(ContentNegotiationConfigurerconfigurer) 这个方法是专门用来配置内容裁决的一些参数的。
这个比较简单,我们直接通过一个例子看:
publicvoidconfigureContentNegotiation(ContentNegotiationConfigurerconfigurer){
/*是否通过请求Url的扩展名来决定mediatype*/
configurer.favorPathExtension(true)
/*不检查Accept请求头*/
.ignoreAcceptHeader(true)
.parameterName("mediaType")
/*设置默认的mediayype*/
.defaultContentType(MediaType.TEXT_HTML)
/*请求以.html结尾的会被当成MediaType.TEXT_HTML*/
.mediaType("html",MediaType.TEXT_HTML)
/*请求以.json结尾的会被当成MediaType.APPLICATION_JSON*/
.mediaType("json",MediaType.APPLICATION_JSON);
}
到这里我们就可以举个例子来进一步熟悉下我们上面讲的知识了,假如我们MVC的配置如下:
@EnableWebMvc
@Configuration
publicclassMvcConfigextendsWebMvcConfigurerAdapter{
@Override
publicvoidconfigureViewResolvers(ViewResolverRegistryregistry){
registry.jsp("/WEB-INF/jsp/",".jsp");
registry.enableContentNegotiation(newMappingJackson2JsonView());
}
@Override
publicvoidconfigureContentNegotiation(ContentNegotiationConfigurerconfigurer){
configurer.favorPathExtension(true)
.ignoreAcceptHeader(true)
.parameterName("mediaType")
.defaultContentType(MediaType.TEXT_HTML)
.mediaType("html",MediaType.TEXT_HTML)
.mediaType("json",MediaType.APPLICATION_JSON);
}
}
controller的代码如下:
@Controller
publicclassExampleController{
@RequestMapping("/example1")
publicModelAndViewexample1(){
Mapmap=newHashMap();
map.put("1","a");
map.put("2","b");
returnnewModelAndView("example1",map);
}
}
在WEB-INF/jsp目录下创建一个example1.jsp文件,内容随意。
现在启动tomcat,在浏览器输入以下链接:
http:
//localhost:
8080/example1.json,浏览器返回如下:
在浏览器输入http:
//localhost:
8080/example1 或者http:
//localhost:
8080/example1.html,返回如下:
显然,两次使用了不同的视图解析器,那么底层到底发生了什么?
在配置里我们注册了两个视图解析器:
ContentNegotiatingViewResolver 和 InternalResourceViewResolver,还有一个默认视图:
MappingJackson2JsonView。
controller执行完毕之后返回一个ModelAndView,其中视图的名称为example1。
返回首先会交给ContentNegotiatingViewResolver进行视图解析处理,而ContentNegotiatingViewResolver 会先把视图名example1交给它持有的所有ViewResolver尝试进行解析(本实例中只有InternalResourceViewResolver),然后根据请求的mediaType,再将example1.mediaType(这里是example1.json和example1.html)作为视图名让所有视图解析器解析一遍,两步解析完毕之后会获得一堆候选的List 再加上默认的MappingJackson2JsonView ,最后根据请求的mediatype从候选的List 中选择一个最佳的返回,至此视图解析完毕。
现在就可以理解上例中为何请求链接加上.json 和不.json 结果会不一样。
当加上.json 时,表示请求的mediatype为MediaType.APPLICATION_JSON,而InternalResourceViewResolver 解析出来的视图的ContentType与其不符,而与MappingJackson2JsonView 的ContentType相符,所以选择了MappingJackson2JsonView 作为视图返回。
当不加.json 请求时,默认的mediatype为MediaType.TEXT_HTML,所以就使用了InternalResourceViewResolver解析出来的视图作为返回值了。
我想看到这里你已经大致可以自定义视图了。
3.addViewControllers(ViewControllerRegistryregistry)
此方法可以很方便的实现一个请求到视图的映射,而无需书写controller,例如:
@Override
publicvoidaddViewControllers(ViewControllerRegistryregistry){
registry.addViewController("/login").setViewName("login");
}
这是访问${domain}/login时,会直接返回login页面。
4.addResourceHandlers(ResourceHandlerRegistryregistry)
此方法用来专门注册一个Handler,来处理静态资源的,例如:
图片,js,css等。
举例:
@Override
publicvoidaddResourceHandlers(ResourceHandlerRegistryregistry){
registry.addResourceHandler("/resource/**").addResourceLocations("/WEB-INF/static/");
}
当你请求http:
//localhost:
8083/resource/1.png时,会把/WEB-INF/static/1.png返回。
注意:
这里的静态资源是放置在WEB-INF目录下的。
5.configureDefaultServletHandling(DefaultServletHandlerConfigurerconfigurer)
用法:
@Override
publicvoidconfigureDefaultServletHandling(DefaultServletHandlerConfigurerconfigurer){
configurer.enable();
}
此时会注册一个默认的Handler:
DefaultServletHttpRequestHandler,这个Handler也是用来处理静态文件的,它会尝试映射/*。
当DispatcherServelt映射/时(/ 和/* 是有区别的),并且没有找到合适的Handler来处理请求时,就会交给DefaultServletHttpRequestHandler 来处理。
注意:
这里的静态资源是放置在web根目录下,而非WEB-INF 下。
可能这里的描述有点不好懂(我自己也这么觉得),所以简单举个例子,例如:
在webroot目录下有一个图片:
1.png 我们知道Servelt规范中web根目录(webroot)下的文件可以直接访问的,但是由于DispatcherServlet配置了映射路径是:
/ ,它几乎把所有的请求都拦截了,从而导致1.png 访问不到,这时注册一个DefaultServletHttpRequestHandler 就可以解决这个问题。
其实可以理解为DispatcherServlet破坏了Servlet的一个特性(根目录下的文件可以直接访问),DefaultServletHttpRequestHandler是帮助回归这个特性的。
题外话
问:
/和/* 有什么区别?
答:
/会拦截除了jsp以外的所有url,/* 会拦截所有url,包括jsp。
例如:
在webroot下面有一个test.jsp,当DispatcherServlet配置映射/ 时,浏览器输入:
http:
//localhost:
8083/test.jsp 这个jsp是可以直接访问的,并且不经过DispatcherServlet ,而当DispatcherServlet 配置映射/* 时,这个请求就会被DispatcherServlet 拦截。