Files
korea-research/docs/DOC-000-CHANGELOG-VER2.md
2025-05-27 16:34:20 +09:00

3.3 KiB

Recycle 2 버전의 가장 큰 변화

model mapper 에서 생성자 패턴으로의 전환

"자바를 보다 더 컴파일 언어스럽게"

컴파일 언어의 가장 큰 장점은 compile 시점에 발생할 수 있는 모든 오류를 작성자에게 알려주어 runtime 시 사용자가 마주하게 되는 버그를 최소화 시켜 준다는 점입니다. 엔티티 속성이 변경되거나 추가될 때 이를 사용하는 모든 곳에서 컴파일 에러가 발생한다면 코드 수정자의 입장에서 가장 이상적인 환경이됩니다.

model mapper 는 이러한 변경의 파급효과를 runtime 시점으로 미뤄버리기에 수정 및 리펙토링 환경에서 매우 해로운 기술입니다. JPA 관점에서도 연관 엔티티간의 조회 및 참조에서 원치않은 동작을 유발시키며 이를 제어하기는 무척 까다롭습니다.

새로운 프레임워크 버전 부터 model mapper 가 제거되었고, 생성자 패턴을 이용해 엔티티 및 인자, 결과 객체를 교환합니다. 생성자 패턴 적용예는 예제 게시판에서 확인 가능합니다.

JPA Metamodel 도입

JPA 를 이용할 때 엔터티 클래스의 속성을 문자열로 참조해야 하는 경우가 발생합니다 (예: mappedBy="속성명"). 프로젝트 진행 과정에서 해당 속성이 변경(혹은 삭제)되는 경우, 컴파일러는 이를 인지하지 못합니다. 즉, type safe 하지 않습니다.

이름이 사용되는 곳을 찾아 수작업으로 변경해주어야 하며, 이를 놓친 경우 runtime 과정에서 예상치 못한 에러를 만나게 됩니다.

JPA 메타모델은 이러한 단점을 피하고 관리되는 엔터티 클래스의 메타데이터에 대한 정적 액세스를 제공하기 위해 도입되었습니다.

hibernate-jpamodelgen maven 모듈을 통해 target/generated-sources/annotations 로 정적 JPA Metamodel 클래스들이 생성됩니다.

$ tree core/target/generated-sources/annotations/
core/target/generated-sources/annotations/
`-- app
    `-- module
        `-- core
            `-- config
                `-- adapter
                    `-- persistence
                        `-- entity
                            |-- ExBoardAttachment_.java
                            |-- ExBoard_.java
                            |-- FrontUser_.java
                            |-- LoggedInUserEmbeddable_.java
                            ...

JPA 사양에 따라 생성된 클래스는 해당 엔티티 클래스와 동일한 패키지에 상주하며 끝에 "_"(언더스코어)가 추가된 동일한 이름을 갖습니다.

이제 Metamodel 클래스를 이용해 type safe 프로그래밍을 해봅시다.

// Metamodel 적용 전
@OneToMany(mappedBy = "exBoard", ...})
private Set<ExBoardAttachment> attachments;

// Metamodel 적용 후
@OneToMany(mappedBy = ExBoardAttachment_.EX_BOARD, ...})
private Set<ExBoardAttachment> attachments;

정적 Metamodel 클래스는 maven compile 단계에서 생성되며 IDE 에서 어플리케이션 구동 시 빌드과정에서 자동으로 수행됩니다.

생성된 모델을 참조하기 위해서는 target/generated-sources 경로가 IDE 의 classpath 에 추가되어야 합니다.

인텔리제이의 경우, File > Project Structure > Modules > target\generated-sources 우클릭 후 Sources 체크 해주면 됩니다.