SpringBoot系列之Web如何支持下划线驼峰互转的传参与返回

这篇具有很好参考价值的文章主要介绍了SpringBoot系列之Web如何支持下划线驼峰互转的传参与返回。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

springboot response给前端驼峰转下划线,spring boot,前端,java,程序人生,spring

SpringBoot系列之Web如何支持下划线驼峰互转的传参与返回

接下来介绍一个非常现实的应用场景,有些时候后端接口对外定义的传参/返回都是下划线命名风格,但是Java本身是推荐驼峰命名方式的,那么必然就存在一个传参下换线,转换成驼峰的场景;以及在返回时,将驼峰命名的转换成下划线

那么如何支持上面这种应用场景呢?

本文介绍几种常见的手段

I. 项目搭建

1. 项目依赖

本项目借助SpringBoot 2.2.1.RELEASE + maven 3.5.3 + IDEA进行开发

开一个web服务用于测试

<dependencies>    <!-- 邮件发送的核心依赖 -->    <dependency>        <groupId>org.springframework.boot</groupId>        <artifactId>spring-boot-starter-web</artifactId>    </dependency></dependencies>

配置文件application.yml

server:  port: 8080

2. 需求拆分

接下来为了更方便的理解我们要做的事情,对上面的应用场景进行一些拆分,方便理解

2.1 请求参数解析

对于请求参数,外部传递是下划线命名格式的方式,需要与项目中驼峰命名的对象进行映射,所以这里的问题点就是无法走默认的绑定规则,需要我们进行兼容处理

比如传参是 user_name = 一灰灰,但是我们接收的参数是 userName

2.2 返回结果处理

返回结果的处理,这里单指返回json对象的场景,一个普通的POJO对象,正常序列化为json字符串时,key实际上与对象的成员名是一致的,而现在则希望将key统一成下划线风格的方式

如,返回一个简单的实体对象​​​​​​​

public class ViewDo {  private Integer userId;  private string userName;}

对应期待返回的json串为​​​​​​​

{  "user_name" : "张三",  "user_id" : 110}

II. 支持方式

为了简化后续的流程,我们这里的传参都确定两个userName + userId,对应项目中的实体类如​​​​​​​

@Data@NoArgsConstructor@AllArgsConstructorpublic static class ViewDo {    private Integer userId;    private String userName;}

1. 请求参数解析

1.1 @RequestParam注解方式

最简单也是最容易想到的方式自然是直接使用RequestParam注解,将所有的请求参数都通过它来重命名​​​​​​​

@GetMapping(path = "getV3")public ViewDo getV3(@RequestParam("user_id") Integer userId, @RequestParam("user_name") String userName) {    String str = "userId: " + userId + " userName: " + userName;    System.out.println(str);    return new ViewDo(userId, userName);}

使用上面直接来写参数映射关系的方式属于比较常见的方法了,但是存在一个问题

•通用性差(每个接口的每个参数都要这么整,如果工资是按照代码来付费的话,那还是可以接收的;否则这个写法,就真的有点难受了)•若接口参数定义的是Map、Java bean实体(POJO),这个映射关联就不太好处理了

除了上面这个问题之外,有个不是问题的问题(为什么这么说,且看下面的说法)

•如果我的接口传参,希望同时接收驼峰和下划线命名的传参(现实中还真有这种神经病似的场景,别问我怎么知道的),上面这个是不行的

1.2 Json传参指定命名策略

上面的case,适用于常见的get请求,post表单传参,然后在接口处一一定义参数;对于post json传参时,我们可以考虑通过定义json序列化的命名策略,来支持下划线与驼峰的互转

比如SpringMVC默认使用的jackson来实现json序列化,那么我们可以直接通过指定jackson的PropertyNamingStrategy来完成

配置文件中 application.yml,添加下面这行​​​​​​​

