Springboot下SpringMVC的常用配置方法

本篇内容主要讲解“Springboot下SpringMVC的常用配置方法”,感兴趣的朋友不妨来看看。本文介绍的方法操作简单快捷,实用性强。下面就让小编来带大家学习“Springboot下SpringMVC的常用配置方法”吧!

我们提供的服务有:成都网站建设、做网站、微信公众号开发、网站优化、网站认证、巴林右旗ssl等。为数千家企事业单位解决了网站和推广的问题。提供周到的售前咨询和贴心的售后服务,是有科学管理、有技术的巴林右旗网站制作公司

一、前言

Sprinboot中配置SpringMVC主要是继承WebMvcConfigurerAdapter(1.x版本)或者WebMvcConfigurationSupport(2.x版本)。这次主要介绍下web应用的一些常用配置。

二、开始配置

(一)配置参数解析器

参数解析器的作用,通俗来说,参数解析器的作用是将请求中的参数映射到我们Controller方法参数,比如说通过参数解析器,我们可以将前端传过来的token参数做一下处理,从redis中取出用户信息,直接映射为一个userInfo对象,然后Controller方法的参数就直接是UserInfo类型的对象就可以了。如何使用勒?下面是一个简单范例,这里只贴出伪代码:

首先我们创建一个解析器类,并且实现HandlerMethodArgumentResolver接口。

public class TokenHandlerMethodArgumentResolver implements HandlerMethodArgumentResolver {
    private RedissonClient redissonClient;
    private UserDao userDao;
    public TokenHandlerMethodArgumentResolver(RedisClient redisClient, UserDao userDao) {
        this.redissonClient = redisClient;
        this.userDao = userDao;
    }
    @Override
    public boolean supportsParameter(MethodParameter methodParameter) {
        return User.class.isAssignableFrom(methodParameter.getParameterType());
    }

    @Override
    public Object resolveArgument(MethodParameter methodParameter, ModelAndViewContainer modelAndViewContainer, NativeWebRequest nativeWebRequest, WebDataBinderFactory webDataBinderFactory) throws Exception{
        HttpServletRequest nativeRequest = (HttpServletRequest) nativeWebRequest.getNativeRequest();
        String token = nativeRequest.getHeader("token");
        RBucket userIdBucket = redissonClient.getBucket(token);
        if(StringUtils.isNotBlank(userIdBucket.get())){
            User user = userDao.getById(userIdBucket.get());
        }
        return user;
    }
}

然后创建类MyWebConfig,继承WebMvcConfigurerAdapter并实现ApplicationContextAware接口,为什么实现ApplicationContextAware,是为了从IOC容器当中取出redissonClient和userDao,用于构造TokenHandlerMethodArgumentResolver。

public class MyWebConfig extends WebMvcConfigurerAdapter implements ApplicationContextAware {
    private UserDao userDao;
    private RedissonClient redissonClient;
    @Override
    public void addArgumentResolvers(List argumentResolvers) {
       argumentResolvers.add(new TokenHandlerMethodArgumentResolver(redissonClient,userDao));
        super.addArgumentResolvers(argumentResolvers);
    }
    @Override
    public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
        userDao = applicationContext.getBean(UserDao.class);
        redissonClient = applicationContext.getBean(RedissonClient.class);
    }
}

如上,HandlerMethodArgumentResolver最重要的两个方法是boolean supportsParameter(MethodParameter methodParameter)Object resolveArgument(MethodParameter methodParameter, ModelAndViewContainer modelAndViewContainer, NativeWebRequest nativeWebRequest, WebDataBinderFactory webDataBinderFactory),前者是如果返回ture表示使用该解析器进行解析,后者就是返回处理后的方法参数。另外例子中比较关键的方法有通过NativeWebRequest获取HttpServletRequest的方法 nativeWebRequest.getNativeRequest()。

