提示
- 在阅读本文之前，建议先阅读 协议格式说明
- 所谓的 扁平化写法 就是不用单独封装
Header和Body，而是直接将Header和Body的数据写在同一个实体类中
大约 1 分钟
小于 1 分钟
todo 后面补齐: ...
小于 1 分钟
todo 后面补齐: ...
小于 1 分钟
请先读我
内置注解都是从 @XtreamField 注解扩展而来的。目前有两种风格的注解：
Rust数据类型命名风格JT/T 808协议数据类型命名风格
提示
- 强烈推荐优先使用
Rust风格内置注解- 数据类型比较全面
JT/T 808风格的注解只支持无符号，因为JT/T 808官方文档里都是无符号数
- 支持小端序
- 数据类型比较全面
- 不推荐直接使用底层的
@XtreamField注解- 虽然功能最完整，但是使用略显繁琐
- 但是如果你要自定义注解，那非常推荐使用
@XtreamField来进行扩展
大约 4 分钟
自定义注解都是通过元注解 @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 "";
}
大约 1 分钟
1.整数类型
| 长度 | 符号位 | JavaType | Rust风格注解 | JT风格注解 |
|---|---|---|---|---|
| 1 | 无 | byte/Byte |
@Preset.RustStyle.u8 |
@Preset.JtStyle.Byte |
| 1 | 有 | short/Short |
@Preset.RustStyle.i8 |
-- |
| 2 | 无 | short/Short |
@Preset.RustStyle.u16 |
@Preset.JtStyle.WORD |
| 2 | 有 | int/Integer |
@Preset.RustStyle.i16 |
-- |
| 4 | 无 | int/Integer |
@Preset.RustStyle.u32 |
@Preset.JtStyle.DWORD |
| 4 | 有 | long/Long |
@Preset.RustStyle.i32 |
-- |
| 8 | 无 | long/Long |
@Preset.RustStyle.u64 |
-- |
小于 1 分钟
介绍
@XtreamField 是最基础的注解。
内置的 别名(Alias) 注解 @Preset.RustStyle.xxx 和 @Preset.JtStyle.xxx 都是基于 @XtreamField 这个基础注解 衍生 的。
提示
注解别名都是依赖于 Spring 的 @org.springframework.core.annotation.AliasFor 注解实现的。
大约 2 分钟