spring:  jackson:    # 使用jackson进行json序列化时,可以将下划线的传参设置给驼峰的非简单对象成员上;并返回下划线格式的json串    # 特别注意。使用这种方式的时候,要求不能有自定义的WebMvcConfigurationSupport,因为会覆盖默认的处理方式    # 解决办法就是 拿到ObjectMapper的bean对象,手动塞入进去    property-naming-strategy: SNAKE_CASE

对应的接口定义如下​​​​​​​​​​​​​​

/** * post json串 *  curl 'http://127.0.0.1:8080/postV2' -X POST -H 'content-type:application/json' -d '{"user_id": 123, "user_name": "一灰灰"}' * @param viewDo * @return */@PostMapping(path = "postV2")public ViewDo postV2(@RequestBody ViewDo viewDo) {    System.out.println(viewDo);    return viewDo;}

实际请求之后,看一下效果

springboot response给前端驼峰转下划线,spring boot,前端,java,程序人生,spring

注意

•使用上面这种配置的方式,需要特比注意的,如果在项目中自己定义了WebMvcConfigurationSupport,那么上面的配置将不会生效(至于具体的原因,后面有机会单独说明)

当我们实际的项目中,无法直接使用上面这种配置时,可以考虑使用下面的方式​​​​​​​

@SpringBootApplicationpublic class Application  extends WebMvcConfigurationSupport {    /**     * 下面这个设置,可以实现json参数解析/返回时,传入的下划线转驼峰;输出的驼峰转下划线     * @param converters     */    @Override    protected void extendMessageConverters(List<HttpMessageConverter<?>> converters) {        MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter();        ObjectMapper objectMapper = converter.getObjectMapper();        // 设置驼峰标志转下划线        objectMapper.setPropertyNamingStrategy(PropertyNamingStrategy.SNAKE_CASE);        // 设置格式化内容        converter.setObjectMapper(objectMapper);        converters.add(0, converter);        super.extendMessageConverters(converters);    }}

使用jackson的命名策略来支持驼峰下划线的转换虽好,但是存在一个非常明显的缺陷

•它只适用于json传参

1.3 自定义DataBinder

对于非json的传承,比如普通的get请求,post表单传参,然后在接口处通过定义一个POJO参数类来接收,此时又应该怎么处理呢?

比如接口定义如下​​​​​​​

/** * POJO 对应Spring中的参数转换是 ServletModelAttributeMethodProcessor | RequestParamMethodArgumentResolver * @param viewDo * @return */@GetMapping(path = "getV5")public ViewDo getV5(ViewDo viewDo) {    System.out.println("v5: " + viewDo);    return viewDo;}/** *  curl 'http://127.0.0.1:8080/postV1' -X POST -d 'user_id=123&user_name=一灰灰' *  注意:非json传参,jackson的配置将不会生效,即上面这个请求是不会实现下划线转驼峰的; 但是返回结果会是下划线的 * @param viewDo * @return */@PostMapping(path = "postV1")public ViewDo post(ViewDo viewDo) {    System.out.println(viewDo);    return viewDo;}

对于上面这种场景,一个想法就是是否可以在ViewDo的成员上,添加一个注解,指定参数名,一如RequestParam,不过Spring貌似并没有提供这种支持能力

因此我们可以考虑自己来实现数据绑定,下面提供一个基础的实现, 来演示这种方式改怎么玩(相对完整的基于注解的映射方式,下篇博文介绍)​​​​​​​

public class SimpleDataBinder extends ExtendedServletRequestDataBinder {    public SimpleDataBinder(Object target, String objectName) {        super(target, objectName);    }    @Override    protected void addBindValues(MutablePropertyValues mpvs, ServletRequest request) {        super.addBindValues(mpvs, request);        if (!mpvs.contains("userName")) {            mpvs.add("userName", getVal(mpvs, "user_name"));        }        if (!mpvs.contains("userId")) {            mpvs.add("userId", getVal(mpvs, "user_id"));        }    }    private Object getVal(MutablePropertyValues mpvs, String key) {        PropertyValue pv = mpvs.getPropertyValue(key);        return pv != null ? pv.getValue() : null;    }}

然后在参数解析中,使用这个DataBinder​​​​​​​

public class SimpleArgumentProcessor extends ServletModelAttributeMethodProcessor {    public SimpleArgumentProcessor(boolean annotationNotRequired) {        super(annotationNotRequired);    }    @Override    protected void bindRequestParameters(WebDataBinder binder, NativeWebRequest nativeWebRequest) {        Object target = binder.getTarget();        SimpleDataBinder dataBinder = new SimpleDataBinder(target, binder.getObjectName());        super.bindRequestParameters(dataBinder, nativeWebRequest);    }}

接着就是注册这个参数解析​​​​​​​

@SpringBootApplicationpublic class Application  extends WebMvcConfigurationSupport {    @Override    protected void addArgumentResolvers(List<HandlerMethodArgumentResolver> argumentResolvers) {        argumentResolvers.add(new SimpleArgumentProcessor(true));    }}

再次请求时,可以发现下划线的传参也可以映射到ViewDo对象上(无论是get请求还是post请求,都可以正确映射)

springboot response给前端驼峰转下划线,spring boot,前端,java,程序人生,spring

2.返回结果

对于返回结果,希望返回下划线格式的json串,除了上面介绍到的设置json序列化的命名策略之外,还有下面几种配置方式

2.1 属性注解 @JsonProperty

直接在POJO对象的成员上,指定希望输出的name​​​​​​​

public static class ViewDo {    @JsonProperty("user_id")    private Integer userId;    @JsonProperty("user_name")    private String userName;}
2.2 实体类注解 @JsonNaming

直接在类上添加注解,指定驼峰策略​​​​​​​

@JsonNaming(value = PropertyNamingStrategy.SnakeCaseStrategy.class)public static class ViewDo {    private Integer userId;    private String userName;}
2.3 全局配置

上面两种缺点比较明显,不太通用;更通用的选择和前面传参的json序列化配置方式一样,两种姿势

配置文件指定​​​​​​​

spring:  jackson:    # 使用jackson进行json序列化时,可以将下划线的传参设置给驼峰的非简单对象成员上;并返回下划线格式的json串    # 特别注意。使用这种方式的时候,要求不能有自定义的WebMvcConfigurationSupport,因为会覆盖默认的处理方式    # 解决办法就是 拿到ObjectMapper的bean对象,手动塞入进去    property-naming-strategy: SNAKE_CASE

前面也说到,上面这种配置可能会失效(比如你设置了自己的WebMvcConfig),推荐使用下面的方式​​​​​​​

public class Application  extends WebMvcConfigurationSupport {    /**     * 下面这个设置,可以实现json参数解析/返回时,传入的下划线转驼峰;输出的驼峰转下划线     * @param converters     */    @Override    protected void extendMessageConverters(List<HttpMessageConverter<?>> converters) {        MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter();        ObjectMapper objectMapper = converter.getObjectMapper();        // 设置驼峰标志转下划线        objectMapper.setPropertyNamingStrategy(PropertyNamingStrategy.SNAKE_CASE);        // 设置格式化内容        converter.setObjectMapper(objectMapper);        converters.add(0, converter);        super.extendMessageConverters(converters);    }}

3. 小结

本文主要介绍了几种实例case,用于实现传参/返回的驼峰与下划线的互转,核心策略,有下面几种

•传参:@RequestParam 指定真正的传参name•Json传参、返回:通过定义json序列化框架的PropertyNamingStrategy,来实现•普通表单传参/get传参,映射POJO时:通过自定义的DataBinder,来实现映射

虽然上面几种姿势,可以满足我们的基本诉求,但是如果我希望实现一个通用的下划线/驼峰互转策略,即不管传参是下划线还是驼峰,都可以正确无误的绑定到接口的参数变量上,可以怎么实现呢?文章来源地址https://www.toymoban.com/news/detail-837139.html

到了这里,关于SpringBoot系列之Web如何支持下划线驼峰互转的传参与返回的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

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

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

相关文章

