脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 软件编程 → java → WebMvcConfigurer接口配置

Springboot实现WebMvcConfigurer接口定制mvc配置详解

 更新时间：2023年09月20日 10:43:28   作者：CD4356  
这篇文章主要介绍了Springboot实现WebMvcConfigurer接口定制mvc配置详解,spring boot抛弃了传统xml配置文件,通过配置类(标注@Configuration的类,@Configuration配置类相当于一个xml配置文件)以JavaBean形式进行相关配置,需要的朋友可以参考下

引言

spring boot抛弃了传统xml配置文件，通过配置类(标注@Configuration的类，@Configuration配置类相当于一个xml配置文件)以JavaBean形式进行相关配置。

正常情况下，spring boot的自动配置可以满足我们的大部分需求。但在保留spring boot提供的便利，又需要增加额外SpringMVC配置的时候，可以自定义一个配置类(标注@Configuration的类)并实现WebMvcConfigurer接口来定制SpringMvc配置

SpringBoot 1.5通过继承WebMvcConfigurerAdapter抽象类来定制SpringMvc配置。SpringBoot 2.0后，WebMvcConfigurerAdapter抽象类过时了，改为实现WebMvcConfigurer接口来定制SpringMvc配置

/**
 * SpringBoot 1.5
 */	
@Configuration
public class SpringMvcConfiguration extends WebMvcConfigurerAdapter {
}
-------------------------------------------------------------------------------------------
/**
 * SpringBoot 2.0
 */
@Configuration
public class SpringMvcConfiguration implements WebMvcConfigurer {
}

WebMvcConfigurer接口源码，具体可看WebMvcConfigurer官方文档

package org.springframework.web.servlet.config.annotation;
import java.util.List;
import org.springframework.core.convert.converter.Converter;
import org.springframework.format.Formatter;
import org.springframework.format.FormatterRegistry;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.lang.Nullable;
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.DispatcherServlet;
import org.springframework.web.servlet.HandlerExceptionResolver;
import org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter;
/**
 * 采用JavaBean的形式代替传统的xml配置文件对Spring MVC进行定制
 */
public interface WebMvcConfigurer {
	//帮助配置HandlerMappings路径匹配选项，例如尾部斜杠匹配，后缀注册，路径匹配器和路径帮助器
	default void configurePathMatch(PathMatchConfigurer configurer) {
	}
	//配置内容协商选项
	default void configureContentNegotiation(ContentNegotiationConfigurer configurer) {
	}
	//配置异步请求处理选项
	default void configureAsyncSupport(AsyncSupportConfigurer configurer) {
	}
	//通过转发到Servlet容器的“默认” Servlet，配置处理程序以委派未处理的请求
	default void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
	}
	//除了默认注册的之外，还添加Converters和Formatters
	default void addFormatters(FormatterRegistry registry) {
	}
	//添加Spring MVC生命周期拦截器，以对控制器方法调用和资源处理程序请求进行预处理
	default void addInterceptors(InterceptorRegistry registry) {
	}
	//添加处理程序以从Web应用程序根目录，类路径等中的特定位置提供静态资源，例如图像，js和css文件
	default void addResourceHandlers(ResourceHandlerRegistry registry) {
	}
	//配置跨源请求处理
	default void addCorsMappings(CorsRegistry registry) {
	}
	//配置预先配置了响应状态代码和/或用于呈现响应主体的视图的简单自动化控制器
	default void addViewControllers(ViewControllerRegistry registry) {
	}
	//配置视图解析器，以将从控制器返回的基于字符串的视图名称转换为具体的View 实现以执行渲染
	default void configureViewResolvers(ViewResolverRegistry registry) {
	}
	//添加解析器以支持自定义控制器方法参数类型
	default void addArgumentResolvers(List<HandlerMethodArgumentResolver> resolvers) {
	}
	//添加处理程序以支持自定义控制器方法返回值类型
	default void addReturnValueHandlers(List<HandlerMethodReturnValueHandler> handlers) {
	}
	//配置HttpMessageConverters用于读取或写入请求或响应主体的
	default void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
	}
	//提供MessageCodesResolver用于从数据绑定和验证错误代码构建消息代码的自定义
	default void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
	}
	//配置异常解析器
	default void configureHandlerExceptionResolvers(List<HandlerExceptionResolver> resolvers) {
	}
	//扩展或修改默认配置的异常解析器列表
	default void extendHandlerExceptionResolvers(List<HandlerExceptionResolver> resolvers) {
	}
	//提供MessageCodesResolver用于从数据绑定和验证错误代码构建消息代码的自定义
	default MessageCodesResolver getMessageCodesResolver() {
		return null;
	}
}

