记一次springboot通过jackson渲染到前端，出现大写字母变成小写问题

前言

最近业务部门接手了外包供应商的项目过来自己运维，该部门的小伙伴发现了一个问题，比如后端的DTO有个属性名为nPrice的字段，通过json渲染到前端后，变成nprice，而预期的字段是要为nPrice。于是他们就找到我们部门，希望我们能帮忙解决一下这个问题，本文就聊聊如何解决问题，至于为什么会出现这个问题，后面留个彩蛋

解法

注： 本文的json都是通过springboot默认的jackson进行渲染解析，因此本文的解法都是针对jackson

方法一：在属性字段上加@JsonProperty注解

示例

    @JsonProperty(value = "nPropriceFactory")
    private BigDecimal nPropriceFactory;

因为业务接手的项目的字段的属性大量都是首字母小写，第二个字母大写的形式，比如nHelloWorld，因此业务部门的小伙伴，觉得一个个加太麻烦了，有没有更简洁点办法。于是就有了第二种方法

方法二：通过自定义com.fasterxml.jackson.databind.PropertyNamingStrategy策略

具体逻辑形如如下

public class CustomPropertyNamingStrategy extends PropertyNamingStrategy {


    @Override
    public String nameForGetterMethod(MapperConfig<?> config, AnnotatedMethod method, String defaultName) {
        if (isSpecialPropertyName(defaultName)) {
            //将属性的get方法去除get，然后首字母转小写
            return StringUtils.uncapitalize(method.getName().substring(3));
        }
        return super.nameForGetterMethod(config,method,defaultName);
    }



    @Override
    public String nameForSetterMethod(MapperConfig<?> config, AnnotatedMethod method, String defaultName) {
        if (isSpecialPropertyName(defaultName)) {
            //将属性的set方法去除set，然后首字母转小写
            return StringUtils.uncapitalize(method.getName().substring(3));
        }
        return super.nameForSetterMethod(config,method,defaultName);
    }

  


}

在application.yml做如下配置

spring:
  jackson:
    property-naming-strategy: com.github.lybgeek.jackson.CustomPropertyNamingStrategy

这样就可以解决了，不过业务部门的研发，基本上都是被惯坏的小孩，为了让他们更方便的使用，我们就更近一步，也不要在yml进行配置了，让他们直接引入jar就好。于是我们做了如下操作

public final class EnvUtils {

    private EnvUtils(){}

    private static final String JACKSON_PROPERTY_NAMING_STRATEGY_KEY = "spring.jackson.property-naming-strategy";


    public static void postProcessEnvironment(ConfigurableEnvironment environment){
        String isCustomJsonFormatEnaled = environment.getProperty(CUSTOM_JSON_FORMAT_ENABLE_KEY,"true");
        if("true".equalsIgnoreCase(isCustomJsonFormatEnaled)){
            setCustomJacksonPropertyNamingStrategy(environment);
        }
    }

    private static void setCustomJacksonPropertyNamingStrategy(ConfigurableEnvironment environment) {
        MutablePropertySources propertySources = environment.getPropertySources();
        Map<String, Object> mapPropertySource = new HashMap<>();
        mapPropertySource.put(JACKSON_PROPERTY_NAMING_STRATEGY_KEY, CustomPropertyNamingStrategy.class.getName());
        PropertySource propertySource = new MapPropertySource("custom-json-format-properties",mapPropertySource);
        propertySources.addFirst(propertySource);
    }

}

public class CustomJacksonFormatEnvironmentApplicationContextInitializer implements ApplicationContextInitializer {
    @Override
    public void initialize(ConfigurableApplicationContext applicationContext) {
        ConfigurableEnvironment environment = applicationContext.getEnvironment();
        EnvUtils.postProcessEnvironment(environment);

    }
}

在resouce下新建META-INF/spring.factories,并指定如下内容

org.springframework.context.ApplicationContextInitializer=\
com.github.lybgeek.jackson.env.CustomJacksonFormatEnvironmentApplicationContextInitializer

自此业务部门只要引入这个包，就可以解决jackson渲染到前端，出现大写字母变成小写问题

注：如果用实现org.springframework.boot.env.EnvironmentPostProcessor来实现属性配置也可以，不过要注意如果是使用springcloud，则可能会出现在配置在application.yml的属性，通过

environment.getProperty(CUSTOM_JSON_FORMAT_ENABLE_KEY);

拿不到值的情况。因此推荐用实现org.springframework.context.ApplicationContextInitializer来进行环境变量获取或者设置

总结

以上两种方式，一种是采用局部的方式，另一种是采用全局的方式，采用全局的方式，要做好测试，不然影响很大，我们采用全局的方式，一来是业务那边要求，二来是当时我们和业务部门做好沟通，我们根据他们的业务规则来做定制，并跟他们说明采用全局的方式可能遇到的问题。

至于为啥jackson渲染到前端，出现大写字母变成小写问题，大家如果有空debug跟到com.fasterxml.jackson.databind.util.BeanUtil#legacyManglePropertyName这个方法，应该就会有答案。如果没空的话，就可以查看如下链接
https://blog.csdn.net/weixin_42511702/article/details/112520749
进行解读

demo链接

https://github.com/lyb-geek/springboot-learning/tree/master/springboot-json-format