首页 > 软件编程 > java > Lombok @Data、@Getter、@Setter

Java Lombok中的@Data、@Getter、@Setter使用技巧全面指南

2025-08-14 08:55:06 作者：落鱼科技

本文详解Lombok的@Data、@Getter、@Setter注解,通过编译时自动生成getter/setter、toString等代码,简化Java开发流程,提升代码可读性与维护性,适合数据类、配置类等场景使用,感兴趣的朋友跟随小编一起看看吧

深入理解Lombok：@Data、@Getter、@Setter全面指南

作为Java开发者，你是否厌倦了写大量重复的getter/setter方法？是否在为维护冗长的toString、equals、hashCode方法而烦恼？本文将带你深入了解Lombok注解的使用技巧，让你的代码更加简洁优雅。

🚀 前言：告别样板代码的时代

在传统的Java开发中，一个简单的User类可能需要写50+行代码：

public class User {
    private String name;
    private Integer age;
    private String email;
    
    // 需要手动写的方法：
    // - 3个getter方法
    // - 3个setter方法  
    // - toString方法
    // - equals方法
    // - hashCode方法
    // - 构造函数
    // 总共50+行重复代码！😱
}

而使用Lombok，同样的功能只需要：

@Data
public class User {
    private String name;
    private Integer age;
    private String email;
}
// 7行代码搞定！🎉

这就是Lombok的魅力所在。让我们深入探索这个"懒人神器"的奥秘。

📚 Lombok简介

什么是Lombok？

Lombok是一个Java库，通过注解的方式在编译时自动生成常用的样板代码，如getter、setter、toString等方法。它的核心理念是：让开发者专注于业务逻辑，而不是重复的样板代码。

工作原理

Lombok在编译阶段通过APT（Annotation Processing Tool）技术，分析注解并生成相应的Java代码，最终编译成标准的字节码文件。

🎯 核心注解详解

1. @Data：万能选手

@Data是Lombok中最强大的注解，它是以下注解的组合：

@Getter - 所有字段的getter方法
@Setter - 所有非final字段的setter方法
@ToString - toString方法
@EqualsAndHashCode - equals和hashCode方法
@RequiredArgsConstructor - 必需参数构造函数

基础用法

@Data
public class Student {
    private String name;
    private Integer age;
    private String major;
    private List<String> hobbies;
}

编译后自动生成的方法：

// 自动生成的getter方法
public String getName() { return this.name; }
public Integer getAge() { return this.age; }
public String getMajor() { return this.major; }
public List<String> getHobbies() { return this.hobbies; }
// 自动生成的setter方法
public void setName(String name) { this.name = name; }
public void setAge(Integer age) { this.age = age; }
public void setMajor(String major) { this.major = major; }
public void setHobbies(List<String> hobbies) { this.hobbies = hobbies; }
// 自动生成的toString方法
public String toString() {
    return "Student(name=" + this.name + ", age=" + this.age + 
           ", major=" + this.major + ", hobbies=" + this.hobbies + ")";
}
// 自动生成的equals和hashCode方法
public boolean equals(Object o) { /* 完整的equals实现 */ }
public int hashCode() { /* 完整的hashCode实现 */ }
// 自动生成的构造函数
public Student() {}

高级配置

@Data
@ToString(exclude = {"password"})  // toString时排除敏感字段
@EqualsAndHashCode(exclude = {"id"})  // equals比较时排除id字段
public class User {
    private Long id;
    private String username;
    private String password;
    private String email;
}

2. @Getter：只读属性的守护者

@Getter注解专门用于生成getter方法，适合需要数据封装和只读访问的场景。

类级别使用

@Getter
public class ConfigInfo {
    private String appName = "MyApp";
    private String version = "1.0.0";
    private Date buildTime = new Date();
    // 只生成getter方法，保护数据不被外部修改
}
// 使用示例
ConfigInfo config = new ConfigInfo();
String appName = config.getAppName(); // ✅ 可以读取
config.setAppName("NewApp");          // ❌ 编译错误，没有setter

字段级别使用