WebMvcConfigurer接口中定义了许多SpringMvc相关的方法，通过在配置类中重写相应的方法即可定制相关的SpringMvc配置，下面我会挑几个较常用的方法进行解析

自定义静态资源映射 addResourceHandlers()

spring boot默认将 /** 静态资源访问映射到 classpath:/static/ 目录下.

如果spring boot的默认配置不能满足你的需求或你想修改它的默认配置，则可定义一个配置类来实现WebMvcConfigurer接口，并重写它的addResourceHandlers()方法来定制静态资源访问映射访问映射。

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.*;
@Configuration
public class SpringMvcConfiguration implements WebMvcConfigurer {
    /**
     * 添加静态资源访问映射配置
     * @param registry
     */
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/js/**").addResourceLocations("classpath:/static/js/");
        registry.addResourceHandler("/css/**").addResourceLocations("classpath:/static/css/");
        registry.addResourceHandler("/image/**").addResourceLocations("classpath:/static/image/");
        //意思是：url中读取到/upload时，就会自动将/upload解析成D:/idea/java_workspace/image/upload
        registry.addResourceHandler("/upload/**").addResourceLocations("file:D:/idea/java_workspace/image/upload/");
        /**
         * Linux系统
         * registry.addResourceHandler("/upload/**").addResourceLocations("file:/home/image/upload/");
         */
    }
}
  • addResourceHandler(“xxx”) 用于指定对外暴露的访问路径；
  • addResourceLocations(“xxx”) 用于指定文件放置的目录；

文件的放置目录分两种：项目内部的文件 和 项目外部的文件；具体配置方式如下：

//配置内部静态资源文件访问映射
registry.addResourceHandler("/image/**").addResourceLocations("classpath:/static/image/");
//配置外部静态资源文件访问映射（Windows系统）
registry.addResourceHandler("/image/**").addResourceLocations("file:D:/idea/java_workspace/image/");
//配置外部静态资源文件访问映射（Linux系统）
registry.addResourceHandler("/image/**").addResourceLocations("file:/home/image/");

友情提示：内部静态资源文件一般使用spring boot的默认配置即可(即：将 /** 静态资源访问映射到 classpath:/static/ 目录)；重写addResourceHandlers()方法一般用来定制外部静态资源的访问映射。

拦截器 addInterceptors()

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.*;
@Configuration
public class SpringMvcConfiguration implements WebMvcConfigurer {
    /**
     * 添加拦截器链配置
     * @param registry
     */
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        //注册拦截器1，对商家管理系统进行权限验证
        InterceptorRegistration registration1 = registry.addInterceptor(new ShopAdminInterceptor());
        //指定拦截器1要拦截的请求(支持*通配符)
        registration1.addPathPatterns("/shop_admin/**");
        //注册拦截器2，对超级管理员系统进行权限验证
        InterceptorRegistration registration2 = registry.addInterceptor(new SuperAdminInterceptor());
        /*指定拦截器2要拦截的请求(支持*通配符)*/
        registration2.addPathPatterns("/super_admin/**");
        //指定拦截器2不拦截的请求(支持*通配符)
        registration2.excludePathPatterns("/super_admin/toLogin");
    }
}