这里的逻辑是,如果参数中有参数的类型是User类型,那么直接通过token去获取注入在这里。对于我们来说,如果需要用户信息就只需要在Controller中加个User参数,就自动有了,不需要自己查,就可以很方便的引用用户的相关信息。

(二)配置数据序列化

配置数据序列化有两种方式,一个是通过添加Formatter,一个是添加Converter,两者区别不大,SpingMVC内部处理Formatter时也是包装了一层Converter。同时这里值得注意的是,Formatter和Converter是在SpringMVC使用默认RequestParamMethodArgumentResolver或ServletModelAttributeMethodProcessor参数解析器情况下使用的,如果你自定义了参数解析器,那么其接管的参数,转换规则由自定义参数解析器里面的逻辑来确定。

另外主要被应用于form表单参数或query参数字段,Json传参不是用这个,Json传参默认参数解析器是:RequestResponseBodyMethodProcessor,针对的主要是@RequestBody修饰的方法参数,调用的消息转换器会用Jackson的ObjectMapper来序列化或反序列化,所以如果是JSON传参,配置这个东西没有用。

1.配置Formatter

以配置一个LocalDateTime类与字符串之间的转换为例:

首先新建一个类LocalDateTimeFormatter如下:

public class LocalDateTimeFormatter implements Formatter {
    private static final DateTimeFormatter dateTimeFormatter =  DateTimeFormatter.ofPattern("yyyy-MM-dd HH:ss:mm");
    @Override
    public LocalDateTime parse(String s, Locale locale) throws ParseException {
        return LocalDateTime.parse(s, dateTimeFormatter);
    }

    @Override
    public String print(LocalDateTime localDateTime, Locale locale) {
        return dateTimeFormatter.format(localDateTime);
    }
}

其中parse方法主要是将字符串转换为对象的逻辑,print方法是将对象转换为字符串的逻辑。

然后注册该Formatter,在MyWebConfig重写public void addFormatters(FormatterRegistry registry) 方法:

  @Override
    public void addFormatters(FormatterRegistry registry) {
        registry.addFormatter(new LocalDateTimeFormatter());
        super.addFormatters(registry);
    }

这样,当不是json传参的时候,默认情况下会使用这个自定义的格式化器进行字符串和对象的转换。

2.配置Converter

一般情况下我们使用Formatter替代Converter,两者作用差不多。Converter的好处是因为有两个泛型参数,可以限制需要转换的类型和要转换为的类型,但翻看源码发现在引用converter的时候判断选用哪个converter传入的来源类型貌似都是String(就算query参数是一个数字),感觉formatter已经够用了,这里存疑把。

converter的用法很简单,只需要往spring容器里面注册一个实现了org.springframework.core.convert.converter的bean,除了这种形式,也可以直接注册ConverterFactory实现获取converter的工厂方法 Converter getConverter(Class targetType),用在一个来源类型,多个目标类型的场景。另外还有GenericConverter,需实现Object convert(@Nullable Object source, TypeDescriptor sourceType, TypeDescriptor targetType)方法,用于多个来源类型,多个目标类型的场景,返回值直接为转换后的值。

(三)配置静态资源映射