public class BankAccount {
    @Getter
    private String accountNumber;     // 只读：账号不能修改
    @Getter @Setter
    private BigDecimal balance;       // 可读写：余额可以修改
    private String password;          // 完全私有：密码不能直接访问
    // 自定义密码验证方法
    public boolean verifyPassword(String inputPassword) {
        return this.password.equals(inputPassword);
    }
}

访问级别控制

public class SecurityUser {
    @Getter(AccessLevel.PUBLIC)
    private String username;          // public getter
    @Getter(AccessLevel.PROTECTED)
    private String internalId;        // protected getter
    @Getter(AccessLevel.PACKAGE)
    private String sessionToken;      // package-private getter
    @Getter(AccessLevel.PRIVATE)
    private String encryptionKey;     // private getter（基本无用）
    @Getter(AccessLevel.NONE)
    private String secretData;        // 不生成getter
}

3. @Setter：数据修改的管家

@Setter注解用于生成setter方法，适合需要数据输入和修改的场景。

基础用法

@Setter
public class UserRegistrationForm {
    private String username;
    private String password;
    private String email;
    private String captcha;
    // 只有setter方法，适合表单数据收集
}
// 使用示例
UserRegistrationForm form = new UserRegistrationForm();
form.setUsername("john_doe");    // ✅ 可以设置
form.setPassword("secret123");   // ✅ 可以设置
String name = form.getUsername(); // ❌ 编译错误，没有getter

链式调用支持

@Setter
@Accessors(chain = true)  // 启用链式调用
public class FluentUser {
    private String name;
    private Integer age;
    private String email;
}
// 链式调用示例
FluentUser user = new FluentUser()
    .setName("Alice")
    .setAge(25)
    .setEmail("alice@example.com");

参数验证

public class ValidatedUser {
    @Setter
    private String email;
    @Setter
    private Integer age;
    // 自定义setter with validation
    public void setEmail(String email) {
        if (email == null || !email.contains("@")) {
            throw new IllegalArgumentException("Invalid email format");
        }
        this.email = email;
    }
    public void setAge(Integer age) {
        if (age == null || age < 0 || age > 150) {
            throw new IllegalArgumentException("Invalid age");
        }
        this.age = age;
    }
}

🛠️ 实战应用场景

场景1：数据传输对象（DTO）

// 前端请求参数
@Data
@ApiModel("用户查询请求")
public class UserQueryDTO {
    @ApiModelProperty("用户名（支持模糊查询）")
    private String username;
    @ApiModelProperty("邮箱")
    private String email;
    @ApiModelProperty("年龄范围-最小值")
    private Integer minAge;
    @ApiModelProperty("年龄范围-最大值")
    private Integer maxAge;
    @ApiModelProperty("分页信息")
    private PageInfo pageInfo;
}
// 响应数据
@Data
@ApiModel("用户信息响应")
public class UserResponseVO {
    @ApiModelProperty("用户ID")
    private Long id;
    @ApiModelProperty("用户名")
    private String username;
    @ApiModelProperty("邮箱")
    private String email;
    @ApiModelProperty("年龄")
    private Integer age;
    @ApiModelProperty("注册时间")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private Date registerTime;
}

场景2：数据库实体类（Entity）

@Data
@Entity
@Table(name = "users")
@EqualsAndHashCode(exclude = {"id", "createTime", "updateTime"})
public class UserEntity {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    @Column(name = "username", unique = true, nullable = false)
    private String username;
    @Column(name = "email", unique = true)
    private String email;
    @Column(name = "password_hash")
    private String passwordHash;
    @Column(name = "status")
    @Enumerated(EnumType.STRING)
    private UserStatus status;
    @CreationTimestamp
    @Column(name = "create_time")
    private LocalDateTime createTime;
    @UpdateTimestamp  
    @Column(name = "update_time")
    private LocalDateTime updateTime;
    // 关联关系
    @OneToMany(mappedBy = "user", cascade = CascadeType.ALL)
    @ToString.Exclude  // 避免循环引用
    private List<OrderEntity> orders;
}

场景3：配置类

