高内聚实体类应优先使用基本类型、构造器强制初始化、final 不可变、校验前移；字段非空、值域受控，从源头杜绝 NPE。
设计高内聚实体类并合理选用基本类型，核心在于让对象从创建起就“天然不空”——字段有明确语义、不可为 null、值域受控，从而在源头切断 NullPointerException（NPE）的传播路径。
一、用基本类型替代包装类，堵住自动拆箱陷阱
包装类型（如 Integer、Boolean、Long）是 NPE 的高发区，尤其在参与算术运算或条件判断时，一旦为 null 就会立即崩溃。
- ✅ 优先使用 int、boolean、long 等基本类型表示业务上“必须存在”的数值或状态（例如用户年龄、订单状态码、商品库存数量）
- ❌ 避免用 Integer status 表示“订单状态”，改用 int status 并配合枚举或常量校验（如 status == OrderStatus.PAID.code()）
- ⚠️ 若真需表达“未设置/未知”语义（如历史数据缺失），应显式建模为枚举项（UNKNOWN）或专用状态字段（isStatusKnown: boolean），而非依赖 null
二、字段初始化 + 构造器强制约束，确保对象一创建就完整
高内聚意味着实体的状态逻辑紧密绑定，不能靠 setter 零散赋值。所有关键字段应在构造时确定，杜绝“半成品”对象。
- 提供全参构造器（或 Builder），要求传入所有非可选字段（如 id、username、createTime）
- 私有字段直接初始化默认值：private final LocalDateTime createTime = LocalDateTime.now();
- 字符串字段用空字符串代替 null：private String nickname = "";（配合 @NotBlank 注解做校验）
- 集合字段一律初始化为空集合：private List<Role> roles = new ArrayList<>();，永不返回 null
三、用不可变性 + final 保障状态一致性
内聚性不仅体现在字段组合，更体现在行为边界清晰。禁止外部随意修改核心状态，可大幅降低因并发或误操作导致的 null 污染。
立即学习“Java免费学习笔记（深入）”；
- 关键字段声明为 final（如 id、username、email），构造后不可变
- 集合类返回不可修改视图：public List<Role> getRoles() { return Collections.unmodifiableList(roles); }
- 避免提供 public setter；如需更新，用 withXxx 方法返回新实例（函数式风格）或专用更新 DTO
四、校验前移：注解 + 构造期断言双保险
光靠类型和初始化还不够，需在对象诞生第一刻就拦截非法值。
- 使用 @NotNull、@NotBlank、@Min(1) 等 Bean Validation 注解，在框架层（如 Spring MVC 入参绑定）自动拦截
- 在构造器中手动校验：Objects.requireNonNull(username, "用户名不能为空")，失败即抛明确异常，不留给后续逻辑兜底
- 对可能来自外部的数据（如 JSON 反序列化），启用 Jackson 的 @JsonSetter(nulls = Nulls.FAIL)，拒绝 null 值注入
