SpringBoot - WebMvcConfigurer的作用是什么

这篇具有很好参考价值的文章主要介绍了SpringBoot - WebMvcConfigurer的作用是什么。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

WebMvcConfigurer是一个接口,用于配置全局的SpringMVC的相关属性,采用JAVABEAN的方式来代替传统的XML配置文件,提供了跨域设置、静态资源处理器、类型转化器、自定义拦截器、页面跳转等能力。
WebMvcConfigurer 在 Spring Boot 2.x 中官方建议使用该接口来实现自定义配置。所以,Spring Boot 2.x 中,自定义 SpringMVC 配置可以通过实现 WebMvcConfigurer 接口来完成。
源码说明

public interface WebMvcConfigurer {
    //  配置路径匹配规则
    default void configurePathMatch(PathMatchConfigurer configurer) { }

    // 内容协商
    default void configureContentNegotiation(ContentNegotiationConfigurer configurer) { }
    
    // 异步调用支持
    default void configureAsyncSupport(AsyncSupportConfigurer configurer) { }

    // 静态资源默认处理器
    default void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) { }

    // 格式化器, 可以把时间转化成你需要时区或者格式,还可以将对象A转换为对象B。
    default void addFormatters(FormatterRegistry registry) { }

    // 请求拦截器
    default void addInterceptors(InterceptorRegistry registry) { }

    // 静态资源映射器
    default void addResourceHandlers(ResourceHandlerRegistry registry) { }

    // 跨域设置
    default void addCorsMappings(CorsRegistry registry) { }

    // 视图控制器
    default void addViewControllers(ViewControllerRegistry registry) { }

    // 视图解析器
    default void configureViewResolvers(ViewResolverRegistry registry) { }

    // 参数处理器
    default void addArgumentResolvers(List<HandlerMethodArgumentResolver> resolvers) { }

    // 返回值处理器
    default void addReturnValueHandlers(List<HandlerMethodReturnValueHandler> handlers) { }

    // 信息转化器
    default void configureMessageConverters(List<HttpMessageConverter<?>> converters) { }

    // 信息转化器扩展
    default void extendMessageConverters(List<HttpMessageConverter<?>> converters) { }

    // 异常处理器
    default void configureHandlerExceptionResolvers(List<HandlerExceptionResolver> resolvers) { }

    // 异常处理器扩展
    default void extendHandlerExceptionResolvers(List<HandlerExceptionResolver> resolvers) { }

    @Nullable
    default Validator getValidator() {
        return null;
    }

    @Nullable
    default MessageCodesResolver getMessageCodesResolver() {
        return null;
    }
}

   

常用示例
① 配置路径匹配规则

@Override
public void configurePathMatch(PathMatchConfigurer configurer) {
    // 是否使用尾斜杠匹配, 默认为TRUE。TRUE, 表示"/hello"和"/hello/"都能匹配。
    configurer.setUseTrailingSlashMatch(false);
 
    // 为所有的接口添加统一前缀。如果的URL为: "/hello", 则转换为: "/api/hello"
    configurer.addPathPrefix("api", c -> c.isAnnotationPresent(RestController.class));
 
    // UrlPathHelper是一个处理URL地址的帮助类, 自带了一些优化URL的方法;
    // 如:getSanitizedPath,就是将"//"自动转换为"/", 所以当输入为"//"也是没有问题的,
    UrlPathHelper urlPathHelper = new UrlPathHelper();
    configurer.setUrlPathHelper(urlPathHelper);
}

② 配置静态资源映射器

用于自定义静态资源的映射目录。

// addResourceHandler:用于设置对外暴露的访问路径
// addResourceLocations:用于映射内部文件放置的目录,需要以“/”结尾

@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
    /** 本地文件上传路径 */
    // 对外暴露的访问路径
    registry.addResourceHandler(Constants.RESOURCE_PREFIX + "/**")
    // 映射内部文件放置的目录,以“/”结尾
            .addResourceLocations("file:" + ServicexConfig.getProfile() + "/");

    /** swagger配置 */
    registry.addResourceHandler("/swagger-ui/**")
            .addResourceLocations("classpath:/META-INF/resources/webjars/springfox-swagger-ui/");
}

③ 配置请求拦截器

可以设置多个拦截器,如对特定的URL设定处理规则、打印处理用户请求耗费的时间、定义防止重复提交等功能。