@Data
@ConfigurationProperties(prefix = "app.security")
@Component
public class SecurityConfig {
    private String jwtSecret = "defaultSecret";
    private Long jwtExpiration = 86400L; // 24 hours
    private Integer maxLoginAttempts = 5;
    private Long lockoutDuration = 1800L; // 30 minutes
    private Cors cors = new Cors();
    @Data
    public static class Cors {
        private List<String> allowedOrigins = Arrays.asList("*");
        private List<String> allowedMethods = Arrays.asList("GET", "POST", "PUT", "DELETE");
        private List<String> allowedHeaders = Arrays.asList("*");
        private Boolean allowCredentials = true;
    }
}

场景4：构建器模式增强

@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class ComplexUser {
    private String firstName;
    private String lastName;
    private String email;
    private Integer age;
    private Address address;
    private List<String> roles;
    private Map<String, Object> metadata;
    @Data
    @Builder
    @NoArgsConstructor
    @AllArgsConstructor
    public static class Address {
        private String street;
        private String city;
        private String state;
        private String zipCode;
        private String country;
    }
}
// 使用示例
ComplexUser user = ComplexUser.builder()
    .firstName("John")
    .lastName("Doe")
    .email("john.doe@example.com")
    .age(30)
    .address(ComplexUser.Address.builder()
        .street("123 Main St")
        .city("New York")
        .state("NY")
        .zipCode("10001")
        .country("USA")
        .build())
    .roles(Arrays.asList("USER", "ADMIN"))
    .metadata(Map.of("department", "IT", "level", "senior"))
    .build();

⚡ 性能与最佳实践

性能考虑

1. 编译时 vs 运行时

// Lombok：编译时生成代码，运行时无性能损耗
@Data
public class LombokUser {
    private String name;
    private Integer age;
}
// 反射：运行时动态调用，有性能损耗
public class ReflectionUser {
    private String name;
    private Integer age;
    public void setProperty(String propertyName, Object value) {
        Field field = this.getClass().getDeclaredField(propertyName);
        field.setAccessible(true);
        field.set(this, value); // 运行时反射调用
    }
}

2. 内存使用优化

@Data
@ToString(exclude = {"largeDataSet"})  // 排除大数据集，避免toString时内存问题
@EqualsAndHashCode(exclude = {"id", "createTime"})  // 排除不参与比较的字段
public class OptimizedEntity {
    private Long id;
    private String name;
    private LocalDateTime createTime;
    @ToString.Exclude
    private List<byte[]> largeDataSet;  // 大数据不参与toString
}

最佳实践

1. 团队规范建议

// ✅ 推荐：明确的注解使用规范
@Data
@ApiModel("用户信息")
public class UserDTO {
    @ApiModelProperty(value = "用户ID", example = "1001")
    private Long id;
    @ApiModelProperty(value = "用户名", required = true)
    @NotBlank(message = "用户名不能为空")
    private String username;
}
// ❌ 不推荐：缺乏文档和验证
@Data
public class UserDTO {
    private Long id;
    private String username;
}

2. 继承关系处理

// 父类
@Getter
@Setter
@ToString
public class BaseEntity {
    private Long id;
    private LocalDateTime createTime;
    private LocalDateTime updateTime;
}
// 子类
@Data
@EqualsAndHashCode(callSuper = true)  // 重要：包含父类字段
@ToString(callSuper = true)           // 重要：包含父类字段
public class UserEntity extends BaseEntity {
    private String username;
    private String email;
}

3. 循环引用处理

@Data
public class Department {
    private String name;
    @ToString.Exclude
    @EqualsAndHashCode.Exclude
    private List<Employee> employees;  // 避免循环引用
}
@Data
public class Employee {
    private String name;
    @ToString.Exclude
    @EqualsAndHashCode.Exclude  
    private Department department;     // 避免循环引用
}

🔧 高级特性与技巧

1. 自定义命名策略

