使用 @JsonPropertyOrder 注解自定义顺序（POJO方式), 为什么避免使用 TreeMap？及其示例

使用 @JsonPropertyOrder 注解自定义顺序（POJO方式）

@JsonPropertyOrder 注解允许在类级别指定属性序列化的顺序，仅适用于 POJO 对象（普通 Java 对象）。以下是实现步骤：

1. 创建 POJO 类并添加注解

import com.fasterxml.jackson.annotation.JsonPropertyOrder;

// 显式指定属性顺序
@JsonPropertyOrder({"name", "age", "email", "registerDate"})
public class User {
    private int age;
    private String name;
    private String email;
    private String registerDate;

    // 构造器
    public User(String name, int age, String email, String registerDate) {
        this.name = name;
        this.age = age;
        this.email = email;
        this.registerDate = registerDate;
    }

    // Getter 方法（必须存在）
    public String getName() { return name; }
    public int getAge() { return age; }
    public String getEmail() { return email; }
    public String getRegisterDate() { return registerDate; }
}

2. 序列化示例

ObjectMapper mapper = new ObjectMapper();
User user = new User("Alice", 30, "alice@example.com", "2023-01-15");

String json = mapper.writeValueAsString(user);
System.out.println(json);

3. 输出结果（严格按注解顺序）

{
  "name": "Alice",
  "age": 30,
  "email": "alice@example.com",
  "registerDate": "2023-01-15"
}

注解选项说明：

配置方式	效果
@JsonPropertyOrder({"a","b","c"})	显式指定属性顺序
@JsonPropertyOrder(alphabetic = true)	强制按字母排序
@JsonPropertyOrder(value = {"a","b"}, alphabetic = true)	先按指定顺序，剩余按字母排序

---

为什么避免使用 TreeMap？及其示例

TreeMap 会自动按键的自然顺序排序（字典序），破坏插入顺序。即使配置了 ORDER_MAP_ENTRIES_BY_KEYS=false 也无法改变此行为。

问题示例：

ObjectMapper mapper = new ObjectMapper();
mapper.disable(SerializationFeature.ORDER_MAP_ENTRIES_BY_KEYS);

// 使用 TreeMap（会自动排序）
Map<String, Object> treeMap = new TreeMap<>();
treeMap.put("z_property", 1);
treeMap.put("a_property", 2);
treeMap.put("m_property", 3);

String json = mapper.writeValueAsString(treeMap);
System.out.println(json);

输出结果（按键名字典序排序）：

{
  "a_property": 2,
  "m_property": 3,
  "z_property": 1
}

关键问题：

1. 插入顺序完全丢失：即使按 z->a->m 插入，输出仍变成 a->m->z
2. 配置无效：ORDER_MAP_ENTRIES_BY_KEYS=false 对 TreeMap 无效
3. 与需求冲突：不符合 "按插入顺序显示" 的要求

正确方案对比：

// 改用 LinkedHashMap
Map<String, Object> linkedMap = new LinkedHashMap<>();
linkedMap.put("z_property", 1);
linkedMap.put("a_property", 2);
linkedMap.put("m_property", 3);

String json = mapper.writeValueAsString(linkedMap);
System.out.println(json);

输出（保持插入顺序）：

{
  "z_property": 1,
  "a_property": 2,
  "m_property": 3
}

总结选择方案

场景	推荐方案
处理 Map 对象	使用 LinkedHashMap + ORDER_MAP_ENTRIES_BY_KEYS=false
处理 POJO 对象	使用 @JsonPropertyOrder 注解
需要自动排序	使用 TreeMap（不推荐用于顺序敏感场景）
JSON 标准顺序	不需要任何配置（JSON 规范不保证顺序）