@Override
public void addInterceptors(InterceptorRegistry registry) {
    // 增加一个拦截器,对请求做一些自定义处理
    registry.addInterceptor(new HandlerInterceptor() {
        @Override
        public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
            Object user = request.getSession().getAttribute("loginUser");
            if (user == null) {   //未登陆,返回登陆页面
                request.setAttribute("msg", "没有权限请先登陆");
                request.getRequestDispatcher("/index.html").forward(request, response);
                return false;
            } else {  //已登陆,放行请求
                return true;
            }
        }
    })
    // 设置拦截器的过滤路径规则:只拦截/admin/形式的请求
    .addPathPatterns("/admin/**")
    // 设置不需要拦截的过滤规则:不拦截/admin/login请求
    .excludePathPatterns("/admin/login");
}

④ 跨域设置

方法一:
@Override
public void addCorsMappings(CorsRegistry registry) {
    // 设置允许跨域的路径
    registry.addMapping("/**")
            // 设置允许跨域请求的域名
            .allowedOrigins("*")
            // 是否允许证书
            .allowCredentials(true)
            // 设置允许的方法
            .allowedMethods("GET", "POST", "DELETE", "PUT")
            // 设置允许的header属性
            .allowedHeaders("*")
            // 跨域允许时间
            .maxAge(3600);
}

方法二:
/**
 * 跨域配置
 */
@Bean
public CorsFilter corsFilter() {
    CorsConfiguration config = new CorsConfiguration();
    config.setAllowCredentials(true);
    // 设置访问源地址
    config.addAllowedOriginPattern("*");
    // 设置访问源请求头
    config.addAllowedHeader("*");
    // 设置访问源请求方法
    config.addAllowedMethod("*");
    // 有效期 1800秒
    config.setMaxAge(1800L);
    // 添加映射路径,拦截一切请求
    UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
    source.registerCorsConfiguration("/**", config);
    // 返回新的CorsFilter
    return new CorsFilter(source);
}

⑤ 视图控制器

用于将请求的URL进行处理。

@Override
public void addViewControllers(ViewControllerRegistry registry) {
    // 如果请求为:/admin,则重定向到/login
    registry.addRedirectViewController("/admin", "/login");
    // 如果请求为:/admin/delete,则返回500状态
    registry.addStatusController("/admin/delete", HttpStatus.INTERNAL_SERVER_ERROR);
    // 如果请求URL为:/hello,则直接跳转到hello页面
    registry.addViewController("/hello").setViewName("hello");
}

⑥ 内容协商

用于将一个URL直接跳转到页面。

@Override
public void configureContentNegotiation(ContentNegotiationConfigurer configurer) {
    // 自定义策略
    configurer.favorPathExtension(true)// 是否通过请求Url的扩展名来决定mediaType,默认true
            .ignoreAcceptHeader(true)// 不检查Accept请求头
            .parameterName("mediaType")
            .defaultContentType(MediaType.TEXT_HTML)// 设置默认的MediaType
            .mediaType("html", MediaType.TEXT_HTML)// 请求以.html结尾的会被当成MediaType.TEXT_HTML
            .mediaType("json", MediaType.APPLICATION_JSON)// 请求以.json结尾的会被当成MediaType.APPLICATION_JSON
            .mediaType("xml", MediaType.APPLICATION_ATOM_XML);// 请求以.xml结尾的会被当成MediaType.APPLICATION_ATOM_XML
}

⑦ 信息转化器扩展

自定义FASTJSON为JSON消息的转换器,完成的功能如下:
1、请求返回体使用FASTJSON来序列化;
2、配置如果字段类型为Date,输出为"yyyy-MM-dd HH:mm:ss"格式;
3、配置允许输出值为null的字段;
4、配置字符类型字段,如果为null,输出为"",而非null;
5、配置把Long类型的数据序列化成JSON后传给前端,解决前端可能会出现精度丢失的情况。

