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”来保证，而是靠“无法改”来落实：

立即学习“Java免费学习笔记（深入）”；

• 推荐使用全参构造器，确保每个 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