【开发者必备】Spring Boot 2.7.x:WebMvcConfigurer配置手册来了(六)!

2025-12-12 0 225

01 引言

一期我们介绍了addArgumentResolversaddReturnValueHandlers,分别用来请求参数的解析以及方法返回值的处理。我们继续WebMvcConfigurer配置的分享,这一期了解四个方法:

  • configureMessageConverters
  • extendMessageConverters
  • configureHandlerExceptionResolvers
  • extendHandlerExceptionResolvers

前两个是消息转化器,后两个是异常解析器。

02 方法13、14

default void configureMessageConverters(List<HttpMessageConverter> converters) {
}

default void extendMessageConverters(List<HttpMessageConverter> converters) {
}

作用:配置 HTTP 请求和响应的消息转换器。

使用场景

  • 自定义 JSON 序列化/反序列化
  • 支持新的数据格式
  • 统一日期格式处理

2.1 使用说明

configureMessageConvertersextendMessageConverters都是用来配置消息转化器的,但是影响最终的结果。

extendMessageConverters是追加在默认消息转化器的后面,而configureMessageConverters会覆盖默认的消息转化器。我们一起看看源码就知道了:

从源码可以看出,一旦配置了configureMessageConverters,会跳过默认的消息转化器。而extendMessageConverters不影响配置的和默认的消息转化器。

从源码可以看出默认的消息转化器有七个:

2.1 配置

假设我们只配置Fastjson的消息转化器和字符串的消息转化器。

@Override
public void configureMessageConverters(List<HttpMessageConverter> converters) {
    FastJsonConfig fastJsonConfig = new FastJsonConfig();

    FastJsonHttpMessageConverter fastJsonHttpMessageConverter = new FastJsonHttpMessageConverter();
    fastJsonHttpMessageConverter.setFastJsonConfig(fastJsonConfig);
    converters.add(fastJsonHttpMessageConverter);
}

