JPA 3.0

JPA 3.0의 가장 두드러진 변화는 모든 API 클래스의 패키지명 접두사가 javax.persistence에서 jakarta.persistence로 변경된 것이다. 이 변경은 자바 EE에서 자카르타 EE로의 전환 과정의 완성을 의미하며, 기술적 기능 추가보다는 법적 문제를 피하기 위한 네임스페이스 이전에 초점을 맞춘다. 결과적으로, 개발자는 @Entity, @Id와 같은 애너테이션을 사용하거나 EntityManager를 임포트할 때 새로운 패키지명을 사용해야 한다.

이 패키지명 변경은 XML 기반 설정 파일에도 적용된다. persistence.xml 파일과 orm.xml 파일의 네임스페이스 및 스키마 정의가 갱신되어야 한다. 예를 들어, persistence.xml의 네임스페이스는 https://jakarta.ee/xml/ns/persistence로, orm.xml의 네임스페이스는 https://jakarta.ee/xml/ns/persistence/orm으로 변경된다. 또한, 설정 파일 내에서 javax.persistence.jdbc.driver와 같은 구성 속성 이름도 동일하게 jakarta.persistence 접두사로 바꿔야 한다.

주요 JPA 구현체인 하이버네이트와 이클립스링크는 이 변경을 지원한다. 하이버네이트는 JPA 3.0 API를 지원하는 아티팩트명에 -jakarta 접미사를 추가했으며, 이클립스링크는 3.0 버전부터 지원을 시작했다. 마이그레이션은 대부분의 경우 기존 import javax.persistence 문을 import jakarta.persistence로 일괄 치환하는 방식으로 수행할 수 있으며, 기능적 변경은 없어 코드의 동작에는 영향을 미치지 않는다.

Jakarta Persistence 3.0은 자바 플랫폼의 변화와 함께 새로운 버전 요구사항을 명시한다. 이 버전은 자바 EE에서 Jakarta EE로의 완전한 전환을 반영하여, 공식적으로 자바 11 이상의 런타임 환경을 필요로 한다. 이는 이전 버전인 JPA 2.2가 자바 8을 지원했던 것과 비교되는 중요한 변화이다. 이러한 요구사항 상향은 모던 자바의 기능을 적극적으로 수용하고, 장기적인 지원(LTS) 버전을 기반으로 한 안정적인 생태계를 구축하기 위한 목적이 있다.

구체적으로 Jakarta Persistence 3.0은 Jakarta EE 9 플랫폼의 일부로 출시되었으며, 이 플랫폼의 최소 요구사항을 따른다. 따라서 애플리케이션을 JPA 3.0으로 마이그레이션하거나 새로 개발할 때는 빌드 도구의 설정 파일(예: Maven의 pom.xml 또는 Gradle의 build.gradle)에서 자바 버전을 11 이상으로 명시해야 한다. 또한, Jakarta EE 9 이상의 호환되는 애플리케이션 서버(예: WildFly, Payara Server, Open Liberty) 또는 스프링 부트와 같은 임베디드 컨테이너 환경에서 실행되어야 정식 스펙을 완전히 보장받을 수 있다. 이 변경은 단순히 패키지명 변경을 넘어서 보다 현대적인 자바 기반 위에서 ORM 표준이 진화할 수 있는 토대를 마련한다.

JPA 3.0은 기능적인 확장보다는 네임스페이스 이전을 완료하는 데 주안점을 둔 버전이다. 이전 버전인 JPA 2.2와 비교하여 새로운 API나 핵심 기능이 추가되지는 않았다. 주요 변경 사항은 모든 API 클래스의 패키지명 접두사가 javax.persistence에서 jakarta.persistence로 변경된 것이다. 이는 자바 EE에서 Jakarta EE로의 전환 과정을 완성하기 위한 법적 조치의 일환으로 이루어졌다.

구성 파일의 XML 네임스페이스와 스키마 위치도 업데이트되었다. persistence.xml 파일의 네임스페이스는 http://xmlns.jcp.org/xml/ns/persistence에서 https://jakarta.ee/xml/ns/persistence로 변경되었으며, orm.xml 파일의 네임스페이스도 https://jakarta.ee/xml/ns/persistence/orm으로 바뀌었다. 또한 구성 속성명에서 javax.persistence 접두사가 jakarta.persistence로 대체되어야 한다.