配置静态资源重写的方法为:void addResourceHandlers(ResourceHandlerRegistry registry),如重写方法为:

 @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/upload/**").addResourceLocations("classpath:/upload/");
        super.addResourceHandlers(registry);
    }

其中addResourceHandler("/upload/**").addResourceLocations("classpath:/upload/")的意思表示将URL:项目访问url+upload/xxx映射到classpath下的upload目录里面名为XXX的静态资源,其中addResourceLocations参数为变长参数,可以映射多个路径,也可以前面加'file:',映射磁盘上任意目录,如:file:/D://upload/,表示映射到d盘的upload目录。

(四)配置过滤器

添加过滤器只需要注册一个FilterRegistrationBean类对象到spring容器即可,如在测试环境注册一个允许跨域的过滤器:

    @Conditional(value = {TestCondition.class})
    @Bean
    public FilterRegistrationBean corsFilter() {
        UrlBasedCorsConfigurationSource urlBasedCorsConfigurationSource =
                new UrlBasedCorsConfigurationSource();
        CorsConfiguration corsConfiguration = new CorsConfiguration();
        corsConfiguration.addAllowedOrigin("*");
        corsConfiguration.addAllowedHeader("*");
        corsConfiguration.addAllowedMethod("*");
        urlBasedCorsConfigurationSource.registerCorsConfiguration("/**", corsConfiguration);
        FilterRegistrationBean filterRegistrationBean = new FilterRegistrationBean();
        filterRegistrationBean.setOrder(10);
        filterRegistrationBean.setFilter(new CorsFilter(urlBasedCorsConfigurationSource));
        filterRegistrationBean.setName("corsFilter");
        filterRegistrationBean.addUrlPatterns("/*");
        return filterRegistrationBean;
    }

@Conditional注解标识在上面表示在测试环境即引用的aplication-test.yml|properties,这里的value应该传入一个org.springframework.context.annotation.Condition接口实现类的Class对象。这里传入的是TestCondition。代码如下:

 @Override
    public boolean matches(ConditionContext conditionContext, AnnotatedTypeMetadata annotatedTypeMetadata) {
        Environment environment = conditionContext.getEnvironment();
        String[] activeProfiles = environment.getActiveProfiles();
        if (null != activeProfiles) {
            for (String x : activeProfiles) {
                if ("test".equals(x)) {
                    return true;
                }
            }
        }
        return false;
    }

另外对于自定义的过滤器,常规操作如下:

  • 继承OncePerRequestFilter抽象类,实现doFilterInternal方法。

  • 将这个Filter对象注入到filterRegistrationBean,并配置其他信息,如order,已经过滤的Url。

如:

@Bean
    public FilterRegistrationBean myFilter() {
        FilterRegistrationBean filterRegistrationBean = new FilterRegistrationBean();
        filterRegistrationBean.setFilter(new MyFilter());
        //order越小,优先级越高
        filterRegistrationBean.setOrder(1);
        filterRegistrationBean.addUrlPatterns("/*");
        filterRegistrationBean.setName("myFilter");
        return filterRegistrationBean;
    }

(四)配置拦截器

拦截器与过滤器的区别在于过滤器的优先级比拦截器高,Filter是作用于Servlet前,而Interceptor则相对于Filter更靠后一点。另外Filter不可以使用IOC容器资源,Interceptor则可以。过滤器能完成的功能,通过Interceptor都可以完成,通常情况下,推荐使用Interceptor。

配置拦截器的步骤是:

1.创建类继承HandlerInterceptorAdapter。

HandlerInterceptorAdapter有三个方法可以重写,未重写前不做任何处理。三个方法是:

//在业务处理器处理请求之前被执行
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)throws Exception {
        return true;
}
//在业务处理器处理请求返回响应之前执行
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView)throws Exception {
}
//返回响应之后执行
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)throws Exception {
}

2.注册拦截器

在MyWebConfig类重写方法void addInterceptors(InterceptorRegistry registry),如:

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        // 可以多个拦截器组成一个拦截器链
        // addPathPatterns 用于添加拦截规则
        // excludePathPatterns 用于排除拦截
        registry.addInterceptor(new MyInterceptor())
                .addPathPatterns("/**")
                .excludePathPatterns("/swagger*/**");
        super.addInterceptors(registry);
    }

三、小结

以上就是基于Springboot下的SpringMVC常用配置方法,基本上能满足常用项目配置需求,其他就暂时不作了解了。

到此,相信大家对“Springboot下SpringMVC的常用配置方法”有了更深的了解,不妨来实际操作一番吧!这里是创新互联网站,更多相关内容可以进入相关频道进行查询,关注我们,继续学习!


当前名称:Springboot下SpringMVC的常用配置方法
当前链接:http://myzitong.com/article/gsspid.html