FastJson PropertyNamingStrategy 转换成JSON字符串的四种格式配置及源码解析

最新推荐文章于 2025-02-14 15:47:03 发布

BlueKitty1210

最新推荐文章于 2025-02-14 15:47:03 发布

阅读量4.7k

点赞数 4

CC 4.0 BY-SA版权

分类专栏： Java 文章标签： FastJson JSON格式 PropertyNamingStrategy

本文链接：https://blog.csdn.net/xingbaozhen1210/article/details/103246102

Java 专栏收录该内容

98 篇文章

订阅专栏

FastJson自1.2.15版本起支持四种属性命名策略：CamelCase、PascalCase、SnakeCase、KebabCase。可通过全局配置、注解或局部配置应用。源码解析展示了不同命名策略的具体实现。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

FastJson在将bean转成JSON字符串时, 默认使用CamelCase(驼峰命名)的配置;

在1.2.15版本之后，FastJson支持配置PropertyNamingStrategy，有四种配置格式: CamelCase; PascalCase; SnakeCase; KebabCase.

1 . 配置项内容

配置方式	说明	Java属性名	JSON属性名
CamelCase	驼峰命名,首字母小写	UserName	userName
PascalCase	帕斯卡命名,首字母大写	userName	UserName
SnakeCase	蛇形命名,大写转小写并以下划线连接	userName	user_name
KebabCase	短横线命名,大写转小写并以短横线连接	userName	user-name

2 . 配置操作

2.1 全局配置

SerializeConfig.getGlobalInstance().propertyNamingStrategy = PropertyNamingStrategy.SnakeCase;

2.2 用注解的方式对某个bean配置

@JSONType(naming=PropertyNamingStrategy.SnakeCase)
public class User {
	//...
}

2.3 局部配置

// 生产环境中，config要做singleton处理，要不然会存在性能问题
SerializeConfig config = new SerializeConfig();
config.propertyNamingStrategy = PropertyNamingStrategy.SnakeCase;
 
User user = new User();
user.setUserName("Xing");
String json = JSON.toJSONString(model, config);
Assert.assertEquals("{\"user_name\":\"Xing\"}", json);

3 . 源码解析

package com.alibaba.fastjson;

/**
 * @since 1.2.15
 */
public enum PropertyNamingStrategy {
                                    CamelCase, //
                                    PascalCase, //
                                    SnakeCase, //
                                    KebabCase;

    public String translate(String propertyName) {
        switch (this) {
            case SnakeCase: {
                StringBuilder buf = new StringBuilder();
                for (int i = 0; i < propertyName.length(); ++i) {
                    char ch = propertyName.charAt(i); //获取每一个字符
                    if (ch >= 'A' && ch <= 'Z') { //如果为A-Z
                        char ch_ucase = (char) (ch + 32); //转为小写的a-z
                        if (i > 0) {
                            buf.append('_'); //并在该字符后追加"_"
                        }
                        buf.append(ch_ucase);
                    } else {
                        buf.append(ch);
                    }
                }
                return buf.toString();
            }
            case KebabCase: {
                StringBuilder buf = new StringBuilder();
                for (int i = 0; i < propertyName.length(); ++i) {
                    char ch = propertyName.charAt(i); //获取每一个字符
                    if (ch >= 'A' && ch <= 'Z') { //如果为A-Z
                        char ch_ucase = (char) (ch + 32); //转为小写的a-z
                        if (i > 0) {
                            buf.append('-'); //并在该字符后追加"-"
                        }
                        buf.append(ch_ucase);
                    } else {
                        buf.append(ch);
                    }
                }
                return buf.toString();
            }
            case PascalCase: {
                char ch = propertyName.charAt(0); //获取第一个字符
                if (ch >= 'a' && ch <= 'z') { //如果首字母是a-z
                    char[] chars = propertyName.toCharArray();
                    chars[0] -= 32; //将首字母转为大写
                    return new String(chars);
                }

                return propertyName;
            }
            case CamelCase: {
                char ch = propertyName.charAt(0); //获取第一个字符
                if (ch >= 'A' && ch <= 'Z') { //如果首字母是A-Z
                    char[] chars = propertyName.toCharArray();
                    chars[0] += 32; //将首字母转为小写
                    return new String(chars);
                }

                return propertyName;
            }
            default:
                return propertyName;
        }
    }
}

源码非常简单明了 , 一看就明白FastJson是怎么实现的