[SpringBoot] Lombok

💡 Java 라이브러리로 개발을 하면서 기계적으로 작성하게 되는 Getter, Setter, ToString 등의 메서드 작성 코드를 Annotation으로 대신해 코드 다이어트를 도와줌

장점

• 어노테이션 기반의 코드 자동 생성을 통한 생산성 증가
• 코드 다이어트를 통한 코드 가독성 및 유지보수성 증가

Ex>

기존 코드

public class Car {

    private String seqNumber;
    private String id;
    private String name;

    public Car() {}

    public Car(String seqNumber, String id, String name) {
        this.seqNumber = seqNumber;
        this.id = id;
        this.name = name;
    }

    public String getSeqNumber() {
        return seqNumber;
    }

    public void setSeqNumber(String seqNumber) {
        this.seqNumber = seqNumber;
    }

    public String getId() {
        return id;
    }

    public void setId(String id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    @Override
    public String toString() {
        return "Car{" +
                "seqNumber='" + seqNumber + '\'' +
                ", id='" + id + '\'' +
                ", name='" + name + '\'' +
                '}';
    }
}

Lombok 활용 코드

@Getter
@Setter
@ToString
@NoArgsConstructor
@AllArgsConstructor
public class Car {

    private String seqNumber;
    private String id;
    private String name;

}

💡 Lombok에서 사용하는 어노테이션!!

Lombok의 어노테이션을 사용하기 위해서는 gradle의 dependencies에
implementation 'org.projectlombok:lombok' annotationProcessor 'org.projectlombok:lombok'
를 추가해줘야 한다.

• @Getter & @Setter
  • 실질적으로 가장 많이 활용되는 어노테이션이다.
  • @Getter : Getter 메소드 생성
  • @Setter : Setter 메소드 생성
  • 어노테이션을 클래스 위에 작성하면 해당 클래스의 모든 변수에 적용이 가능하고, 변수 이름 위에 작성하면 해당 변수에만 적용이 된다.

 @Getter
  public class Car {

          @Setter
          private String seqNumber;
      private String id;
      private String name;
      private String color;
      private Integer serialNumber;
      private boolean isOnSale;

  }

  /** 컴파일 완료 소스 **/

  public class Car {
      private String seqNumber;
      private String id;
      private String name;
      private String color;
      private Integer serialNumber;
      private boolean isOnSale;

      public Car() {
      }

      public String getSeqNumber() {
          return this.seqNumber;
      }

      public String getId() {
          return this.id;
      }

      public String getName() {
          return this.name;
      }

      public String getColor() {
          return this.color;
      }

      public Integer getSerialNumber() {
          return this.serialNumber;
      }

      public boolean isOnSale() {
          return this.isOnSale;
      }

      public void setSeqNumber(String seqNumber) {
          this.seqNumber = seqNumber;
      }
  }

/**

@Getter 어노테이션을 클래스 상단에 적용함으로써 모든 변수에 대한 Getter 메서드가 작성됨.
@Setter 어노테이션을 seqNumber 변수에만 적용했기 때문에 해당 변수의 Setter 메서드가 작성됨

**/

• @ToString
  • @ToString 어노테이션은 해당 클래스의 ToString 메서드를 생성해준다.
  • 출력을 원치 않는 변수 위에 @ToString.Exclude 어노테이션을 적용하면 출력을 제외한다.
  • 부모 클래스에 대해서도 toString을 적용하고자 한다면 @ToString(callSuper = true) 어노테이션을 적용하면 된다.

  @ToString
  public class Car {

      private String seqNumber;
      private String id;
      private String name;
      private String color;
      private Integer serialNumber;
          @ToString.Exclude
      private boolean isOnSale;

  }

  /** 컴파일 완료 소스 **/
  public class Car {

      private String seqNumber;
      private String id;
      private String name;
      private String color;
      private Integer serialNumber;
      private boolean isOnSale;

      @Override
      public String toString() {
          return "Car{" +
                  "seqNumber='" + seqNumber + '\'' +
                  ", id='" + id + '\'' +
                  ", name='" + name + '\'' +
                  ", color='" + color + '\'' +
                  ", serialNumber=" + serialNumber
                  '}';
      }
  }

• @Builder
  • 빌더 패턴을 자동으로 생성해준다.
  • builder() : 빌더 클래스의 인스턴스 생성
  • build() : 실제 생성자 호출하여 객체 생성
• @AllArgsConstructor & @NoArgsConstructor(access = AccessLevel.PROTECTED)
  • @AllArgsConstructor
    • 모든 필드 값을 파라미터로 받는 생성자 생성
  • @NoArgsConstructor
    •  파라미터가 없는 기본 생성자 생성
    • @Entity 적용 시 기본 생성자는 필수이기 때문에 롬복에서 제공하는 이 어노테이션을 사용한다.
    • @Builder와 @NoArgsConstructor를 함께 사용 시 모든 매개 변수를 받는 생성자가 없으면 에러가 발생한다.

@AllArgsConstructor
@NoArgsConstructor
public class Car {

    private String seqNumber;
    private String id;
    private String name;
    private String color;
    private Integer serialNumber;
    private boolean isOnSale;

}

/** 컴파일 완료 소스 **/

public class Car {

    private String seqNumber;
    private String id;
    private String name;
    private String color;
    private Integer serialNumber;
    private boolean isOnSale;

		public Car () {}