@Override
public void extendMessageConverters(List<HttpMessageConverter> converters) {
    converters.add(new StringHttpMessageConverter(Charset.forName(\"GBK\")));
}

2.3 测试

@GetMapping(\"/testJSON\")
public Wjson testWjsonReturn(@RequestBody Wjson wjson) {
    return wjson;
}

我们需要关注org.springframework.web.servlet.mvc.method.annotation.AbstractMessageConverterMethodArgumentResolver#readWithMessageConverters()方法。

我们发现配置的信息放在了结尾,这不是我们预期的结果,我们希望fastJsonHttpMessageConverter在第一个,默认处理器不加载才对。

2.4 原因分析

见鬼了,明明源代码表示可以,但是结果却不是想象的那样。在跟踪源代码的时候的时候,发现WebMvcConfigurer的配置有两个:

第一个是WebMvcAutoConfiguration下的WebMvcAutoConfigurationAdapter,用来自动装配的,一定会加载默认的消息转化器。第二个才是我们定义的。所以当第一个配置类执行的时候,会加载默认消息转化器。

所以默认的消息转化器我们先不管,确保我们定义的configureMessageConverters在前面即可。

2.5 问题解决

我们分别通过configureMessageConvertersextendMessageConverters来解决我们的问题。

配置configureMessageConverters

我们需要自定义的WebMvcConfigurerWebMvcAutoConfigurationAdapter之前即可。我们先看看WebMvcAutoConfigurationAdapter的源码:

从图上可以知道源码通过@Order限制了加载的顺序,那我们只要将优先级高于@Order(0)即可。

配置extendMessageConverters

通过extendMessageConverters指定顺序,那么我们要确保我们的WebMvcConfigurer最后执行,所以无需@Order注解。利用list.add(inddex, xx)保证顺序。

@Override
public void extendMessageConverters(List<HttpMessageConverter> converters) {
    converters.add(0, new StringHttpMessageConverter(Charset.forName(\"GBK\")));
}

效果如图:

03 方法15、16

default void configureHandlerExceptionResolvers(List resolvers) {
}

default void extendHandlerExceptionResolvers(List resolvers) {
}

作用:是 Spring MVC 异常处理体系中的核心配置方法,它允许开发者完全自定义应用程序的异常处理机制。

使用场景

  • 统一异常处理
  • 自定义异常处理

2.1 使用说明

见名知意,和上面介绍的消息转化器基本一致:

同样configureHandlerExceptionResolvers控制着是否加载默认的异常解析器。默认的异常解析器有三个:

HandlerExceptionResolver就是针对异常做出想用的处理:

2.2 自定义异常解析器

/** AHandlerExceptionResolver **/
public class AHandlerExceptionResolver implements HandlerExceptionResolver {

    @Override
    public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
        System.out.println(\"AHandlerExceptionResolver....\");
        return null;
    }
}


/** BHandlerExceptionResolver **/
public class BHandlerExceptionResolver implements HandlerExceptionResolver {

    @Override
    public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
        System.out.println(\"BHandlerExceptionResolver....\");
        return null;
    }
}

返回值为null表示继续后面的异常解析器解析,返回ModelAndView表示异常解析中断,直接返回结果。

2.3 配置

@Override
public void configureHandlerExceptionResolvers(List resolvers) {
    resolvers.add(new AHandlerExceptionResolver());
}

@Override
public void extendHandlerExceptionResolvers(List resolvers) {
    resolvers.add(new BHandlerExceptionResolver());
}

我们要验证配置了configureHandlerExceptionResolvers会不会取代默认的异常解析器。

2.4 测试

@GetMapping(\"/testEx1\")
public void testEx1()  {
    throw new RuntimeException(\"testEx1\");
}

调用发现确实没有默认的处理器:

核心方法在这里:

org.springframework.web.servlet.handler.HandlerExceptionResolverComposite#resolveException

结果两个都执行了:

我们不配置configureHandlerExceptionResolvers,再试一下:

在两个都配置的情况下,AHandlerExceptionResolver直接返回数据。

再次测试

直接返回结果,BHandlerExceptionResolver没有再执行。

04 小结

这两组方法极其类似,但是使用的时候差异却很大。但是本质都是相同的。类别着记忆,也更容易记忆。今天的分享就到这里。下一期将是WebMvcConfigurer配置的最后一期,期待一下吧!

收藏 (0) 打赏

感谢您的支持,我会继续努力的!

打开微信/支付宝扫一扫,即可进行扫码打赏哦,分享从这里开始,精彩与您同在
点赞 (0)

申明:本文由第三方发布,内容仅代表作者观点,与本网站无关。对本文以及其中全部或者部分内容的真实性、完整性、及时性本站不作任何保证或承诺,请读者仅作参考,并请自行核实相关内容。本网发布或转载文章出于传递更多信息之目的,并不意味着赞同其观点或证实其描述,也不代表本网对其真实性负责。

左子网 编程相关 【开发者必备】Spring Boot 2.7.x:WebMvcConfigurer配置手册来了(六)! https://www.zuozi.net/35770.html

常见问题
  • 1、自动:拍下后,点击(下载)链接即可下载;2、手动:拍下后,联系卖家发放即可或者联系官方找开发者发货。
查看详情
  • 1、源码默认交易周期:手动发货商品为1-3天,并且用户付款金额将会进入平台担保直到交易完成或者3-7天即可发放,如遇纠纷无限期延长收款金额直至纠纷解决或者退款!;
查看详情
  • 1、描述:源码描述(含标题)与实际源码不一致的(例:货不对板); 2、演示:有演示站时,与实际源码小于95%一致的(但描述中有”不保证完全一样、有变化的可能性”类似显著声明的除外); 3、发货:不发货可无理由退款; 4、安装:免费提供安装服务的源码但卖家不履行的; 5、收费:价格虚标,额外收取其他费用的(但描述中有显著声明或双方交易前有商定的除外); 6、其他:如质量方面的硬性常规问题BUG等。 注:经核实符合上述任一,均支持退款,但卖家予以积极解决问题则除外。
查看详情
  • 1、左子会对双方交易的过程及交易商品的快照进行永久存档,以确保交易的真实、有效、安全! 2、左子无法对如“永久包更新”、“永久技术支持”等类似交易之后的商家承诺做担保,请买家自行鉴别; 3、在源码同时有网站演示与图片演示,且站演与图演不一致时,默认按图演作为纠纷评判依据(特别声明或有商定除外); 4、在没有”无任何正当退款依据”的前提下,商品写有”一旦售出,概不支持退款”等类似的声明,视为无效声明; 5、在未拍下前,双方在QQ上所商定的交易内容,亦可成为纠纷评判依据(商定与描述冲突时,商定为准); 6、因聊天记录可作为纠纷评判依据,故双方联系时,只与对方在左子上所留的QQ、手机号沟通,以防对方不承认自我承诺。 7、虽然交易产生纠纷的几率很小,但一定要保留如聊天记录、手机短信等这样的重要信息,以防产生纠纷时便于左子介入快速处理。
查看详情

相关文章

猜你喜欢
发表评论
暂无评论
官方客服团队

为您解决烦忧 - 24小时在线 专业服务