在Java里getter和setter方法如何规范编写_Java属性封装实践说明_技术教程

JavaBeans规范要求getter/setter严格遵循命名约定，如boolean字段用isXxx()、多单词字段驼峰大写、URL字段用getURL()，禁止在其中添加业务逻辑或副作用，并注意Lombok兼容性与继承陷阱。

Java里getter和setter方法不是随便起名或加逻辑就能算“规范”的——IDE自动生成的只是语法合法，不等于符合JavaBeans规范、不影响序列化、不破坏Lombok兼容性，更不一定适合实际业务场景。

getter/setter必须严格遵循JavaBeans命名约定

这是反序列化（如Jackson、XML解析）、反射框架（Spring BeanUtils）、IDE自动识别字段绑定的前提。违反会导致PropertyNotFoundException或静默失败。

布尔类型字段推荐用isXxx()而非getXxx()：比如private boolean enabled; → public boolean isEnabled()，public void setEnabled(boolean enabled)
首字母小写的多单词字段，驼峰后首字母必须大写：比如private String userName; → getUserName()，不是getusername()或getUserName()拼错成getUsernName()
字段名为URL时，标准写法是getURL()，不是getUrl()；但setUrl()会被部分工具误判，稳妥做法是统一用getURL()/setURL(URL url)

不要在getter/setter里写业务逻辑或副作用

看似“方便”，实则埋下严重隐患：Hibernate懒加载触发、Jackson序列化死循环、单元测试难Mock、Lombok@Data生成冲突。

禁止在getCreateTime()里自动调用new Date() —— 这会让每次访问都返回新时间，且破坏不可变性假设
禁止在setName(String name)里做trim()或校验并抛异常 —— setter应只赋值，校验应放在构造函数或专门的validate()方法中
避免getter中调用Objects.requireNonNull()或懒初始化集合：这会让Jackson在序列化时意外触发NPE或改变对象状态

使用Lombok时注意与手动getter/setter共存的陷阱

Lombok的@Getter/@Setter不会覆盖已存在的同签名方法，但会跳过生成 —— 表面无报错，实则行为不一致。

如果类里已有getName()，再加@Getter，Lombok不会警告，但getName()逻辑不会被增强（比如你忘了同步加@NonNull校验）
@Data默认包含@Getter/@Setter，但如果某个字段加了transient，Lombok仍会为它生成setter —— 可能导致反序列化时意外覆盖瞬态字段
继承关系中，父类用@Getter，子类手动写getAge()，IDE可能提示“method hides another method”，但运行时JVM按重写规则调用，容易误判行为来源

需要定制行为时，优先用组合而非重写getter/setter

比如字段需加密存储、单位转换、缓存计算结果，硬改getter/setter会让职责混乱，且难以复用。

敏感字段如password，用单独的encryptPassword(String raw)和matchesPassword(String input)，而不是在setPassword()里加密
时间字段如createTime（数据库存秒级时间戳），暴露为LocalDateTime时，用getCreateTimeAsLocalDateTime()显式命名，不覆盖getCreateTime()（保持原始long语义）
计算属性如fullName，不声明字段，直接提供getFullName()，并加上@JsonIgnore（防JSON序列化）和@Transient（防JPA持久化）

public class User {
    private Long id;
    private String firstName;
    private String lastName;
    private int age;

    // 计算属性，不对应数据库字段
    public String getFullName() {
        return firstName + " " + lastName;
    }

    // 显式转换方法，避免歧义
    public LocalDateTime getBirthDateAsLocalDateTime() {
        return Instant.ofEpochSecond(birthTimestamp).atZone(ZoneId.systemDefault()).toLocalDateTime();
    }
}

真正麻烦的从来不是“怎么写”，而是“为什么不能那样写”——比如getURL()少一个U，可能让OpenAPI文档生成器彻底丢掉这个字段；setEnabled(true)里悄悄记录日志，会让批量更新性能骤降却难以排查。规范不是约束，是降低协作熵值的最小公约数。