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是怎麼實現的