spring boot 拦截器之WebMvcConfigurerAdapter

来源：互联网发布：python算法教程 pdf 编辑：程序博客网时间：2024/06/03 03:23

上一篇我们讲到了拦截器，我们也简单的讲解到了WebMvcConfigurerAdapter这个拦截器。本篇我们来对WebMvcConfigurerAdapter稍稍的扩展讲解一下。

首先我们来看一下WebMvcConfigurerAdapter 源码

package org.springframework.web.servlet.config.annotation;import java.util.List;import org.springframework.format.FormatterRegistry;import org.springframework.http.converter.HttpMessageConverter;import org.springframework.validation.MessageCodesResolver;import org.springframework.validation.Validator;import org.springframework.web.method.support.HandlerMethodArgumentResolver;import org.springframework.web.method.support.HandlerMethodReturnValueHandler;import org.springframework.web.servlet.HandlerExceptionResolver;public abstract class WebMvcConfigurerAdapter implements WebMvcConfigurer {    @Override    public void configurePathMatch(PathMatchConfigurer configurer) {    }    @Override    public void configureContentNegotiation(ContentNegotiationConfigurer configurer) {    }    @Override    public void configureAsyncSupport(AsyncSupportConfigurer configurer) {    }    @Override    public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {    }    @Override    public void addFormatters(FormatterRegistry registry) {    }    @Override    public void addInterceptors(InterceptorRegistry registry) {    }    @Override    public void addResourceHandlers(ResourceHandlerRegistry registry) {    }    @Override    public void addCorsMappings(CorsRegistry registry) {    }    @Override    public void addViewControllers(ViewControllerRegistry registry) {    }    @Override    public void configureViewResolvers(ViewResolverRegistry registry) {    }/*参数解析*/    @Override    public void addArgumentResolvers(List<HandlerMethodArgumentResolver> argumentResolvers) {    } /*返回值解析*/    @Override    public void addReturnValueHandlers(List<HandlerMethodReturnValueHandler> returnValueHandlers) {    }    @Override    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {    }    @Override    public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {    }/*异常处理解析器*/    @Override    public void configureHandlerExceptionResolvers(List<HandlerExceptionResolver> exceptionResolvers) {    }    @Override    public void extendHandlerExceptionResolvers(List<HandlerExceptionResolver> exceptionResolvers) {    }    @Override    public Validator getValidator() {        return null;    }    @Override    public MessageCodesResolver getMessageCodesResolver() {        return null;    }}

可以看到WebMvcConfigurerAdapter是一个实现了webMvcConfig接口的抽象类，但是里面没有具体的实现，接下来我们着重找几个方法讲解一下：

 /**     * 这里配置视图解析器 **/void configureViewResolvers(ViewResolverRegistry registry);/* 配置内容裁决的一些选项*/void configureContentNegotiation(ContentNegotiationConfigurer configurer);/* 视图跳转控制器 */void addViewControllers(ViewControllerRegistry registry);/**     *静态资源处理**/void addResourceHandlers(ResourceHandlerRegistry registry);/* 默认静态资源处理器 */void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer);

configureViewResolvers(ViewResolverRegistry registry)
　　从方法名称我们就能看出这个方法是用来配置视图解析器的，该方法的参数ViewResolverRegistry 是一个注册器，用来注册你想自定义的视图解析器等。ViewResolverRegistry 常用的几个方法：

１)．enableContentNegotiation

/** 启用内容裁决视图解析器*/public void enableContentNegotiation(View... defaultViews) {    initContentNegotiatingViewResolver(defaultViews);}

　　该方法会创建一个内容裁决解析器ContentNegotiatingViewResolver ，该解析器不进行具体视图的解析，而是管理你注册的所有视图解析器，所有的视图会先经过它进行解析，然后由它来决定具体使用哪个解析器进行解析。具体的映射规则是根据请求的media types来决定的。
2). 　UrlBasedViewResolverRegistration

    public UrlBasedViewResolverRegistration jsp(String prefix, String suffix) {        InternalResourceViewResolver resolver = new InternalResourceViewResolver();        resolver.setPrefix(prefix);        resolver.setSuffix(suffix);        this.viewResolvers.add(resolver);        return new UrlBasedViewResolverRegistration(resolver);    }

　　该方法会注册一个内部资源视图解析器InternalResourceViewResolver 显然访问的所有jsp都是它进行解析的。该方法参数用来指定路径的前缀和文件后缀，如：　　

registry.jsp("/WEB-INF/jsp/", ".jsp");

　　对于以上配置，假如返回的视图名称是example，它会返回/WEB-INF/jsp/example.jsp给前端，找不到则报404。
　　

3). 　beanName

    public void beanName() {        BeanNameViewResolver resolver = new BeanNameViewResolver();        this.viewResolvers.add(resolver);    }

　　该方法会注册一个BeanNameViewResolver 视图解析器，这个解析器是干嘛的呢？它主要是将视图名称解析成对应的bean。什么意思呢？假如返回的视图名称是example，它会到spring容器中找有没有一个叫example的bean，并且这个bean是View.class类型的？如果有，返回这个bean。
　　

4). 　viewResolver

    public void viewResolver(ViewResolver viewResolver) {        if (viewResolver instanceof ContentNegotiatingViewResolver) {            throw new BeanInitializationException(                    "addViewResolver cannot be used to configure a ContentNegotiatingViewResolver. Please use the method enableContentNegotiation instead.");        }        this.viewResolvers.add(viewResolver);    }

　　这个方法想必看名字就知道了，它就是用来注册各种各样的视图解析器的，包括自己定义的。

