[JPA] JPA 실습 구성하기 - 1

원래는 Sprind-data-jpa로 실습을 하려다가 JPA를 먼저하고 해도 늦지 않을거같아 간단한 예제들만 테스트 하면서 넘어가기 위해 JPA 실습환경을 구축해봤습니다.

먼저 JPA 구현체로 하이버네이트를 사용하기 위한 핵심 라이브러리는 3가지가 있습니다.

hibernate-core : 하이버네이트 라이브러리
hibernate-entitymanager : 하이버네이트가 JPA 구현체로 동작하도록 JPA 표준을 구현한 라이브러리
hibernate-jpa-2.1-api: JPA2.1 표준 API를 모아둔 라이브러리

실습한 저의 환경구성은 다음과 같습니다
SpringBoot 2.4.1 H2 DB Maven Lombok을 사용하였습니다.

h2 db 설치관련된 내용은 검색하면 많이 나오기 때문에 생략하겠습니다.

일단 설정파일부터 작성해보겠습니다. JPA 설정 파일인 persistence.xml은
resource/META-INF/persistence.xml 경로에 있어야 합니다. ( 별도의 설정없이 JPA를 인식 가능 )

META-IMF에 안넣었다가 JPA persistence-unit name을 찾지 못하여 뭘잘못한지도 모르고 30분정도 삽질했습니다.

<?xml version="1.0" encoding="UTF-8"?>
<persistence xmlns="http://xmlns.jcp.org/xml/ns/persistence" version="2.1">

    <persistence-unit name="jpa-sample">

        <properties>

            <!-- 필수 속성 -->
            <property name="javax.persistence.jdbc.driver" value="org.h2.Driver"/>
            <property name="javax.persistence.jdbc.user" value="sa"/>
            <property name="javax.persistence.jdbc.password" value=""/>
            <property name="javax.persistence.jdbc.url" value="jdbc:h2:tcp://localhost/~/test" />
            <property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect" />

            <!-- 옵션 -->
          
          	<!-- hibernate가 DB에 날리는 Query를 보여준다.  -->
            <property name="hibernate.show_sql" value="true" />
          
          	<!-- show_sql로 보여주는 Query를 이쁘게 Formating해준다.  -->
            <property name="hibernate.format_sql" value="true" />
          
          	<!-- 추가적인 주석을 표시해 준다.   -->
            <property name="hibernate.use_sql_comments" value="true" />
            
          	<!-- hibernate에 포함된 모듈로 Entity를 기반으로 DB 스키마를 생성해주거나 삭제 , 업데이트 해준다. -->
            <property name="hibernate.hbm2ddl.auto" value="create" />
        </properties>
    </persistence-unit>
</persistence>

필수 속성

• javax.persistence.jdbc.driver
  JDBC Driver 값
• javax.persistence.jdbc.user
  DB 연결시 사용할 ID
• javax.persistence.jdbc.password
  DB 연결시 사용할 Password
• javax.persistence.jdbc.url
  DB 연결시 사용할 URL
• hibernate.dialect
  데이터베이스 방언이라고 부르는데 종속적이지 않은 기술을 의미합니다. 추후 다른 포스팅으로 내용을 작성하겠습니다.

ddl-auto 옵션에는 다음과 같이 4가지 옵션이 있다.

• create : SessionFactory 시작시 Scheme를 삭제하고 다시 생성한다.
• create-drop : SessionFactory 종료시 만들었던 Scheme를 삭제
• update : SessionFactory 시작시 객체의 현재 구성과 기존의 Scheme를 비교하여 컬럼 추가 삭제작업을 진행 단, 기존의 Scheme를 삭제하지 않고 유지한다.
• validate : SessionFactory 시작시 객체구성과 Scheme가 다르다면 Exception 발생

Entity 생성

자 이제 설정은 끝났으니 제대로 Entity가 생성되어 저장되는지 간단한 코드를 작성해보겠습니다.

@Entity
@Getter
@NoArgsConstructor(access = AccessLevel.PROTECTED)
public class Member {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private int idx;

    private String name;

    public Member(String name) {
        this.name = name;
    }

    @Override
    public String toString() {
        final StringBuffer sb = new StringBuffer("Member{");
        sb.append("idx=").append(idx);
        sb.append(", name='").append(name).append('\'');
        sb.append('}');
        return sb.toString();
    }
}

아직은 코드가 어떤 의미를 갖는지는 알필요가 없습니다. 일단 제대로 연결이 되었는지 확인하고 그 다음 포스팅에 자세히 다뤄보겠습니다.

실행되는 코드는 다음과 같습니다.

public class JpaApplication {
    public static void main(String[] args) {

        EntityManagerFactory emf = Persistence.createEntityManagerFactory("jpa-sample");
        EntityManager em = emf.createEntityManager(); //엔티티 매니저 생성

        EntityTransaction tx = em.getTransaction(); //트랜잭션 기능 획득

        try {
            tx.begin(); //트랜잭션 시작
            Member member = new Member("최윤진");
            em.persist(member);

            tx.commit();//트랜잭션 커밋

        } catch (Exception e) {
            tx.rollback(); //트랜잭션 롤백
        } finally {
            em.close(); //엔티티 매니저 종료
        }

        emf.close(); //엔티티 매니저 팩토리 종료
    }
}

다음과 같이 코드를 작성하고 실행하면 SessionFactory가 시작될때

# drop table 이 실행된다음 새로운 Table 이 생성된다. (ddl-auto:create)
drop table if exists Member CASCADE ;
create table Member (
  idx integer generated by default as identity,
  name varchar(255),
  primary key (idx)
);

# 그다음 Member data가 insert되는 것을 확인할 수 있다.
 /* insert io.yundle.app.domain.Member
        */ insert 
        into
            Member
            (idx, name) 
        values
            (null, ?)
Hibernate: 
    /* insert io.yundle.app.domain.Member
        */ insert 
        into
            Member
            (idx, name) 
        values
            (null, ?)