주요 ORM 구현체인 Hibernate와 EclipseLink는 JPA 3.0을 지원한다. Hibernate는 5.5 버전부터 hibernate-core-jakarta 아티팩트를 통해 지원을 시작했으며, EclipseLink는 3.0 버전부터 공식 지원한다. 이 변경으로 인해 기존 애플리케이션을 마이그레이션할 때는 의존성 업데이트, 코드 내 임포트 문 및 구성 파일 수정이 필요하지만, 기능적 차이는 없어 상대적으로 간단한 과정이다.

JPA 3.0은 이전 버전인 JPA 2.x와의 하위 호환성을 유지하면서도, 자카르타 EE로의 완전한 전환을 위해 필수적인 패키지명 변경을 포함한다. 이는 기능적 변화보다는 네임스페이스 이전에 초점을 맞춘 릴리스이다. 따라서 기존 JPA 2.2 애플리케이션의 코드 로직 자체는 변경할 필요가 없지만, 패키지 임포트와 설정 파일의 네임스페이스를 일괄적으로 업데이트해야 한다.

마이그레이션의 핵심은 모든 javax.persistence 참조를 jakarta.persistence로 변경하는 것이다. 이는 엔티티 클래스의 애너테이션 임포트, 영속성 유닛 설정 파일(persistence.xml), 그리고 ORM 매핑 파일(orm.xml)에 적용된다. 예를 들어, @Entity 애너테이션의 임포트는 javax.persistence.Entity에서 jakarta.persistence.Entity로 바뀐다. 설정 파일에서는 XML 네임스페이스와 스키마 위치가 http://xmlns.jcp.org/xml/ns/persistence에서 https://jakarta.ee/xml/ns/persistence로 변경되어야 한다.

주요 JPA 구현체인 하이버네이트와 이클립스링크는 모두 JPA 3.0을 지원한다. 하이버네이트 5.5 이상 버전은 hibernate-core-jakarta 아티팩트를 통해 지원하며, 이클립스링크는 3.0 버전부터 지원한다. 마이그레이션 후에는 의존성을 이러한 호환 버전으로 업데이트하고, 애플리케이션의 모든 JPA 관련 코드와 설정이 새로운 jakarta 네임스페이스를 참조하도록 전환해야 한다. 이 과정은 대부분 IDE의 검색 및 치환 기능을 통해 비교적 쉽게 수행할 수 있다.

JPA 3.0으로 마이그레이션할 때 가장 먼저 수행해야 할 작업은 프로젝트의 의존성과 설정 파일을 업데이트하는 것이다. 이 과정은 주로 Maven 또는 Gradle 같은 빌드 도구의 설정 파일(pom.xml 또는 build.gradle)과 JPA 설정 파일(persistence.xml, orm.xml)을 수정하는 것을 포함한다.

의존성을 업데이트하려면 먼저 JPA 3.0 API와 이를 지원하는 구현체의 올바른 버전을 지정해야 한다. JPA 3.0의 표준 API는 jakarta.persistence:jakarta.persistence-api 아티팩트를 통해 제공된다. 가장 널리 사용되는 구현체인 Hibernate를 사용한다면, JPA 3.0 네임스페이스를 지원하는 hibernate-core-jakarta 아티팩트를 사용해야 한다. 반면, EclipseLink 구현체는 버전 3.0.0부터 JPA 3.0을 완전히 지원한다. 다음은 Maven을 사용할 때의 예시이다.

설정 파일의 업데이트는 두 가지 주요 측면에서 이루어진다. 첫째, 모든 XML 설정 파일(persistence.xml, orm.xml)의 네임스페이스와 스키마 위치를 javax.persistence에서 jakarta.persistence로 변경해야 한다. 예를 들어, persistence.xml의 루트 요소는 https://jakarta.ee/xml/ns/persistence 네임스페이스를 사용해야 한다. 둘째, 설정 파일 내에서 JPA 속성명을 변경해야 한다. javax.persistence.jdbc.driver와 같은 모든 속성명의 접두사를 javax.persistence에서 jakarta.persistence로 바꿔야 한다. 이 변경사항은 데이터베이스 연결 정보나 스키마 생성 정책 등을 정의할 때 적용된다.

