[Java 가지고 놀기] Java Builder 패턴

callme.waffle·2024년 9월 27일

Java 가지고놀기

목록 보기
15/18
post-thumbnail

1. 들어가는 글

Java Annotation을 정리하며 Builder패턴을 생성해주는 Annotation@Builder 에 대하여 알게 되었습니다.
Builder 패턴이 무엇인지 몰라 찾아본 내용들에 대해 정리하였습니다.

#Reference

catch-me-java 포스팅
cieroyou님의 글
sweet_sumin님의 글
tlatmsrud님의 글

2. Java에서 객체를 생성하는 방법

Java에서 Class의 명세에 맞춰 객체를 생성하기 위해서는 생성자 (constructor)가 필요합니다. (자바 빈즈패턴도 있지만, 여기에서는 객체를 '생성'하기 위한 방법론에 집중하기 위해 생략하겠습니다.)
생성자를 선언하는 방법에는 크게 2가지가 있습니다.

A. Constructor 직접 작성하기

아래 field를 가지는 class가 있다고 가정하겠습니다.

public class Test {
  private int a;
  private String b;
  
  // ...codes
}

만약 객체를 생성하기위해 a와 b를 모두 입력받아야 한다면,
다음과 같은 생성자를 만들 수 있을 겁니다:

public class Test {
  private int a;
  private String b;
  
  // constructor
  public Test( int a, String b ) {
  	this.a = a;
    this.b = b;
  }
}

하지만 이건 너무나도 번거롭습니다. 귀차니즘을 유발하죠.
개발자들의 귀차니즘은 언제나 해결책을 만들고, 이를 해결해주는 것이 lombok 입니다

B. Lombok Annotation 사용하기

이 글을 통해 이전에 Lombok을 사용한 생성자 자동추가를 공부한 적이 있습니다.
위 글의 내용을 따라 생각해본다면, 이렇게 작성하면 자동으로 생성자를 추가할 수 있을 것입니다.


@AllArgeConstructor
public class Test {
  private int a;
  private String b;
  
  // ...codes
}

한줄만으로 깔끔하게 생성자 추가가 가능하죠

C. 생성자의 문제점

하지만 이렇게 간단히 작성이 가능하다고 하더라도, 생성자 방식의 코드작성에는 다음과 같은 문제가 있습니다

선택 매개변수에 따라 길어지는 생성자코드

선택적으로 매개변수를 입력받을 수 있는 경우, 각 생성자의 입력유무에 따라 각기 다른 생성자를 만들어줘야 합니다.
가령 필드 n개만 선택적으로 매개변수를 입력할 수 있도록 하려면, 총 2^n개의 생성자가 추가됩니다. 입력순서까지 자유롭게 바꿀 수 있도록 하려면 더 많아져야 하죠.
다시말해, 개발공수가 커진다는 것이죠.

생성자 구현오류를 알아내는 것의 어려움

만약 생성자 내부에서 구현 상 문제가 발생했다고 가정하겠습니다.
이때 문제점을 알아내기 위해 개발자는 해당 클래스의 내부로 들어가 실행된 생성자를 직접 확인해봐야 합니다. (super를 사용해 중복된 설정부를 최소화한 개발상태 등...)
다시말해, 디버깅 공수가 커진다는 것이죠.


위와 같은 이런 문제점들을 해결하기 위해 고안된 방법이 바로 빌더패턴 (Builder 패턴)입니다.
빌더패턴에 대해 자세한 내용은 아래에 기술하겠습니다.

3. Builder 패턴

A. Builder 패턴이란?

Builder 패턴은 Constructor의 단점을 보완하기 위해 메소드 체이닝 방식을 활용해 객체를 생성할 수 있도록 구현한 방법론을 의미합니다.

B. Builder 패턴 선언방법

빌더패턴은 객체의 내부에 static class로 Builder를 구현하고, 해당 구현체 내부에 return this;를 통한 메소드 체이닝 방식을 사용해 생성자를 연속적으로 호출할 수 있도록 한 패턴입니다.

패턴이 적용된 구현체는 다음과 같습니다:

public class Test {
  private int a;
  private String b;
  
  // constructor: based on builder
  public Test(Builder builder) {
    this.a = builder.a;
    this.b = builder.b;
  }
  
  public static class Builder {
  	private int a = 0;
    private String b = "";
    
    public Builder a(int a) { this.a = a; return this; }
    public Builder b(int b) { this.b = b; return this; }
    
    public Test build() {
      return new Test(this);
    }
  }
}

코드가 좀 길어지긴 합니다. 번거롭죠
참 다행이도 lombok에서 자동으로 생성하는 Annotation을 지원합니다

@Builder // 적용 완
public class Test {
  private int a;
  private String b;
  
  // ...codes

... 참 간편하죠?

C. Builder 패턴의 장단점

이런 Builder 패턴에도 각각의 장단점은 존재합니다.
큰 장단점들을 찾아보았으며, 함께 정리하였습니다:

장점

  • 객체의 일관성이 훼손되지 않음
  • 객체의 불변성을 보장함
  • 선택필드가 많아도 개발공수가 크게 늘지 않음
  • 객체생성 시 필드에 대한 검증로직을 추가할 수 있음

객체의 일관성 (Consistency)

: 객체의 상태가 프로그램 실행 중 항상 유효한 상태를 '일관되게' 유지해야 함을 의미합니다. 쉽게말해, 객체가 생성된 이후 내부의 값이 변경되면 안된다는 것을 의미합니다.

단점

  • 내부 Builder 객체로 인한 오버헤드 발생

4. 마치며

객체를 생성하는 방법이 이렇게 다양한지 새롭게 알게 되었습니다.
또한 Builder 패턴을 통해 단순히 객체의 일관성과 불변성을 보장할 뿐 아니라 개발공수까지 조정 가능하다는 점에서 큰 메리트가 있음을 느꼈습니다.
상황에 따라 적절히 Builder 패턴을 사용하는 연습을 해야겠습니다.

profile
Developer waffle = new Waffle();

0개의 댓글