自定义拦截器类1

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class ShopAdminInterceptor extends HandlerInterceptorAdapter {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        //获取用户登陆信息
        Person person = (Person) request.getSession().getAttribute("person");
        //判断用户是否有权限进入商家管理后台系统
        if(person != null && person.getUserId() > 0
                && person.getEnableStatus() == 1 && person.getPersonType() == 2){
            //如果验证通过，则返回true，放行请求，即用户接下来的操作可以正常执行
            return true;
        }
        //如果不满足登陆验证，则跳转到登陆页面
        response.sendRedirect("/o2o/local/to_login");
        return false;
    }
}

自定义拦截器类2

import com.cd.o2o2.entity.Person;
import org.springframework.web.servlet.handler.HandlerInterceptorAdapter;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class SuperAdminInterceptor extends HandlerInterceptorAdapter {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        //获取用户登陆信息
        Person person = (Person) request.getSession().getAttribute("person");
        //判断用户是否有权限进入超级管理员后台系统
        if(person != null && person.getUserId() > 0
                && person.getEnableStatus() == 1 && person.getPersonType() == 3){
            //如果验证通过，则返回true，放行请求，即用户接下来的操作可以正常执行
            return true;
        }
        //如果不满足登陆验证，则跳转到登陆页面
        response.sendRedirect("/o2o/local/to_login");
        return false;
    }
}

无业务逻辑页面跳转 addViewControllers()

项目开发中，时常会涉及到无业务逻辑的页面跳转; 这个页面跳转没有涉及到任何的业务逻辑，只是单纯的路由跳转过程；但却需要在Controller中编写路由方法来完成，每一个页面跳转都需要定义一个路由方法，个人感觉是挺麻烦滴。

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
@RequestMapping("/frontend")
public class FrontendController {
    /**
     * 首页路由
     */
    @RequestMapping("/index")
    private String index(){
        return "frontend/index";
    }
    /**
     * 店铺列表路由
     */
    @RequestMapping("/to_shop_list")
    private String toShopList(){
        return "frontend/shop_list";
    }
    /**
     * 店铺列表路由
     */
    @RequestMapping("/shop_detail")
    private String shopDetail(){
        return "frontend/shop_detail";
    }
}

SpringBoot中，可以通过重写addViewControllers()方法来配置无业务逻辑的页面跳转; 摆脱路由方法这个麻烦，当然你习惯使用路由方法来实现无业务逻辑的页面跳转也是没问题滴哦.

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.*;
@Configuration
public class SpringMvcConfiguration implements WebMvcConfigurer {
   	/**
     * 添加无业务逻辑页面跳转配置
     * @param registry
     */
    @Override
    public void addViewControllers(ViewControllerRegistry registry) {
        //首页路由
        registry.addViewController("/frontend/index").setViewName("frontend/index");
        //店铺列表路由
        registry.addViewController("/frontend/to_shop_list").setViewName("frontend/shop_list");
        //店铺列表路由
        registry.addViewController("/frontend/shop_detail").setViewName("frontend/shop_detail");
    }
}

合而为一