    public Car(String seqNumber, String id, String name, String color, Integer serialNumber, boolean isOnSale) {
        this.seqNumber = seqNumber;
        this.id = id;
        this.name = name;
        this.color = color;
        this.serialNumber = serialNumber;
        this.isOnSale = isOnSale;
    }
}

/**

@NoArgsConstructor 적용함으로써 기본 생성자가 작성됨
@AllArgsConstructor 적용함으로써 모든 변수에 대한 생성자가 작성됨

**/

• @RequiredArgsConstructor
  • 특정 변수에 대한 생성자를 생성해준다.
  • 주로 의존성 주입, 즉 DI 의 편의를 위해 사용되곤 한다.
  • 해당 어노테이션으로 생성될 생성자의 인자를 추가하는 조건은 아래와 같다.
  • 변수를 final로 선언
  • 변수에 @NonNull 어노테이션을 적용

@RequiredArgsConstructor
public class Car {

    private final String seqNumber;
    private final String id;
    private String name;
    private String color;
    @NonNull
    private Integer serialNumber;
    private boolean isOnSale;

}

/** 컴파일 완료 소스 **/

public class Car {
    private final String seqNumber;
    private final String id;
    private String name;
    private String color;
    @NonNull
    private Integer serialNumber;
    private boolean isOnSale;

    public Car(String seqNumber, String id, @NonNull Integer serialNumber) {
        if (serialNumber == null) {
            throw new NullPointerException("serialNumber is marked non-null but is null");
        } else {
            this.seqNumber = seqNumber;
            this.id = id;
            this.serialNumber = serialNumber;
        }
    }
}

/**

final로 선언하거나 @NonNull 어노테이션이 적용된 변수들만을 인자로 받는 생성자가 작성됨.

**/

• @NonNull
  • 생성자에서 변수에 대한 NPE(Null Pointer Exception)를 검증해준다.

@RequiredArgsConstructor
public class Car {

    private final String seqNumber;
    @NonNull
    private final String id;
    private String name;
    private String color;
    @NonNull
    private final Integer serialNumber;
    private boolean isOnSale;

}

/** 컴파일 완료 소스 **/

public class Car {
    private final String seqNumber;
    @NonNull
    private final String id;
    private String name;
    private String color;
    @NonNull
    private final Integer serialNumber;
    private boolean isOnSale;

    public Car(String seqNumber, @NonNull String id, @NonNull Integer serialNumber) {
        if (id == null) {
            throw new NullPointerException("id is marked non-null but is null");
        } else if (serialNumber == null) {
            throw new NullPointerException("serialNumber is marked non-null but is null");
        } else {
            this.seqNumber = seqNumber;
            this.id = id;
            this.serialNumber = serialNumber;
        }
    }
}

/**

생성자로 Object를 생성할 때, @NonNull이 적용된 변수에 대한 Null 체크를 진행한다.

**/

• @Date
  • @ToString, @EqualsAndHashCode, @Getter, @Setter, @RequiredArgsConstructor를 자동완성 시켜준다.
  • 실무에서는 너무 무겁고 객체의 안정성을 지키기 때문에 @Data의 활용을 지양한다.
• @Builder
  • @Builder 어노테이션은 해당 클래스의 생성자에 Builder 패턴을 적용시켜준다.
  • 모든 변수에 적용시키려면 클래스 상단에 @Builder 를 적용하고, 특정 변수에 대한 Build를 원한다면 생성자를 작성하고 해당 생성자 위에 @Builder 를 적용하면 된다.

public class Car {

    private String seqNumber;
    private String id;
    private String name;
    private String color;
    private Integer serialNumber;
    private boolean isOnSale;

    @Builder
    public Car(String seqNumber, String id, Integer serialNumber) {
        this.seqNumber = seqNumber;
        this.id = id;
        this.serialNumber = serialNumber;
    }
}

/** 사용 예제 **/

public class CarFactory {

    public Car initCar(String seqNumber, String id, Integer serialNumber) {
        Car car = Car.builder()
                .seqNumber(seqNumber)
                .id(id)
                .serialNumber(serialNumber)
                .build();

        return car;
    }

}

/**

@Builder 어노테이션을 통해 해당 Object에 대해 Builder 패턴이 적용된 것을 확인할 수 있다.
step-by-step으로 필요한 인자를 선택해서 add하여 한번에 객체를 생성할 수 있다.

**/

Builder Pattern

객체를 생성할 때, 흔히 사용되는 디자인 패턴 중 하나이다.

Car car = Car.builder()
         .seqNumber(seqNumber)
         .id(id)
         .serialNumber(serialNumber)
         .build();

장점

• 각 인자가 어떤 의미인지 파악하기 쉽다.
• setter 메서드가 없으므로 변경 불가 객체를 만들 수 있다.
• 한번에 객체를 생성함으로써 제공 상태에 대한 일관성을 얻는다.
• 객체 생성 최종 단계인 build() 내부에서 값을 검증한다던지의 추가적인 처리가 가능하다.

 

• @Log 관련 어노테이션
  • Lombok은 여러가지의 Log 어노테이션을 제공해준다.
  • 로그 어노테이션을 적용하면 해당 클래스에 대한 로그 클래스를 자동으로 생성한다.

@Log4j
public class Car {
    private String seqNumber;
    private String id;
    private String name;
    private String color;
    private Integer serialNumber;
    private boolean isOnSale;
}

/** 컴파일 완료 소스 **/
public class Car {
    private static final Logger log = Logger.getLogger(Car.class);
    private String seqNumber;
    private String id;
    private String name;
    private String color;
    private Integer serialNumber;
    private boolean isOnSale;
}

/**

적용시킨 Log 어노테이션에 맞는 Log 클래스를 자동으로 생성해준다.

**/

💡 Lombok Annotation 적용 에러

annotation Processor를 설정해줘야 한다!

1. Setting-> Build,Execution,Deployment -> Compiler -> Annotation Processors설정에서 Enable Anntation processing 체크박스 활성화
2. build.gradle 파일에서 dependencies**{**annotationProcessor('org.projectlombok:lombok:')} 추가