@Override
public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
    //1、首先定义一个convert消息转换对象
    FastJsonHttpMessageConverter converter = new FastJsonHttpMessageConverter();

    //2、定义支持的mediaType类型,处理中文乱码的相关问题
    List<MediaType> mediaTypes = new ArrayList<>();
    mediaTypes.add(MediaType.APPLICATION_JSON);      // 返回JSON格式
    mediaTypes.add(MediaType.APPLICATION_JSON_UTF8); // 处理输出中文乱码
    mediaTypes.add(MediaType.TEXT_HTML);
    mediaTypes.add(new MediaType("application", "xml"));
    mediaTypes.add(new MediaType("text", "xml"));
    mediaTypes.add(new MediaType("application", "*+xml"));
    mediaTypes.add(MediaType.ALL);
    converter.setSupportedMediaTypes(mediaTypes);

    //3. 创建配置类
    FastJsonConfig fastJsonConfig = new FastJsonConfig();
    fastJsonConfig.setCharset(Charset.forName("UTF-8")); // 全局编码
    fastJsonConfig.setDateFormat("yyyy-MM-dd HH:mm:ss"); // 全局时间格式化

    //4. 格式化返回内容
    SerializerFeature[] serializerFeatures = new SerializerFeature[]{
            SerializerFeature.PrettyFormat,             // 格式化
            SerializerFeature.WriteMapNullValue,        // 输出空值
            SerializerFeature.WriteNullListAsEmpty,     // List字段如果为null,输出为[],而非null
            SerializerFeature.WriteDateUseDateFormat,   // 日期格式化
            SerializerFeature.WriteNullStringAsEmpty,   // 字符类型字段如果为null,输出为"",而非null
            SerializerFeature.WriteNullBooleanAsFalse,  // Boolean字段如果为null,输出为false,而非null
            SerializerFeature.DisableCircularReferenceDetect, //消除对同一对象循环引用的问题,默认为false(如果不配置有可能会进入死循环)
            SerializerFeature.WriteNullNumberAsZero     //数字类型如果为null,输出为0,而非null
    };
    fastJsonConfig.setSerializerFeatures(serializerFeatures);

    //5. 配置Java类型对应的序列化类,序列换成json时, 将所有的long变成string,解决Long转json精度丢失的问题,因为js中得数字类型不能包含所有的java long值
    SerializeConfig serializeConfig = SerializeConfig.globalInstance;
    serializeConfig.put(BigInteger.class, ToStringSerializer.instance);
    serializeConfig.put(Long.class, ToStringSerializer.instance);
    serializeConfig.put(Long.TYPE, ToStringSerializer.instance);
    fastJsonConfig.setSerializeConfig(serializeConfig);

    converter.setFastJsonConfig(fastJsonConfig);
    converters.add(0,converter);
}

 
 
 

其他方式

A. WebMvcConfigurerAdapter
B. WebMvcConfigurationSupport
C. @EnableWebMvc
A. WebMvcConfigurerAdapter

在 Spring Boot 1.x 中我们自定义 SpringMVC 时继承的一个抽象类,这个抽象类本身是实现了 WebMvcConfigurer 接口。从 Spring5 开始,官方建议直接实现 WebMvcConfigurer 接口,而不是继承 WebMvcConfigurerAdapter。
B. WebMvcConfigurationSupport

在纯 Java 配置的 SSM 环境中,如果我们要自定义 SpringMVC 配置,有两种办法:
第一种就是直接继承自 WebMvcConfigurationSupport 来完成 SpringMVC 配置;
还有一种方案就是实现 WebMvcConfigurer 接口来完成自定义 SpringMVC 配置,如果使用第二种方式,则需要给 SpringMVC 的配置类上额外添加 @EnableWebMvc 注解,表示启用 WebMvcConfigurationSupport,这样配置才会生效。
C. @EnableWebMvc

如果在 Spring Boot 中使用了 @EnableWebMvc 注解,就会导致 Spring Boot 中默认的 SpringMVC 自动化配置失效,所以不建议使用该方式。
————————————————
版权声明:本文为CSDN博主「cloneme01」的原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接及本声明。
原文链接:https://blog.csdn.net/goodjava2007/article/details/126132375文章来源地址https://www.toymoban.com/news/detail-612949.html

