在Java里如何实现数据封装_Java访问修饰符使用说明_技术教程

Java数据封装靠private字段+public getter/setter实现，本质是隐藏内部表示、暴露可控接口；private确保字段仅本类可访问，getter/setter可加入校验、日志等逻辑，避免直接读写破坏封装。

Java 里的数据封装不是靠语法强制，而是靠访问修饰符配合设计习惯来实现的 —— private 字段 + public getter/setter 是最常见、最有效的落地方式。

为什么字段必须用 `private` 才算封装

封装的本质是「隐藏内部表示，暴露可控接口」。如果字段声明为 public、protected 或包级（默认），外部代码就能直接读写，绕过任何校验或逻辑，等于没封装。

private 字段：只能在本类内访问，是封装的起点
不提供 getter/setter：字段彻底不可见，适合只读常量或内部状态
提供 public getter/setter：控制读写入口，可在方法里加校验、日志、通知等
setter 中不做校验（比如直接 this.age = age;）仍是封装，只是“松散封装”——至少字段本身不可直改

`getXXX()` 和 `setXXX()` 的命名与行为边界

JavaBean 规范约定 getter/setter 命名，但实际是否遵守不影响封装效果；重点是它们的行为是否符合业务约束。

布尔字段推荐用 isXXX()（如 isActive()），而非 getActive()；但 Boolean 包装类型仍可用 getXXX()
setter 不一定非要设值：例如 setName(String name) 可以拒绝空字符串、自动 trim、触发事件，甚至抛出 IllegalArgumentException
getter 可以返回副本（如 new ArrayList(this.items)），防止外部修改内部集合
不要在 getter 里做重操作（如查数据库、解析 JSON），这会隐式增加调用成本，且违背“获取值”的语义

什么时候该用 `protected` 或包级修饰符

它们不是封装的破坏者，而是有明确协作边界的封装策略 —— 关键看「谁需要访问」和「谁负责维护契约」。

protected：仅用于子类需直接访问父类状态的场景，比如模板方法中子类要覆写部分逻辑并依赖某个字段；滥用会导致继承树耦合变高
包级（默认）：适合模块内协作，比如同一 package 下的 Entity、Mapper、Validator 共享某些中间状态字段；但跨包调用时仍需通过 public API
永远不要因为“写起来方便”而把字段设为 protected 或包级 —— 一旦开放，后续想收回来就会引发大量编译错误或运行时故障

IDE 自动生成 vs 手写 getter/setter 的取舍

现代 IDE（IntelliJ / Eclipse）能一键生成 getter/setter，但自动生成只是起点，不是终点。

自动生成的 setter 默认无校验，上线后可能因非法值导致空指针或业务异常
集合类字段（如 List）自动生成的 getter 返回原引用，外部可随意 add/remove —— 必须手动改为返回不可变视图或副本
某些字段根本不该有 setter（如创建时间 createdAt），自动生成后得立刻删掉
Lombok 的 @Getter/@Setter 能减少样板代码，但掩盖了字段访问的实际路径；调试或排查 NPE 时，容易忽略“看似普通字段实为代理方法调用”这一层

public class User {
    private String name;
    private int age;
    private final LocalDateTime createdAt = LocalDateTime.now();
    private List roles = new ArrayList<>();

    // 手动增强的 setter：校验 + 规范化
    public void setName(String name) {
        if (name == null || name.trim().isEmpty()) {
            throw new IllegalArgumentException("name cannot be blank");
        }
        this.name = name.trim();
    }

    // 手动增强的 getter：返回不可变副本，防外部篡改
    public List getRoles() {
        return Collections.unmodifiableList(roles);
    }

    // 没有 setCreatedAt() —— 创建时间只读
    public LocalDateTime getCreatedAt() {
        return createdAt;
    }
}