  • HTML中设定下划线样式并且指定下划线长度

    今天笔者在写网页导航栏时,想要给链接加一个悬停下划线,写出来如下 HTMl: CSS:(关于其他格式的设定略,只看下划线这一段代码) 这样确实是设定下划线了,但是效果如下,看上去很难看 既然这样,那么该如何改变一下呢? 其实可以使用border-bottom来实现,代码如下

    2024年02月10日
    浏览(38)
  • 详解Python单下划线和双下划线使用

    在Python编程中,我们经常会遇到单下划线(_)和双下划线(__)的使用。它们在命名标识符、变量、方法和属性中扮演着不同的角色。本文将详细解释Python中单下划线和双下划线的含义和用法,并通过代码示例进行讲解,帮助你理解它们的作用和适用场景。 命名约定。在Py

    2024年02月10日
    浏览(37)
  • Python 中的单下划线和双下划线

    哈喽大家好,我是咸鱼 当我们在学习 Python 的时候,可能会经常遇到单下划线 _ 和双下划线 __ 这两种命名方式 单下划线 _ 和双下划线 __ 不仅仅是只是一种简单的命名习惯,它们在 Python 中有着特殊的含义,对于代码的可读性和功能实现有着关键的作用。 那么今天我们来看一

    2024年02月05日
    浏览(42)
  • SSTI模板注入-中括号、args、下划线、单双引号、os、request、花括号被过滤绕过(ctfshow web入门369)

