文章模块建设中
用于展示各类文章信息
建设进度20%
markdown部分建设内容展示
文章示例: java代码规范及使用规则
代码开发层级规范
entity(实体类)
使用场景
- 包含数据库相关的注解(如@Table、@Column等)
- 通常位于entity或model包下
- 直接映射数据库表结构
使用时机
- 不要将Entity直接暴露给Controller层
- 在DAO/Repository层与数据库交互
domain(领域模型)
使用场景
- 不包含持久化相关的注解
- 承载业务逻辑和规则
- 通常位于domain包下
使用时机
- 在Service层处理业务逻辑
- 作为核心业务模型使用
DTO(数据传输对象)
使用场景
- 定义接口层的数据传输结构
- 可以包含数据校验注解
- 通常位于dto包下
使用时机
- 返回给前端的响应数据
- 在Controller层接收前端请求
最佳实践建议
- 职责分离:
- Domain专注于业务逻辑
- DTO专注于数据传输和展示
- Entity专注于数据持久化
- 转换器模式:
- 保持各层数据模型的独立性
- 使用MapStruct或手写Converter处理对象转换
- 验证分组:
public interface Create {}
public interface Update {}
@NotNull(groups = Update.class)
private Long id;
- 层次规范:
- Controller层:使用DTO
- Repository层:使用Entity
- Service层:使用Domain
提高代码的可维护性 降低各层之间的耦合 使代码结构更清晰 便于单元测试 提高代码重用性