코드 변환 작업은 JPA 2.x에서 Jakarta Persistence 3.0으로의 마이그레이션 과정에서 가장 핵심적인 단계이다. 주된 변경 사항은 모든 API 클래스의 패키지명 접두사가 javax.persistence에서 jakarta.persistence로 변경된 것이다. 이는 Java EE에서 Jakarta EE로의 전환을 완료하기 위한 법적 조치의 일환으로, 기능적인 추가나 변경은 없다. 따라서 기존 애플리케이션의 마이그레이션은 대부분 IDE의 검색 및 바꾸기 기능이나 명령줄 도구를 이용한 패키지명 일괄 변경으로 처리할 수 있다. 모든 엔티티 클래스, DAO, 서비스 계층에서 import javax.persistence.*; 구문을 import jakarta.persistence.*;로 변경해야 한다.

XML 기반 설정 파일의 네임스페이스와 스키마 위치도 업데이트해야 한다. persistence.xml 파일에서는 http://xmlns.jcp.org/xml/ns/persistence 네임스페이스를 https://jakarta.ee/xml/ns/persistence로 변경하고, 해당 스키마 위치(xsi:schemaLocation)도 버전 3.0용으로 수정한다. 마찬가지로 orm.xml 파일에서 객체-관계 매핑 정의에 사용된 http://xmlns.jcp.org/xml/ns/persistence/orm 네임스페이스도 https://jakarta.ee/xml/ns/persistence/orm으로 바꿔야 한다. 설정 파일 내에서 사용하는 JPA 관련 구성 속성의 이름도 javax.persistence로 시작하는 것을 jakarta.persistence로 시작하도록 변경해야 호환성을 유지할 수 있다.

하위 호환성을 유지하면서 점진적으로 마이그레이션하기 위한 전략도 존재한다. 일부 구현체는 과도기적인 지원을 제공하는데, 예를 들어 Hibernate는 hibernate-core (JPA 2.x)와 hibernate-core-jakarta (JPA 3.0) 아티팩트를 별도로 제공한다. 이를 통해 의존성만 조정하여 새 패키지를 사용할 수 있다. 또한, Spring Framework나 Spring Boot와 같은 상위 프레임워크를 사용하는 경우, 해당 프레임워크의 Jakarta EE 9+ 지원 버전으로 업그레이드하면 대부분의 변환 작업을 자동으로 또는 가이드에 따라 처리할 수 있다. 마이그레이션 후에는 애플리케이션의 모든 CRUD 연산, 쿼리, 트랜잭션 관리 기능을 철저히 테스트하여 정상 작동을 검증하는 것이 중요하다.

마이그레이션 후 테스트 및 검증 단계는 JPA 3.0으로의 전환이 성공적이고 기존 기능이 정상적으로 작동하는지 확인하는 중요한 과정이다. 이 단계에서는 단순한 컴파일 오류 해결을 넘어 데이터 접근 계층의 모든 측면을 철저히 점검해야 한다.

주요 검증 항목은 다음과 같다. 첫째, 모든 엔티티 매핑과 JPQL 쿼리가 새로운 jakarta.persistence 네임스페이스 하에서 정상 동작하는지 확인해야 한다. 특히 복합 키를 사용하는 엔티티나 상속 매핑 전략을 적용한 부분은 주의 깊게 테스트한다. 둘째, 트랜잭션 관리와 영속성 컨텍스트의 동작이 변경 없이 유지되는지 검증한다. EntityManager의 persist, merge, remove 메서드 호출과 지연 로딩 동작을 확인하는 것이 좋다. 셋째, persistence.xml 또는 Spring Boot의 application.properties/application.yml을 통해 설정한 모든 JPA 속성(예: jakarta.persistence.jdbc.url, jakarta.persistence.schema-generation.database.action)이 올바르게 적용되는지 점검한다.

