注解

MyBatis-Plus

1. @TableName("landchain_common_query")
   • 用于指定当前实体类对应的数据库表名， 这里表示该类映射到数据库中的 landchain_common_query 表，ORM 框架会根据此注解进行表与类的关联操作（如 CRUD）

Lombok注解

1. @Accessors(chain = true)

   • 用于配置实体类的setter方法的链式调用。- 当 chain = true 时，实体类的 setter 方法会返回当前对象本身（return this;），支持类似 user.setName("xxx").setAge(18) 的链式赋值，简化代码编写。

2. @EqualsAndHashCode(callSuper = false)

   • Lombok 注解，用于自动生成 equals() 和 hashCode() 方法。
   • callSuper = false 表示生成这两个方法时不包含父类的属性 （仅考虑当前类的字段）。如果设为 true，则会将父类的属性也纳入计算（此处因继承自 Object，影响不大）。

Swagger 注解

1. @ApiModel(value="通用查询配置对象", description="通用查询配置")

   • Swagger 注解，用于描述 API 接口中的实体类信息（在接口文档中展示）。
   • value 是实体类的简要名称，description 是详细描述，生成接口文档时会显示这些信息，方便开发者理解该实体的用途。

2. @ApiModelProperty(value = "主键")

   • Swagger 注解，用于描述实体类的字段信息（在接口文档中展示）。
   • value 是字段的说明，生成文档时会显示该字段的含义，帮助开发者理解接口参数或返回值中该字段的作用。

Jackson 注解

1. @JsonFormat(timezone = "GMT+8",pattern = "yyyy-MM-dd HH:mm:ss")

   • Jackson 注解，用于指定 JSON 序列化 / 反序列化时日期字段的格式和时区。
   • pattern 定义了日期的格式（年 - 月 - 日 时：分: 秒），timezone = "GMT+8" 指定时区为东八区（避免时区转换导致的时间偏差）。当实体类被转为 JSON 时，日期会按此格式显示；接收 JSON 时，也会按此格式解析。

spring注解

1. @DateTimeFormat(pattern="yyyy-MM-dd HH:mm:ss")

   • Spring 注解，用于指定前端传递的日期字符串参数绑定到后端实体类日期字段时的格式。
   • 例如，前端传递 2024-05-21 10:30:00 字符串时，Spring 会自动按此格式解析为 Date 类型对象。

JeecgBoot注解

1. @Excel(name = "数据源名称", width = 15)

   • JeecgBoot 集成的 POI 注解（用于 Excel 导入导出），指定该字段在 Excel 中的列名和宽度。
   • name 是 Excel 表头的名称，width 是列的宽度（单位为字符）。当导出数据到 Excel 时，该字段会按此配置显示；导入时，也会根据表头匹配字段。