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

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是怎么实现的