Java中实现只读封装的核心是字段声明为private final、仅提供public getter、杜绝public setter，并在构造器中完成初始化；需对可变类型返回不可变副本，禁止getter有副作用，敏感字段可脱敏处理。
Java 中实现只读封装，核心是让外部能“看”不能“改”——字段私有化、只暴露 getter、杜绝 setter 入口，并在细节上守住不可变性底线。
字段必须声明为 private + final
这是只读语义的根基。不加 private，外部可直接赋值；不加 final，构造后仍可能被意外修改。
- 正确写法：private final String id;、private final LocalDateTime createTime;
- 错误写法：public String name;、private String status;（没 final，后续可能被改）
- 所有字段必须在构造方法或初始化块中一次性赋值，禁止留空或延迟设值
只提供 public getter，不写任何 public setter
getter 是唯一出口，命名要规范、行为要纯粹：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 布尔类型用 isXxx()，如 isActive()、isLocked()
- 引用类型返回前做防御性拷贝：List 返回 Collections.unmodifiableList(items)；Date 返回 new Date(date.getTime())；自定义对象若可变，考虑返回深拷贝或只读包装
- 禁止在 getter 中执行耗时操作（如查库、解析 JSON）、修改状态或触发副作用
构造器完成全部初始化，拒绝运行时变更
只读类不是靠“不写 setter”来保证，而是靠“无法改”来落实：
- 推荐使用全参构造器，确保每个 final 字段都有明确来源
- 如需灵活构建，配合 Builder 模式，但 Builder 的 build() 方法必须一次性完成 final 字段赋值
- 避免使用 Lombok 的 @Data 或 IDE 自动生成 setter——它们会悄悄破坏只读契约
敏感字段可叠加业务级防护
只读不等于“原样暴露”，尤其涉及隐私或合规场景：
- 手机号、身份证号等可在 getter 中自动脱敏：return StringUtils.hideMiddle(phone, 3, 4);
- 状态字段可封装转换逻辑：public String getStatusDesc() { return Status.fromCode(status).getDesc(); }，但不暴露原始码值
- 若字段允许 null，getter 应安全处理，比如返回空集合而非抛 NPE
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
