介绍

@DerivedField 用于从已解码的原始协议字段中衍生出业务视图，而无需改动原有的编解码字段。

典型的应用场景：

• 将 long 类型的位段（如状态字）自动解析为 Set<Enum>，而非手动编写位运算
• 将原始数值映射为可读的业务描述（如 0 → "offline"，1 → "online"）
• 编码时将业务视图逆向回写为原始协议的字段值

介绍

在 之前的版本中，无论是 内置注解 还是 自定义注解，表达式 都是通过 SpEL 来实现的。

从 开始，xtream-codec 新增了 @Expression 注解。支持三种表达式：

• SpEL（默认）
• MVEL
• Aviator

介绍

协议是会进化的。版本升级时，往往只是部分字段发生变化：

• 某字段在旧版本中是 u8，新版本变成了 u16
• 某字段在旧版本中以 GBK 编码，新版本改用 UTF-8
• 某字段干脆就是新版本才有的
• ……

若为每个版本维护一套独立的 Entity 类，代码将迅速膨胀，版本之间的差异淹没在重复的 boilerplate 中。

@XtreamField 的 version 属性便是为此而生——在 同一 Entity 类 中，通过 同一字段 上的多个注解声明，精确控制每个版本下该字段的编解码行为。

请先读我

内置注解都是从 @XtreamField 注解扩展而来的。目前有两种风格的注解：

• Rust 数据类型命名风格
• JT/T 808 协议数据类型命名风格

自定义注解都是通过元注解 @XtreamField 的来实现的。

本示例将演示通过 @XtreamField 来实现一个自定义的日期注解。

注解定义

注解声明

@Target({ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@XtreamField(fieldCodec = MyDateTypeFieldCodec.class, dataType = BeanPropertyMetadata.FiledDataType.basic)
public @interface MyDateType {

    @AliasFor(annotation = XtreamField.class, attribute = "order")
    int order() default -1;

    @AliasFor(annotation = XtreamField.class, attribute = "condition")
    String condition() default "";

}

介绍

@XtreamField 是最基础的注解。

内置的 别名(Alias) 注解 @Preset.RustStyle.xxx 和 @Preset.JtStyle.xxx 都是基于 @XtreamField 这个基础注解 衍生 的。