1. JEECGBoot注解体系概览
作为国内广泛使用的低代码开发平台,JEECGBoot通过注解机制大幅简化了企业级应用的开发流程。我在三个大型项目中深度使用JEECGBoot后发现,其注解设计遵循"约定优于配置"原则,开发者只需掌握约20个核心注解即可覆盖90%的业务场景。这些注解主要分布在四个层级:
- 实体层注解:@Table、@Column等JPA标准注解与JEECG扩展注解的组合
- 控制层注解:@AutoLog、@RequiresRoles等业务操作注解
- API文档注解:@Api、@ApiOperation等Swagger集成注解
- 特殊功能注解:@Dict、@Excel等JEECG特色功能注解
提示:JEECGBoot 3.0后对注解体系进行了重构,部分注解的包路径从
org.jeecg变更为org.jeecg.modules,迁移项目时需特别注意。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 实体建模核心注解解析
2.1 基础字段映射
java复制@Table(name = "sys_user")
public class User {
@Id
@GeneratedValue(generator = "UUID")
@GenericGenerator(name = "UUID", strategy = "uuid")
private String id;
@Column(name = "username", nullable = false, length = 50)
private String username;
@Excel(name = "性别", width = 15, dicCode = "sex")
@Dict(dicCode = "sex")
private Integer gender;
}
@GenericGenerator配合Hibernate实现主键策略,实际项目中更推荐使用JEECG封装的@TableId注解@Excel注解的width属性建议设置为中文字符数×2+5(如15个中文字符对应width=35)@Dict实现数据字典自动转换
