[Java 가지고 놀기] Java Records

callme.waffle·2024년 10월 3일

Java 가지고놀기

목록 보기
17/18

1. 들어가는 글

인턴으로 재직했던 회사에 놀러갔는데, 거기에서 Entity 구현을 record라는 신기한 타입으로 한 코드를 보았습니다.
너무 신기해서 관련 내용을 찾아보았고, 그 내용을 기억하고자 글로 정리했습니다.

#Reference

pp8817님의 글
colevelup님의 글

2. Records 소개

A. 공식문서 염탐하기

Java Records는 쉽고, 깔끔하며, 적은코드로 불변함을 간결히 표현할 수 있고, 잘 동작하는 명시적인 데이터 집합을 만들고자 합니다 (보일러플레이트만 없애자고 이런건 아님 ㅎㅎ) [Oracle]

Java14부터 추가되어 테스트되다가 Java16부터 정식출시된 class로, java.lang에 포함된 객체입니다.
앞서 캡처된 영역에서 설명하는 것처럼, Oracle에서 Records class를 추가한 목적은 불변객체를 깔끔하게 생성할 수 있는 방법을 제공하기 위함입니다.

B. 불변객체를 생성하는 방법 (~Java 13)

불변객체를 생성하기 위해, Java에서는 class 생성 시 다음과 같은 과정들이 필요했습니다.

1) 불변성 설정

우선 내부의 값이 변하지 않도록 하기 위한 설정들을 추가합니다.

  • 필드명에 final 키워드 추가 -> 생성자에서 초기화 이후 값 변경 불가
  • setter 메서드 생성금지 -> 불변성 훼손 방지

2) 활용에 필요한 기본적인 메서드 추가

2개의 객체가 같은지 비교하거나 (=equals()), 문자열로 변환해주는 메서드들은 (=toString()) 아무래도 개발에 반드시 필요할 겁니다.
따라서 일반적으로 사용되는 equals(), hasCode(), toString()와 같은 메서드들을 class에 맞게 Override 합니다. 굉장히 귀찮은 과정이죠.

위와 같이 모든 코드를 작성하기 위해 반드시 필요한 기반코드들을 boilerplate code라고 합니다. (박아놓고 똑같이 사용하기 위해 사용하기 위해 만들어진 철판 모형에서 유래된 단어라고 하네요)

C. 위 방식의 문제점

윗내용 작성 중 살짝 언급했지만, 아무래도 귀찮습니다. (ㅋㅋ..)
조금 다듬어 말하자면, 코드가 길어지고 목적이 모호해집니다.

이 글에서 든 예시를 참고하자면, 단순히 2개의 필드를 가지는 객체임에도 불구하고 관련 키워드를 추가하고 메서드들이 늘어나다보니 코드가 장황해졌습니다.

따라서 코드 전체에 대한 이해가 어려워지고, 2개의 값을 변하지 않게 담고자했던 본래의 목적을 잊게 됩니다.
나중에 필드를 추가하게 된다면 연관된 메서드들도 함께 수정해야하는 문제도 함께 따라오죠.

이런 문제점을 해결하기 위해 도입된 방법이 바로 Records class 입니다.

3. Records 사용법

만약 'name'과 'age'를 field로 가지는 immutable 객체 Person이 있다고 하겠습니다.
이때, class로 작성하면 다음과 같이 작성해야 합니다.

public class Person {
	private final String name;
    private final int age;
    
    // constructor
    public Person( String name, int age ) {
    	this.name = name;
        this.age = age;
    }
    
    // getter
    public String getName() { return this.name; }
    
    public int getAge() { return this.age; }
    
    @Override
    public boolean equals( Person c ) {
    	return (
        	c.getName() == getName() &&
        	c.getAge() == getAge()
        );
    }
    
    @Override
    public String hashCode() { ... }
    
    @Override
    public String toString() { ... }
    
    // ...
}

...네, 깁니다.

기본 사용법

Records를 사용한다면, 위 코드는 이렇게 바뀝니다:

public record Person(String name, int age) {}

훨씬 간단해지는 것을 알 수 있습니다.
저 1줄 안에 필드선언, 생성자 추가, 각종 보일러플레이트 코드 등을 자동으로 추가하는 명령이 모두 들어가있습니다.

생성자 확장: 컴팩트 생성자 (Compact Constructor)

만약 저기에서 age가 20 이상인 경우에만 객체를 생성해야 한다면 어떨까요?
아마 생성자단에서 점검이 필요할겁니다.
이렇듯 값 검증 등의 작업을 수행하고자 하는 목적으로 생성자실행 전 실행가능한 코드를 작성할 수 있는 문법을 record는 지원하며, 이를 Compact Constructor라고 합니다.

위 조건을 Compact Constructor를 사용해 구현한다면 다음과 같은 코드가 작성 가능할 겁니다:

public record Person(String name, int age) {
	public Person {
    	if ( age < 20 ) throw new IllegalArgumentException();
    }
}

위 코드가 실행되면,

  1. 생성자가 실행되기전 우리가 선언한 컴팩트 생성자의 코드가 실행되고,
  2. 이후 record 내부에서 자동으로 추가되는 생성자가 실행됩니다.

이를 통해 알 수 있는 record의 Compact Constructor는:

  • 인자를 받을 수 없는 생성자
  • super 키워드 없이도 record가 자동으로 추가하는 생성자를 추가

한다는 특징이 있습니다.

4. 실제활용

record의 특징, 즉 생성자로 생성된 후 값이 불변해야 하는 곳이라면 어디든 사용할 수 있습니다. Spring에서 사용한다면 DTO를 사용할 때 만들 수 있다고 볼 수 있죠.

Entity를 만들 때 사용하면 안되는 이유

  1. Entity는 JPA에 의해 Proxy 객체로 확장되는데, Proxy 객체는 초기화 시 Reflection API를 사용합니다. Reflection API는 Java 구현 상의 이유로 반드시 기본생성자를 사용하여 객체를 생성한 후 setter로 field를 초기화하여 setter 메서드가 필요하므로, Entity 자체에 final 키워드를 사용할 수 없습니다
  2. record로 만들어지는 class는 getter의 명명규칙에 따라 메서드가 생성되지 않습니다 (ex: name 필드 getter: name())

DTO는 불변이어도 되는이유

: DTO는 Entity처럼 DB와 매핑되기 위해 Proxy가 적용되는 대상이 아닙니다. 로직 내부에서 개발자가 생성자를 통해 직접 생성하므로, 오히려 DTO는 개발과 유지보수를 위해 불변이어야합니다.

5. 마무리

record에 대해 찾아보며 Java 8에만 갇혀있던 제 시야를 조금 더 넓힐 수 있었던 것 같습니다.
조금씩 더 공부해서 버전별 Java의 특징들 또한 한번 정리해야할 것 같습니다.

profile
Developer waffle = new Waffle();

0개의 댓글