package com.cd.o2o2.config.web;
import com.cd.o2o2.interceptor.ShopAdminInterceptor;
import com.cd.o2o2.interceptor.SuperAdminInterceptor;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.*;
@Configuration
public class SpringMvcConfiguration implements WebMvcConfigurer {
    /**
     * 添加静态资源访问映射配置
     */
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
    	//内部静态资资源访问映射
        registry.addResourceHandler("/js/**").addResourceLocations("classpath:/static/js/");
        registry.addResourceHandler("/css/**").addResourceLocations("classpath:/static/css/");
        registry.addResourceHandler("/image/**").addResourceLocations("classpath:/static/image/");
       //外部静态资资源访问映射
        registry.addResourceHandler("/upload/**").addResourceLocations("file:D:/idea/java_workspace/image/upload/");
    }
    /**
     * 添加拦截器链配置
     */
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        //注册拦截器1，对商家管理系统进行权限验证
        InterceptorRegistration registration1 = registry.addInterceptor(new ShopAdminInterceptor());
        //指定拦截器1要拦截的请求(支持*通配符)
        registration1.addPathPatterns("/shop_admin/**");
        //注册拦截器2，对超级管理员系统进行权限验证
        InterceptorRegistration registration2 = registry.addInterceptor(new SuperAdminInterceptor());
        //指定拦截器2要拦截的请求(支持*通配符)
        registration2.addPathPatterns("/super_admin/**");
    }
    /**
     * 添加无业务逻辑页面跳转配置
     */
    @Override
    public void addViewControllers(ViewControllerRegistry registry) {
        //首页路由
        registry.addViewController("/frontend/index").setViewName("frontend/index");
        //店铺列表路由
        registry.addViewController("/frontend/to_shop_list").setViewName("frontend/shop_list");
        //店铺列表路由
        registry.addViewController("/frontend/shop_detail").setViewName("frontend/shop_detail");
    }
}

到此这篇关于Springboot实现WebMvcConfigurer接口定制mvc配置详解的文章就介绍到这了,更多相关WebMvcConfigurer接口配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

相关文章

  • Java静态代码块加载驱动代码实例

    Java静态代码块加载驱动代码实例

    这篇文章主要介绍了Java静态代码块加载驱动代码实例,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-07-07
  • 创建并运行一个java线程方法介绍

    创建并运行一个java线程方法介绍

    这篇文章主要介绍了创建并运行一个java线程，涉及线程代码示例，具有一定参考价值，需要的朋友可以了解下。
    2017-11-11
  • 非常适合新手学生的Java线程池优化升级版

    非常适合新手学生的Java线程池优化升级版

    作者是一个来自河源的大三在校生，以下笔记都是作者自学之路的一些浅薄经验，如有错误请指正，将来会不断的完善笔记，帮助更多的Java爱好者入门
    2022-03-03
  • JAVA实现较完善的布隆过滤器的示例代码

    JAVA实现较完善的布隆过滤器的示例代码

    这篇文章主要介绍了JAVA实现较完善的布隆过滤器的示例代码，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
    2018-10-10
  • java基础类型源码解析之多角度讲HashMap

    java基础类型源码解析之多角度讲HashMap

    这篇文章主要给大家介绍了关于java基础类型源码解析之HashMap的相关资料，文中通过示例代码介绍的非常详细，对大家学习或者使用java基具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧
    2019-07-07
  • SpringBoot应用部署于外置Tomcat容器的方法

    SpringBoot应用部署于外置Tomcat容器的方法

    这篇文章主要介绍了SpringBoot应用部署于外置Tomcat容器的方法,本文分步骤给大家介绍的非常详细，具有一定的参考借鉴价值，需要的朋友可以参考下
    2018-06-06
  • 解决mybatis-plus新增数据自增ID变无序问题

    解决mybatis-plus新增数据自增ID变无序问题

    这篇文章主要介绍了解决mybatis-plus新增数据自增ID变无序问题，具有很好的参考价值，希望对大家有所帮助。
    2023-07-07
  • Java多线程编程之Lock用法实例

    Java多线程编程之Lock用法实例

    这篇文章主要介绍了Java多线程编程之Lock用法实例,本文直接给出代码实例,需要的朋友可以参考下
    2015-05-05
  • Java面向对象之猜拳游戏

    Java面向对象之猜拳游戏

    这篇文章主要为大家详细介绍了Java面向对象之猜拳游戏，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
    2021-05-05
  • Java冒泡排序简单实现

    Java冒泡排序简单实现

    这篇文章主要介绍了Java冒泡排序简单实现，具有一定借鉴价值，需要的朋友可以参考下。
    2017-12-12

最新评论