@Data
@Accessors(prefix = "m")  // 字段前缀为m
public class PrefixedUser {
    private String mName;     // getter: getName(), setter: setName()
    private Integer mAge;     // getter: getAge(), setter: setAge()
}
@Data  
@Accessors(fluent = true)  // 流式接口
public class FluentUser {
    private String name;      // getter: name(), setter: name(String)
    private Integer age;      // getter: age(), setter: age(Integer)
}
// 使用示例
FluentUser user = new FluentUser().name("Alice").age(25);
String name = user.name();

2. 条件生成

public class ConditionalUser {
    @Getter
    @Setter(onParam_ = {@Valid})  // setter参数添加@Valid注解
    private @NotNull String username;
    @Getter(onMethod_ = {@JsonIgnore})  // getter方法添加@JsonIgnore注解
    private String password;
    @Getter(lazy = true)  // 懒加载getter
    private final String expensiveCalculation = calculateExpensive();
    private String calculateExpensive() {
        // 模拟耗时计算
        try { Thread.sleep(1000); } catch (InterruptedException e) {}
        return "Expensive Result";
    }
}

3. 与其他框架集成

// 与Jackson集成
@Data
@JsonNaming(PropertyNamingStrategies.SnakeCaseStrategy.class)
@JsonInclude(JsonInclude.Include.NON_NULL)
public class JsonUser {
    private String firstName;     // JSON: first_name
    private String lastName;      // JSON: last_name
    private Integer userAge;      // JSON: user_age
    @JsonProperty("email_address")
    private String email;         // JSON: email_address
    @JsonIgnore
    private String password;      // 不序列化
}
// 与JPA集成
@Data
@Entity
@Table(name = "users")
@EntityListeners(AuditingEntityListener.class)
public class JpaUser {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    @Column(unique = true)
    private String username;
    @CreatedDate
    private LocalDateTime createTime;
    @LastModifiedDate
    private LocalDateTime updateTime;
}

🚨 常见陷阱与解决方案

1. equals和hashCode陷阱

// ❌ 问题代码：包含可变字段导致HashMap行为异常
@Data
public class ProblematicUser {
    private String name;
    private List<String> hobbies;  // 可变集合参与equals/hashCode
}
// 测试问题
Map<ProblematicUser, String> map = new HashMap<>();
ProblematicUser user = new ProblematicUser();
user.setName("Alice");
user.setHobbies(new ArrayList<>(Arrays.asList("reading")));
map.put(user, "value");
user.getHobbies().add("swimming");  // 修改了hashCode
String value = map.get(user);       // null！找不到了
// ✅ 解决方案：排除可变字段或使用不可变集合
@Data
@EqualsAndHashCode(exclude = {"hobbies"})
public class SafeUser {
    private String name;
    private List<String> hobbies;
}

2. 循环引用陷阱

// ❌ 问题代码：toString时出现StackOverflowError
@Data
public class Parent {
    private String name;
    private List<Child> children;
}
@Data  
public class Child {
    private String name;
    private Parent parent;  // 循环引用
}
// ✅ 解决方案：使用@ToString.Exclude
@Data
public class SafeParent {
    private String name;
    @ToString.Exclude
    private List<SafeChild> children;
}
@Data
public class SafeChild {
    private String name;
    @ToString.Exclude
    private SafeParent parent;
}

3. 性能陷阱

// ❌ 问题代码：大集合参与toString
@Data
public class BigDataUser {
    private String name;
    private List<byte[]> bigDataList;  // 大数据集合
}
BigDataUser user = new BigDataUser();
user.setBigDataList(generateMassiveData());
System.out.println(user);  // 可能导致内存问题
// ✅ 解决方案：排除大数据字段
@Data
@ToString(exclude = {"bigDataList"})
public class OptimizedUser {
    private String name;
    private List<byte[]> bigDataList;
    // 自定义toString显示摘要信息
    public String getDataSummary() {
        return bigDataList != null ? 
            "DataList[size=" + bigDataList.size() + "]" : "DataList[empty]";
    }
}

🔄 迁移指南

从传统代码迁移到Lombok

步骤1：添加依赖和插件

<!-- Maven -->
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.30</version>
    <scope>provided</scope>
</dependency>