2. configureContentNegotiation(ContentNegotiationConfigurer configurer)

　　上面一节我们讲了configureViewResolvers 方法，假如在该方法中我们启用了内容裁决解析器，那么configureContentNegotiation(ContentNegotiationConfigurer configurer) 这个方法是专门用来配置内容裁决的一些参数的。这个比较简单，我们直接通过一个例子看：
　　

 public void configureContentNegotiation(ContentNegotiationConfigurer configurer) {       /* 是否通过请求Url的扩展名来决定media type */        configurer.favorPathExtension(true)                   /* 不检查Accept请求头 */                .ignoreAcceptHeader(true)                .parameterName("mediaType")                 /* 设置默认的media yype */                .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    public class MyWebMvcConfigurerAdapte extends WebMvcConfigurerAdapter {        @Override        public void configureViewResolvers(ViewResolverRegistry registry) {            registry.jsp("/WEB-INF/jsp/", ".jsp");            registry.enableContentNegotiation(new MappingJackson2JsonView());        }        @Override        public void configureContentNegotiation(ContentNegotiationConfigurer configurer) {            configurer.favorPathExtension(true)                    .ignoreAcceptHeader(true)                    .parameterName("mediaType")                    .defaultContentType(MediaType.TEXT_HTML)                    .mediaType("html", MediaType.TEXT_HTML)                    .mediaType("json", MediaType.APPLICATION_JSON);        }    }

controller的代码如下:

    @Controller    public class ExampleController {         @RequestMapping("/test")         public ModelAndView test() {            Map<String, String> map = new HashMap();            map.put("哈哈", "哈哈哈哈");            map.put("呵呵", "呵呵呵呵");            return new ModelAndView("test", map);        }    }

在WEB-INF/jsp目录下创建一个test.jsp文件，内容随意。现在启动tomcat，在浏览器输入以下链接：http://localhost:8080/test.json，浏览器内容返回如下：

{    "哈哈":"哈哈哈哈",    "呵呵":"呵呵呵呵"}

在浏览器输入http://localhost:8080/test 或者http://localhost:8080/test.html，内容返回如下：

this is test.jsp

　
显然，两次使用了不同的视图解析器，那么底层到底发生了什么？在配置里我们注册了两个视图解析器：ContentNegotiatingViewResolver 和 InternalResourceViewResolver，还有一个默认视图：MappingJackson2JsonView。controller执行完毕之后返回一个ModelAndView，其中视图的名称为example1。

1.返回首先会交给ContentNegotiatingViewResolver 进行视图解析处理，而ContentNegotiatingViewResolver 会先把视图名example1交给它持有的所有ViewResolver尝试进行解析（本实例中只有InternalResourceViewResolver），2.根据请求的mediaType，再将example1.mediaType（这里是example1.json 和example1.html）作为视图名让所有视图解析器解析一遍，两步解析完毕之后会获得一堆候选的List<View> 再加上默认的MappingJackson2JsonView ，3.根据请求的media type从候选的List<View> 中选择一个最佳的返回，至此视图解析完毕。

现在就可以理解上例中为何请求链接加上.json 和不.json 结果会不一样。当加上.json 时，表示请求的media type 为MediaType.APPLICATION_JSON，而InternalResourceViewResolver 解析出来的视图的ContentType与其不符，而与MappingJackson2JsonView 的ContentType相符，所以选择了MappingJackson2JsonView 作为视图返回。当不加.json 请求时，默认的media type 为MediaType.TEXT_HTML，所以就使用了InternalResourceViewResolver解析出来的视图作为返回值了。我想看到这里你已经大致可以自定义视图了。

3. addViewControllers(ViewControllerRegistry registry)

　　此方法可以很方便的实现一个请求到视图的映射，而无需书写controller，例如：
　　

    @Override      public void addViewControllers(ViewControllerRegistry registry){          registry.addViewController("/login").setViewName("forward:/index.html");      }

　　这是访问${domain}/login时，会直接返回login页面。

4. addResourceHandlers(ResourceHandlerRegistry registry)

　　此方法用来专门注册一个Handler，来处理静态资源的，例如：图片，js，css等。举例：
　　

    @Override    public void addResourceHandlers(ResourceHandlerRegistry registry) {        registry.addResourceHandler("/resource/**").addResourceLocations("/WEB-INF/static/");    }

　　当你请求http://localhost:8083/resource/1.png时，会把/WEB-INF/static/1.png返回。注意：这里的静态资源是放置在WEB-INF目录下的。

5. configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer)

　　用法：

    @Override    public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {        configurer.enable();        configurer.enable("defaultServletName");    }

　　此时会注册一个默认的Handler：DefaultServletHttpRequestHandler，这个Handler也是用来处理静态文件的，它会尝试映射/。当DispatcherServelt映射/时（/ 和/ 是有区别的），并且没有找到合适的Handler来处理请求时，就会交给DefaultServletHttpRequestHandler 来处理。注意：这里的静态资源是放置在web根目录下，而非WEB-INF 下。
　　可能这里的描述有点不好懂（我自己也这么觉得），所以简单举个例子，例如：在webroot目录下有一个图片：1.png 我们知道Servelt规范中web根目录（webroot）下的文件可以直接访问的，但是由于DispatcherServlet配置了映射路径是：/ ，它几乎把所有的请求都拦截了，从而导致1.png 访问不到，这时注册一个DefaultServletHttpRequestHandler 就可以解决这个问题。其实可以理解为DispatcherServlet破坏了Servlet的一个特性（根目录下的文件可以直接访问），DefaultServletHttpRequestHandler是帮助回归这个特性的。

阅读全文

0 0