Lombok

• http://projectlombok.org/
• getter/setter/equals/hashCode 등을 어노테이션기반으로 자동으로 만들어준다.
• Lombok 사용상 주의점(Pitfall)
• Lombok Field 지정이 올바른지 검사
• Lombok Upgrade
• Project Lombok: Creating Custom Transformations - 자신만의 Lombok 모듈 만들기
• Implementing a Custom Lombok Annotation | Baeldung
• Lombok, AutoValue, and Immutables

• lombok setup gradle
• io.freefair.lombok gradle-lombok plugin
• 혹은 다음과 같이 직접 설정

  compileOnly 'org.projectlombok:lombok:1.18.12'
  annotationProcessor 'org.projectlombok:lombok:1.18.12'
  
  testCompileOnly 'org.projectlombok:lombok:1.18.12'
  testAnnotationProcessor 'org.projectlombok:lombok:1.18.12'

• Project Lombok - Trick Explained
• -J-Xmx1024m

• AccessLevel.NONE 설정으로 특정 필드 등에 대한 자동 메소드 생성을 막을 수 있다.

  // 모든 필드에 대해 Getter/Setter를 생성하지만 age 필드의 Setter는 생성하지 않는다.
  @Data
  public class Person {
      @Setter(AccessLevel.NONE)
      private int age;
  }

• http://projectlombok.org/mavenrepo/index.html 있는 대로 설정하면 된다.
• 만약 JPA Annotation Processor 때문에 maven-compiler-plugin 의 compilerArgument에 -proc:none을 지정했다면 삭제하라.

• 상호 참조하는 객체의 경우 toString() 호출시 Stack Overflow 가 발생할 수 있다. 한쪽 객체에서 다른 쪽 객체에 대해 @ToString(excluded={“propertyName”}) 형태로 출력시 제외토록 만들어야 한다.
• @EqualsAndHashCode(of = {})로 꼭 필요한 필드만 비교하도록 처리한다.

• Lombok으로 Getter/Setter를 만들면 PMD에서 Unused private field로 표시가 된다.

  @Data
  @SuppressWarnings("PMD.UnusedPrivateField")
  public class LombokUseClass {
  }

• Signualr Field로 표시될 때는

  @Data
  @SuppressWarnings("PMD.SingularField")
  public class LombokUsedClass {
      private String field;
  }

• HideUtilityClassConstructor

  @SuppressWarnings("checkstyle:HideUtilityClassConstructor")

• Equals Verifier
• 다른 클래스를 상속할 때, 부모 클래스의 equals&hashCode를 그대로 사용하고자 하는 상황에서 Java FindBugs의 경고를 회피하려면 자식 클래스 쪽에 다음과 같이 설정한다.

  @EqualsAndHashCode(callSuper = true, of = {})

  • 여기서 of = { }를 넣지 않으면, 자식 클래스의 모든 필드가 비교 대상으로 들어가 버리게 된다.

• Lombok PG Custom handler 모음
• Project Lombok: Creating Custom Transformations 프로젝트 구성에 대해 잘 설명함
• java - Create custom annotation for Lombok
• binkley's BLOG: Writing your own lombok annotation

• Lombok Builder with Default Value | Baeldung Builder 생성시 기본값 지정하는 방법
• Lombok Builder with Custom Setter | Baeldung

• 1.4 이하 Ant 태스크 : lombok.delombok.ant.DelombokTask
• 1.6 이상 Ant 태스크 : lombok.delombok.ant.Tasks$Delombok

• Using Lombok's @Getter for Boolean Fields | Baeldung
• boolean isRunning → isRunning(), setRunning()
• boolean running → 위와 동일하게 isRunning(), setRunning()
• 따라서 boolean isRunning과 boolean running 이 둘 다 존재하면 컴파일 에러 발생.
• Boolean running → getRunning(), setRunning()

• lombok changelog

• 이 시점 이후부터 @AllArgsConstructor, @RequiredArgsConstructor 등에서 자동으로 생성해주던 @ConstructorProperties(필드정보) 가 자동으로 생성이 안되게 바뀐다.
• @ConstructorProperties
• 기본 생성자가 없을 경우, Java Jackson JSON Library 등이 어떻게 필드에 값을 주입할 지 알 수 없는 상황이 된다.
• lombok.config에서 lombok.anyConstructor.addConstructorProperties=true를 명시적으로 주면 자동 생성된다. 하지만 @XXXArgsConstructor, @Data, @Value를 모두 없애고 생성자를 직접 만들어주고, 기본 생성자를 추가해주는 게 낫다.

BREAKING CHANGE: lombok config key lombok.anyConstructor.suppressConstructorProperties is now deprecated and defaults to true, that is, by default lombok no longer automatically generates @ConstructorProperties annotations. New config key lombok.anyConstructor.addConstructorProperties now exists; set it to true if you want the old behavior. Oracle more or less broke this annotation with the release of JDK9, necessitating this breaking change.

• 1.18.4 이상 버전은 field 에 지정한 @JsonProperty 를 비롯한 여러 annotation이 getter/setter 로 복제가 된다.
• 문제는 기존에 복제를 안해주는 버전으로 응답을 내려줄때, @JsonProperty값과 getter 의 이름이 다를 경우 두개가 다 외부 응답으로 나갔었는데, getter 의 이름으로 나가던 필드를 사용하는 타 팀이 존재할 경우 값자기 getter 이름쪽 응답이 사라져버린다.

BREAKING CHANGE: Lombok will now always copy specific annotations around (from field to getter, from field to builder 'setter', etcetera): A specific curated list of known annotations where that is the right thing to do (generally, @NonNull style annotations from various libraries), as well as any annotations you explicitly list in the lombok.copyableAnnotations config key in your lombok.config file. Also, lombok is more consistent about copying these annotations. (Previous behaviour: Lombok used to copy any annotation whose simple name was NonNull, Nullable, or CheckForNull). Issue #1570 and Issue #1634

@JsonProperty("isXxx")
private int isXxx;
 
-> 진짜 생성은
 
@JsonProperty("isXxx")
private int isXxx;
 
public void setXxx(int xxx) {
    this.isXxx = xxx;
}
 
-> 이로 인해서 JSON 에 ''isXxx'', ''xxx'' 두개의 필드가 존재하게 됨.

@JsonProperty("isXxx")
private int isXxx;
 
-> 진짜 생성은
 
@JsonProperty("isXxx")
private int isXxx;
 
// 아래 setter 에도 @JsonProperty 가 붙어버림
@JsonProperty("isXxx")
public void setXxx(int isXxx) {
    this.isXxx = isXxx;
}

• 해결책은 getter/setter 자동생성을 막고, 명시적으로 getter/setter 를 생성하고 그 위에 @JsonProperty('isXxx') 명시해서 추가해줌.
• 여기서 진짜 문제는 Jackson 이 isXxx 필드와 isXxx() 를 서로 다른 프라퍼티로 인식하는 것이다.
• Java Bean/Jackson 은 규약상 isXxx 필드의 getter/setter 는 isIsXxx(), setIsXxx() 여야하는게 맞기 때문에, isXxx() 를 isXxx 필드와 다른 프라퍼티로 인식하는 것이다.
• 그런데 많은 사람들이 필드 이름을 지을 때 is로시작 하지만 프라퍼티 이름은 is를 빼고 만들고 싶어하는 경향이 있는데, 그게 Lombok 에 반영돼있어서 발생한 문제이다.
• 따라서 이 문제는 is로 시작하는 boolean 필드 에서만 발생한다.