文章模块建设中

用于展示各类文章信息

建设进度20%

markdown部分建设内容展示

文章示例: java代码规范及使用规则

代码开发层级规范

entity(实体类)

使用场景
  • 包含数据库相关的注解(如@Table、@Column等)
  • 通常位于entity或model包下
  • 直接映射数据库表结构
使用时机
  • 不要将Entity直接暴露给Controller层
  • 在DAO/Repository层与数据库交互

domain(领域模型)

使用场景
  • 不包含持久化相关的注解
  • 承载业务逻辑和规则
  • 通常位于domain包下
使用时机
  • 在Service层处理业务逻辑
  • 作为核心业务模型使用

DTO(数据传输对象)

使用场景
  • 定义接口层的数据传输结构
  • 可以包含数据校验注解
  • 通常位于dto包下
使用时机
  • 返回给前端的响应数据
  • 在Controller层接收前端请求

最佳实践建议

  1. 职责分离:
  • Domain专注于业务逻辑
  • DTO专注于数据传输和展示
  • Entity专注于数据持久化
  1. 转换器模式:
  • 保持各层数据模型的独立性
  • 使用MapStruct或手写Converter处理对象转换
  1. 验证分组:
public interface Create {}
public interface Update {}

@NotNull(groups = Update.class)
private Long id;
  1. 层次规范:
  • Controller层:使用DTO
  • Repository层:使用Entity
  • Service层:使用Domain

提高代码的可维护性 降低各层之间的耦合 使代码结构更清晰 便于单元测试 提高代码重用性

后续更新: MapStruct或手写Converter 使用场景 最佳时间 使用时机