到了这里,关于SpringBoot - WebMvcConfigurer的作用是什么的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • 拆解Spring boot:Springboot为什么如此丝滑而简单?源码剖析解读自动装配

    🎉🎉欢迎光临,终于等到你啦🎉🎉 🏅我是苏泽,一位对技术充满热情的探索者和分享者。🚀🚀 🌟持续更新的专栏 《Spring 狂野之旅:从入门到入魔》 🚀 本专栏带你从Spring入门到入魔   这是苏泽的个人主页可以看到我其他的内容哦👇👇 努力的苏泽 http://suzee.blog.csdn

    2024年03月23日
    浏览(33)
  • 2023 最新版IntelliJ IDEA 2023.1创建Java Web前(vue3)后端(spring-boot3)分离 项目详细步骤(图文详解)

    2023 最新版IntelliJ IDEA 2023.1创建Java Web 项目详细步骤(图文详解) 本篇使用当前Java Web开发主流的spring-boot3框架来创建一个Java前后端分离的项目,前端使用的也是目前前端主流的vue3进行一个简单的项目搭建,让你距离Java全栈开发更近一步 🏴‍☠️。 使用版本: “17.0.1”

    2024年02月12日
    浏览(76)
  • Spring boot @ConditionalOnProperty 使用以及作用

    来源 即: 来源于Spring boot 中的自动化配置部分 实际作用: 通过读取本地配置文件中的值来判断 某些 Bean 或者 配置类 是否加入spring 中。 即 当前类通过 @Component 或者 @Configuration 注册实体到spring 中时,都可以通过 @ConditionalOnProperty 来控制是否加入或者说有无该项。 与 @Com

    2024年02月09日
    浏览(37)
  • 常用的 Spring Boot 注解及其作用

    Spring Boot 提供了许多注解来简化开发,并帮助开发者在 Spring 应用中实现各种功能。以下是一些常用的 Spring Boot 注解及其作用: @SpringBootApplication : 作用:用于标识主启动类,通常位于 Spring Boot 应用的入口类上。 功能:该注解整合了三个常用注解: @Configuration 、 @EnableAut

    2024年04月25日
    浏览(49)
  • Spring Boot 整合 Shiro(后端)

    1 Shiro 什么是 Shiro 官网: http://shiro.apache.org/ 是一款主流的 Java 安全框架,不依赖任何容器,可以运行在 Java SE 和 Java EE 项目中,它的主要作用是对访问系统的用户进行身份认证、 授权、会话管理、加密等操作。 Shiro 就是用来解决安全管理的系统化框架。 2 Shiro 核心组件 用

    2024年02月09日
    浏览(41)
  • Android前端+Spring Boot后端 登录功能实现

    创建项目后,自己添加包,框架如下   userController里的一些内容,只供参考,代码不全,无法实现 数据库是直接在社区版IDEA里连接Mysql,在控制台端创建的数据库和user表,用于数据交互。 Activity包里是Activity Java类,主要响应layout包里activity_login.xml等页面布局内的按钮响应 a

    2024年02月12日
    浏览(53)
  • 【Spring Boot】缓存预热与缓存清除--原理、作用和目的

    在本文中,我们将详细讲解两个与缓存相关的重要概念: 缓存预热 和 缓存清除 。 我们将了解缓存的基本概念,然后分别介绍缓存预热和缓存清除的原理、作用和目的。 缓存是一种数据存储技术,用于存储经常访问的数据,以便在需要时快速获取 。通过缓存数据,可以 减

    2023年04月21日
    浏览(44)
  • React.js前端 + Spring Boot后端员工管理

    该项目是一个员工管理系统,前端使用 React.js 构建,后端使用 Spring Boot 和 Data JPA 和 Lombok 构建。它提供了有效管理员工信息的全面解决方案。 特征 响应式设计:响应式 UI 设计,确保跨各种设备的可用性。 数据验证:验证用户输入以确保数据完整性。 使用的技术 前端:R

    2024年04月28日
    浏览(41)
  • Spring MVC 配置详解 WebMvcConfigurer

    MVC Java配置和MVC XML命名空间提供了适合大多数应用程序的默认配置,并提供了一个配置API来定制它。 在Java配置中,你可以使用  @EnableWebMvc  注解来启用MVC配置,如下例所示: 在XML配置中,你可以使用  mvc:annotation-driven  元素来启用MVC配置,如下例所示: 在Java配置中,你可

    2024年02月02日
    浏览(29)
  • Spring Boot后端+Vue前端:打造高效二手车交易系统

    作者介绍: ✌️大厂全栈码农|毕设实战开发,专注于大学生项目实战开发、讲解和毕业答疑辅导。 🍅 获取源码联系方式请查看文末 🍅  推荐订阅精彩专栏 👇🏻 避免错过下次更新 Springboot项目精选实战案例 更多项目: CSDN主页YAML墨韵 学如逆水行舟,不进则退。学习如赶

    2024年04月28日
    浏览(54)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包