// Fastjson 的 autoType 机制
// 序列化时——自动写入类的全限定名
String json = JSON.toJSONString(order);
// 结果：{"@type":"com.example.Order","orderId":10001,"amount":6999.00}
//          ↑ ↑ ↑ ↑ ↑ ↑ ↑ ↑ ↑ ↑ ↑ ↑
//          @type 字段记录了类的全限定名

// 反序列化时——根据 @type 字段自动还原为正确的子类型
// JSON 数据："{\"@type\":\"com.example.Order\",\"orderId\":10001}"
// 即使你只声明为 Object，Fastjson 也能还原出 Order 对象
Object obj = JSON.parse(json);  // 实际返回 Order 实例

// ❌ 默认模式——autoType 开启，危险！
JSON.parse(jsonStr);

// ✅ 关闭 autoType（SafeMode）
ParserConfig.getGlobalInstance().setSafeMode(true);
JSON.parse(jsonStr);  // 安全了——但不支持 @type 解析

// ✅ 白名单模式——只允许指定的类
ParserConfig.getGlobalInstance().addAccept("com.example.Order");
ParserConfig.getGlobalInstance().addAccept("com.example.User");
JSON.parse(jsonStr);  // 只有白名单中的类可以走 autoType

<!-- 你的项目依赖中检查 Fastjson 是否存在 -->
<!-- 运行 mvn dependency:tree | grep fastjson -->
<!-- 可能在你看不到的地方被间接依赖了 -->

<dependency>
    <groupId>com.alibaba.fastjson2</groupId>
    <artifactId>fastjson2</artifactId>
    <version>2.0.53</version>  <!-- 本文写作时的最新版——以实际为准 -->
</dependency>

// Fastjson2 的 API 和 Fastjson 1.x 一模一样——包名都不用改
import com.alibaba.fastjson2.JSON;  // 注意：是 fastjson2，不是 fastjson

// ===== 序列化：Java 对象 → JSON 字符串 =====
Order order = new Order(10001L, 2001L, "iPhone 15",
        new BigDecimal("6999.00"), "created", LocalDateTime.now());
String json = JSON.toJSONString(order);
System.out.println(json);
// 输出：{"orderId":10001,"userId":2001,"productName":"iPhone 15","amount":"6999.00","action":"created","createTime":"2024-01-15 10:30:00"}

// ===== 反序列化：JSON 字符串 → Java 对象 =====
String jsonStr = "{\"orderId\":10001,\"userId\":2001,\"productName\":\"iPhone 15\",\"amount\":\"6999.00\"}";

// 方式一：parseObject
Order parsedOrder = JSON.parseObject(jsonStr, Order.class);

// 方式二：链式调用
Order parsedOrder2 = JSON.parseObject(jsonStr)
        .toJavaObject(Order.class);

// 方式三：泛型反序列化（Fastjson2 有 TypeReference）
List<Order> orders = JSON.parseObject(jsonListStr,
    new TypeReference<List<Order>>() {});

@JSONType(orders = {"userId", "orderId", "amount"})  // 指定序列化字段顺序
public class Order {

    @JSONField(name = "order_id")  // 等价于 Jackson 的 @JsonProperty("order_id")
    private Long orderId;

    @JSONField(name = "user_id", ordinal = 1)  // ordinal 控制顺序——越小越前
    private Long userId;

    @JSONField(serialize = false)  // 等价于 Jackson 的 @JsonIgnore
    private String internalNote;

    @JSONField(format = "yyyy-MM-dd HH:mm:ss")  // 日期格式
    private LocalDateTime createTime;

    @JSONField(serializeFeatures = JSONWriter.Feature.WriteBigDecimalAsPlain)
    private BigDecimal amount;  // BigDecimal 不用科学计数法
}

// 类级别注解
@JSONType(
    includes = {"orderId", "productName", "amount"},  // 只输出这几个字段
    orders = {"orderId", "productName", "amount"}       // 按此顺序输出
)

// Fastjson2 支持 Jackson 的注解——老项目如果已经在用 Jackson 注解
// 切到 Fastjson2 后不需要改注解！
public class Order {

    @JsonProperty("order_id")      // Jackson 的注解——
                                // Fastjson2 也认得它！
    private Long orderId;

    @JsonIgnore
    private String internalNote;

    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private LocalDateTime createTime;

    // Fastjson2 序列化时会读取 @JsonProperty / @JsonIgnore / @JsonFormat
    // 行为和对 Jackson 一样——零修改代价迁移
}

// Fastjson2 的全局配置——通过静态方法
JSON.config(
    // 日期格式
    JSONWriter.Feature.WriteDateTimeUseDateFormat,
    // BigDecimal 不用科学计数法
    JSONWriter.Feature.WriteBigDecimalAsPlain,
    // null 字段不输出
    JSONWriter.Feature.SkipNullValues,
    // 美化输出（调试用）
    JSONWriter.Feature.PrettyFormat
);

// 或者 SpringBoot 中通过 Fastjson2 的 HttpMessageConverter 配
@Configuration
public class Fastjson2Config {

    @Bean
    public HttpMessageConverters fastjson2Converters() {
        Fastjson2HttpMessageConverter converter =
                new Fastjson2HttpMessageConverter();
        converter.setDefaultCharset(StandardCharsets.UTF_8);
        converter.setFeatures(
                JSONWriter.Feature.WriteBigDecimalAsPlain,
                JSONWriter.Feature.SkipNullValues,
                JSONWriter.Feature.WriteDateTimeUseDateFormat);
        return new HttpMessageConverters(converter);
    }
}

// Fastjson2 默认关闭 autoType——需要时才开启
// 方式一：白名单——添加允许的类的 package
JSON.config(
    JSONReader.Feature.SupportAutoType,
    JSONReader.Feature.FieldBased
);

// 通过配置文件设置白名单——/META-INF/fastjson2/autoTypeFilter
// 每行一个：com.example.model.Order
//            com.example.model.User

// 或者代码中直接配
JSON.register(java.sql.Timestamp.class);
JSON.register(java.util.Date.class);
JSON.register(com.example.model.Order.class);

<!-- 删掉 -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.83</version>
</dependency>

<!-- 换成 -->
<dependency>
    <groupId>com.alibaba.fastjson2</groupId>
    <artifactId>fastjson2</artifactId>
    <version>2.0.53</version>
</dependency>

// Fastjson 1.x 的 import
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import com.alibaba.fastjson.annotation.JSONField;

// Fastjson2 的 import——包名变了
import com.alibaba.fastjson2.JSON;
import com.alibaba.fastjson2.JSONObject;
import com.alibaba.fastjson2.annotation.JSONField;

// 注：Fastjson2 提供了 fastjson1-forward 兼容模块——用 1.x 的 import 直接调到 2.x 实现
// <dependency>
//     <groupId>com.alibaba.fastjson2</groupId>
//     <artifactId>fastjson2-extension</artifactId>
//     <version>2.0.53</version>
// </dependency>
// 引入后 import com.alibaba.fastjson.JSON 自动指向 fastjson2 的实现

// Fastjson 1.x 中的全局配置 → Fastjson2 等价写法
// 1.x: JSON.DEFAULT_GENERATE_FEATURE |= SerializerFeature.SkipTransientField.getMask();
// 2.x: JSON.config(JSONWriter.Feature.SkipTransientFields);

// 1.x: 序列化 null 值
// 2.x: JSON.config(JSONWriter.Feature.WriteNulls);