// Gradle
dependencies {
    compileOnly 'org.projectlombok:lombok:1.18.30'
    annotationProcessor 'org.projectlombok:lombok:1.18.30'
}

步骤2：渐进式迁移

// 原始代码
public class User {
    private String name;
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    // ... 其他样板代码
}
// 迁移步骤1：添加@Getter @Setter，保留原有方法
@Getter
@Setter  
public class User {
    private String name;
    // 保留原有方法，确保兼容性
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
}
// 迁移步骤2：测试通过后删除原有方法
@Getter
@Setter
public class User {
    private String name;
}
// 迁移步骤3：根据需要升级为@Data
@Data
public class User {
    private String name;
}

步骤3：团队培训清单

## Lombok使用规范
### ✅ 推荐做法
- 优先使用@Data处理简单数据类
- 使用@Getter处理只读数据  
- 复杂继承关系谨慎使用@EqualsAndHashCode
- 循环引用场景使用@ToString.Exclude
### ❌ 避免做法
- 不要在所有类上盲目使用@Data
- 不要忽略equals/hashCode的语义
- 不要在大数据字段上使用默认toString
- 不要在API接口类上使用@Data

📊 对比总结

特性	传统写法	@Getter	@Setter	@Data
代码量	50+行	减少60%	减少40%	减少90%
可读性	差	良好	良好	优秀
维护性	差	良好	良好	优秀
性能	标准	标准	标准	标准
灵活性	最高	高	高	中等
学习成本	无	低	低	低
团队接受度	100%	高	高	高

🎉 总结

Lombok通过编译时代码生成技术，极大地简化了Java开发中的样板代码编写。合理使用@Data、@Getter、@Setter等注解，可以让代码更加简洁、易读、易维护。

选择建议

🥇 @Data：适用于80%的数据类场景，功能全面，使用简单
🥈 @Getter：适用于只读数据，如配置类、查询结果等
🥉 @Setter：适用于只写数据，如表单参数、更新对象等
🔧 组合使用：适用于需要精确控制的复杂场景

最后的建议

从小处开始：先在新的数据类上尝试使用
保持一致性：团队内部统一使用规范
关注细节：注意equals/hashCode语义和循环引用问题
持续学习：关注Lombok的新特性和最佳实践

记住：工具是为了让开发更高效，而不是炫技。选择最适合你项目和团队的方案，才是最好的方案。

希望这篇文章能帮助你更好地理解和使用Lombok。如果你有任何问题或建议，欢迎在评论区交流讨论！

📚 参考资源

到此这篇关于Java Lombok中的@Data、@Getter、@Setter使用技巧全面指南的文章就介绍到这了,更多相关深入理解Lombok：@Data、@Getter、@Setter全面指南内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

Java Lombok中的@Data、@Getter、@Setter使用技巧全面指南

深入理解Lombok：@Data、@Getter、@Setter全面指南

🚀 前言：告别样板代码的时代

📚 Lombok简介

什么是Lombok？

工作原理

🎯 核心注解详解

1. @Data：万能选手

基础用法

高级配置

2. @Getter：只读属性的守护者

类级别使用

字段级别使用

访问级别控制

3. @Setter：数据修改的管家

基础用法

链式调用支持

参数验证

🛠️ 实战应用场景

场景1：数据传输对象（DTO）

场景2：数据库实体类（Entity）

场景3：配置类

场景4：构建器模式增强

⚡ 性能与最佳实践

性能考虑

1. 编译时 vs 运行时

2. 内存使用优化

最佳实践

1. 团队规范建议

2. 继承关系处理

3. 循环引用处理

🔧 高级特性与技巧

1. 自定义命名策略

2. 条件生成

3. 与其他框架集成

🚨 常见陷阱与解决方案

1. equals和hashCode陷阱

2. 循环引用陷阱

3. 性能陷阱

🔄 迁移指南

从传统代码迁移到Lombok

步骤1：添加依赖和插件

步骤2：渐进式迁移

步骤3：团队培训清单

📊 对比总结

🎉 总结

选择建议

最后的建议

📚 参考资源

您可能感兴趣的文章: