Java领域模型示例详解

// 纯POJO，无任何注解/继承，仅存数据
public class UserPojo {
    private Long id;
    private String name;
    private Integer age;
    // 必须有：无参构造、get/set方法
    public UserPojo() {}
    // get/set省略
}

// 与数据库user表严格映射
@TableName("user") // MyBatis注解：指定对应表名
public class UserEntity {
    @TableId(type = IdType.AUTO) // 主键+自增策略
    private Long id; // 对应表中id字段（bigint类型）
    @TableField("username") // 字段名与表一致（若相同可省略）
    private String username; // 对应表中username字段（varchar）
    private String password; // 对应表中password字段（敏感字段，需加密存储）
    @TableField(value = "create_time", fill = FieldFill.INSERT)
    private LocalDateTime createTime; // 对应表中create_time字段（datetime）
    // 无参构造、get/set方法
}

// 前端登录时传递的参数（仅包含必要字段）
public class LoginDTO {
    @NotBlank(message = "用户名不能为空") // 可加参数校验注解
    private String username;
    @NotBlank(message = "密码不能为空")
    private String password;
    // get/set方法
}

// 微服务间传输的用户数据（屏蔽敏感字段）
public class UserSimpleDTO {
    private Long id;
    private String username; // 仅传用户名，不含password
    private String role; // 仅传必要的角色信息
    // get/set方法
}

// 前端用户列表页展示的数据（组合多表字段+格式化）
public class UserListVO {
    private Long userId; // 前端习惯用userId，而非id
    private String username; // 用户名（来自UserEntity）
    private String roleName; // 角色名称（来自RoleEntity，UserEntity中无此字段）
    private String createTimeStr; // 格式化后的时间（如"2024-05-01"，前端直接展示）
    // get/set方法
}

// 订单业务处理的BO（包含业务计算逻辑）
public class OrderBO {
    // 基础数据（来自Entity）
    private OrderEntity order; // 订单基本信息
    private List<OrderItemEntity> items; // 订单项列表
    // 业务计算结果（非数据库字段）
    private BigDecimal totalAmount; // 总金额（计算：sum(单价×数量)）
    private BigDecimal discountAmount; // 折扣金额（根据会员等级计算）
    private BigDecimal payAmount; // 实付金额（totalAmount - discountAmount）
    // 业务方法：计算金额（包含核心业务逻辑）
    public void calculateAmount(UserEntity user) {
        // 1. 计算总金额
        this.totalAmount = items.stream()
                .map(item -> item.getPrice().multiply(new BigDecimal(item.getQuantity())))
                .reduce(BigDecimal.ZERO, BigDecimal::add);
        // 2. 计算折扣（会员等级越高，折扣越大）
        this.discountAmount = calculateDiscount(user.getVipLevel(), totalAmount);
        // 3. 计算实付金额
        this.payAmount = totalAmount.subtract(discountAmount);
    }
    // 私有辅助方法（业务逻辑细节）
    private BigDecimal calculateDiscount(Integer vipLevel, BigDecimal total) {
        if (vipLevel >= 3) return total.multiply(new BigDecimal("0.1")); // 10%折扣
        if (vipLevel >= 2) return total.multiply(new BigDecimal("0.05")); // 5%折扣
        return BigDecimal.ZERO;
    }
    // get/set方法
}