Lombok 注解总结

news2026/4/2 16:48:03

一、前言

Lombok 是一个 Java 库，用于通过注解方式自动化生成 Java 类的常用方法（如 getter、setter、toString 等），从而简化开发流程并减少重复性代码。以下是 Lombok 库中常用的注解及其作用。

二、常用注解

2.1、@Data

结合了@Getter、@Setter、@EqualsAndHashCode和@ToString的功能。

使用@Data注解后，Lombok会自动为类生成getter、setter、equals、hashCode和toString等方法。

import lombok.Data;

@Data
public class Person {
    private String name;
    private int age;
}

2.2、@Builder

自动生成构建对象的 builder 模式。Builder 模式可以简化对象的创建，特别是当类的构造参数较多时。

import lombok.Builder;

@Builder
public class User {
    private String name;
    private int age;
    private String email;
}

在上述示例中，我们使用了 @Builder 注解来标记 User 类，Lombok 会为 User 类生成一个内部静态类 UserBuilder，用于构建 User 对象。

使用 @Builder 生成的构建器可以按照以下方式来使用：

User user = User.builder()
                .name("John")
                .age(25)
                .email("john@example.com")
                .build();

2.3、@Slf4j

自动生成日志记录变量，通常与具体的日志库（如 Logback、Log4j2）配合使用。

import lombok.extern.slf4j.Slf4j;

@Slf4j
public class UserService {
    public void logMessage() {
        log.info("This is a log message.");
    }
}

在上述示例中，我们使用了 @Slf4j 注解来标记 UserService 类。Lombok 会自动生成一个名为 log 的日志记录变量，你可以在类中使用这个变量来进行日志记录。在这里，我们使用了 log.info(“This is a log message.”) 来记录一条信息日志。

需要注意的是，使用 @Slf4j 注解前，你需要确保项目中已经配置了相应的日志框架，如 Logback、Log4j2 等。Lombok 会自动与这些日志框架集成，使得生成的日志记录变量能够正确地执行日志输出。

2.4、@Value

生成不可变类，类似于 @Data，但不会生成 setter 方法。不可变类指的是一旦创建对象，就不能再修改它的字段值。使用 @Value 注解可以避免意外的修改对象的状态，从而增加代码的健壮性和可维护性。

import lombok.Value;

@Value
public class User {
    private String name;
    private int age;
}

请注意，由于 @Value 注解生成的类是不可变的，所以它不会生成 setter 方法。如果需要在对象创建后对字段进行修改，就不适合使用 @Value 注解。但对于不需要修改的数据对象，使用 @Value 可以保证对象状态的一致性，从而减少错误和代码维护难度。

2.5、@RequiredArgsConstructor

自动生成必需参数的构造方法，通常用于 final 属性。

import lombok.RequiredArgsConstructor;

@RequiredArgsConstructor
public class User {
    private final String name;
    private int age;
    private final String email;
}

在上述示例中，三个字段：name、age 和 email。通过在类上使用 @RequiredArgsConstructor 注解，Lombok 会自动生成一个构造方法，该构造方法只包含 name 和 email 这两个被标记为 final 的字段作为参数，age 字段不会包含在构造方法中。

2.6、@NoArgsConstructor

生成无参构造函数。

import lombok.NoArgsConstructor;

@NoArgsConstructor
public class Person {
    private String name;
    private int age;
}

2.7、@AllArgsConstructor

自动生成包含所有非静态字段的构造函数（全参构造方法）。

import lombok.AllArgsConstructor;

@AllArgsConstructor
public class Person {
    private String name;
    private int age;
}

使用@AllArgsConstructor注解后，Lombok会为所有非静态字段生成构造函数。

2.8、@EqualsAndHashCode

自动生成equals()和hashCode()方法，用于对象的比较和哈希计算。

import lombok.EqualsAndHashCode;

@EqualsAndHashCode
public class Person {
    private String name;
    private int age;
}

使用@EqualsAndHashCode注解后，Lombok会自动生成equals()和hashCode()方法。

2.9、@ToString

自动生成toString()方法，方便对象的打印输出。

import lombok.ToString;

@ToString
public class Person {
    private String name;
    private int age;
}

使用@ToString注解后，Lombok会自动生成toString()方法，以便打印对象的字段值。

2.10、@Getter和@Setter

为类的字段自动生成getter和setter方法。

import lombok.Getter;
import lombok.Setter;

public class Person {
    @Getter @Setter
    private String name;
    @Getter @Setter
    private int age;
}