효율적인 테스트를 위해 통합 테스트와 단위 테스트를 병행하는 것이 권장된다. Spring Data JPA를 사용한다면, @DataJpaTest 어노테이션을 활용한 리포지토리 계층 테스트가 유용하다. 이는 내장 데이터베이스를 사용해 실제 데이터 접근 로직을 검증하면서도 테스트 속도를 높인다. 또한, 기존에 작성된 테스트 케이스 전체를 재실행하여 회귀 오류가 발생하지 않았는지 확인하는 것이 필수적이다. 마이그레이션 과정에서 Hibernate나 EclipseLink 같은 구현체의 버전도 함께 업그레이드된 경우, 해당 구현체의 릴리스 노트를 참고하여 변경된 동작이나 deprecated된 API에 대한 영향을 추가로 검토해야 한다.

Hibernate는 자카르타 퍼시스턴스 API 3.0의 가장 널리 사용되는 구현체 중 하나이다. Hibernate 5.5 버전부터 JPA 3.0을 공식 지원하기 시작했으며, 이전 버전의 JPA API와의 구분을 위해 관련 아티팩트 이름에 "-jakarta" 접미사를 추가했다. 예를 들어, JPA 3.0을 지원하는 Hibernate 코어 모듈은 hibernate-core-jakarta이다. 이는 기존 javax.persistence 패키지를 사용하는 애플리케이션과의 호환성을 유지하면서 새로운 jakarta.persistence 패키지로의 전환을 용이하게 한다.

Hibernate 6 버전은 JPA 3.1을 기본으로 지원하며, 자카르타 EE 9 이상의 네임스페이스 변경 사항을 완전히 수용한다. Hibernate를 JPA 3.0 구현체로 사용하려면 프로젝트 의존성에 해당하는 Hibernate 모듈을 명시해야 한다. 메이븐을 사용하는 경우, pom.xml 파일에 org.hibernate 그룹 ID와 hibernate-core-jakarta 아티팩트 ID를 지정하여 의존성을 추가한다. 이 설정은 스프링 부트와 같은 상위 프레임워크를 사용할 때는 자동으로 처리되는 경우가 많다.

Hibernate는 JPA 3.0 사양의 핵심 변경 사항인 패키지명 마이그레이션을 완벽하게 지원한다. 개발자는 엔티티 클래스의 임포트 구문을 javax.persistence에서 jakarta.persistence로 일괄 변경해야 하며, persistence.xml 및 orm.xml 설정 파일의 XML 네임스페이스와 스키마 위치도 업데이트해야 한다. 또한, 설정 속성명에서 javax.persistence 접두어를 jakarta.persistence로 변경하는 작업이 필요하다. Hibernate는 이러한 변경 이후에도 기존의 모든 매핑 기능과 고유의 확장 기능을 그대로 제공한다.

EclipseLink는 Eclipse Foundation이 개발 및 유지 관리하는 Jakarta Persistence 3.0의 공식 참조 구현체이다. 이는 JPA 2.x의 참조 구현체였던 역사를 이어받아, Jakarta EE 9 이상의 새로운 네임스페이스 체계를 완전히 지원하는 최초의 구현체 중 하나로 자리 잡았다. EclipseLink 3.0.0 버전은 Jakarta Persistence 3.0 사양을 공식적으로 준수하며, Hibernate와 함께 가장 널리 사용되는 ORM 구현체로 평가받는다.

EclipseLink의 주요 특징은 JPA 표준을 충실히 구현하면서도, JAXB를 통한 XML 바인딩, SDO 지원, 데이터베이스 웹 서비스와 같은 JPA 범위를 넘어서는 풍부한 데이터 지속성 기능을 제공한다는 점이다. 또한, EclipseLink는 Spring Framework 및 Spring Data JPA와의 통합을 공식적으로 지원하여, 현대적인 자바 애플리케이션 개발 환경에서 폭넓게 활용될 수 있다.

마이그레이션 관점에서, EclipseLink는 사용자가 javax.persistence에서 jakarta.persistence로의 패키지명 변경을 수용하도록 요구한다. 이는 엔티티 클래스의 임포트문, persistence.xml 및 orm.xml 설정 파일의 네임스페이스, 그리고 JPA 속성명의 접두사를 모두 변경해야 함을 의미한다. EclipseLink는 이전 버전과의 호환성을 위한 별도의 모듈을 제공하지 않으며, Jakarta EE 9+ 생태계로의 완전한 전환을 지향한다.