    由于request被过滤,我们就不能再使用传参的方式进行传递命令以及被过滤的,下划线中括号花括号都被过滤,这样的话我们就只能使用{%%}来进行设置变量以及拼接方法的方式来进行利用SSTI漏洞。 本章内容,咱们就先研究怎么做出ctfshow web入门369这道题目,然后再讲解

    2024年02月08日
    浏览(40)
  • SSTI模板注入-中括号、args、下划线、单双引号、os、request、花括号、数字被过滤绕过(ctfshow web入门370)

    由于request被过滤,我们就不能再使用传参的方式进行传递命令以及被过滤的,下划线中括号花括号都被过滤,这样的话我们就只能使用{%%}来进行设置变量以及拼接方法的方式来进行利用SSTI漏洞。 但是ctfshow web入门370关相对于ctfshow web入门369关多过滤数字,就是我们不

    2024年02月04日
    浏览(35)
  • spring boot application yaml key下划线如何转java的Properties对象字段驼峰

    spring boot yaml key和value如何映射到Properties对象 下面以MybatisPlusProperties为例 ##java properties 字段驼峰 ##yaml文件如图,key使用下划线 ##java对象驼峰转下划线匹配yaml文件key DataObjectPropertyName.toDashedForm(name);//驼峰转下划线 ##设置Properties对象字段值

    2024年02月01日
    浏览(47)
  • 如何判断某列某个单元格是否包含特殊字符(如空格、数字、下划线等等),并返回特殊字符

    VBA代码已写好,直接粘贴到VBA编辑器并保存,即可使用。也可以下载我写好的保存了宏代码的excel文件,直接调用即可。我的excel文件中也包含了很多重度办公人士经常需要用到的其他函数,目前的函数较少,后续会不断更新新的宏函数进去,并会在我的博客中进行功能介绍使

    2024年02月13日
    浏览(59)
  • css 下划线

    在 CSS 中,可以使用 \\\"text-decoration\\\" 属性来设置文本的下划线。例如: 这会使所有的段落文本都带有下划线。你也可以使用 \\\"text-decoration-style\\\" 属性来设置下划线的样式,例如实线、虚线或点线等。 你还可以使用 \\\"border-bottom\\\" 属性来设置下划线,例如: 这会在段落文本下方添加

    2024年02月12日
    浏览(32)
  • css下划线跟随导航

    2024年01月23日
    浏览(37)
  • a标签设置下划线动画

     

    2024年02月07日
    浏览(39)

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

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

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

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

二维码1

领取红包

二维码2

领红包