[JPA] 자바 ORM 표준 JPA 프로그래밍 Ch.2

Chapter 02 _ JPA 시작

👩‍💻 예제 코드

GitHub - holyeye/jpabook

1️⃣ 이클립스 설치와 프로젝트 불러오기

➡️ 나의 경우 평소 프레임워크인 Intellij 를 사용하기로 했다.

2️⃣ H2 데이터베이스 설치

① 최신 버전 설치 (2023.04.15 기준 2.1.214 버전 설치)

H2 Database Engine

② 압축 푼 후 터미널 실행
bin/h2.sh 명령어 수행 (권한 오류 날 경우 chmod +x bin/h2.sh 수행 후 재시도)

접속 콘솔창

⚡️ 이슈 (접속불가)
이슈
'User/<사용자이름>/test' 경로에 파일이 존재하지 않는다는 오류가 발생했다.
문제
h2 1.4.198 버전부터는 보안상의 이유로 database 파일이 자동으로 생성되지 않아 직접 생성해주어야한다고 한다.
해결
해당 경로에 터미널에서 vi test.mv.db 명령어를 통해 파일을 생성한 후 접속하였더니 성공하였다.

접속 성공 화면

④ 예제 테이블 생성

CREATE TABLE MEMBER (
    ID VARCHAR(255) NOT NULL,
    NAME VARCHAR(255),
    AGE INTEGER NOT NULL,
    PRIMARY KEY (ID)
)

정상 실행 확인

3️⃣ 라이브러리와 프로젝트 구조

➡️ 간단한 구조 이야기니 넘어가도록 하자.

4️⃣ 객체 매핑 시작

➡️ 2️⃣ 에서 만들었던 MEMBER 테이블과 Member Class 를 매핑하는 과정을 확인한다.

테이블과 클래스의 매핑 정보 /&nbsp;출처 : 자바 ORM 표준 JPA 프로그래밍

① H2 콘솔에서 MEMBER 테이블 생성 (2️⃣에서 만들었다면 생략)

② 프레임 워크에서 Member 클래스 생성

import javax.persistence.*; // 어노테이션

@Entity
@Table(name="MEMBER")
public class Member {

    @Id
    @Column(name = "ID")
    private String id;

    @Column(name = "NAME")
    private String username;

    private Integer age;

    // Getter 와 Setter 은 코드 생략
}

③ 관련 어노테이션 정리

• @Entity : 이 클래스를 테이블과 매핑한다고 JPA 에게 알려준다.
• @Table : Entity 클래스에 매핑할 테이블 정보를 알려준다. 이 어노테이션을 생략하면 클래스 이름을 테이블 이름으로 사용한다.
• @Id : Entity 클래스의 해당 필드를 테이블을 PK(Primary Key) 에 매핑한다. 해당 필드를 식별자 필드 라고 한다.
• @Column : 필드를 컬럼에 매핑한다.
• 매핑 정보가 없는 필드 : 매핑 어노테이션을 생략하면 필드명을 사용해서 컬럼명으로 매핑한다. 설정에 따라 대소문자를 구별할 수 있으므로 주의하여야한다.

📣 JPA 어노테이션의 패키지는 javax.persistence 이다.

5️⃣ persistence.xml 설정

➡️ Maven 에서의 persistence.xml 파일은 Gradle 의 application.properties 파일과 같은 역할을 한다고 생각하면 될 것 같다.

⚫️ JPA 표준 속성
- javax.persistence.jdbc.driver : JDBC 드라이버
- javax.persistence.jdbc.user : 데이터베이스 접속 아이디
- javax.persistence.jdbc.password : 데이터베이스 접속 비밀번호
- javax.persistence.jdbc.url : 데이터베이스 접속 URL

⚫️ 하이버네이트 속성
-hibernate.dialect : 데이터베이스 방언 설정

① 데이터베이스 방언

➡️ JPA 는 특정 데이터베이스에 종속적이지 않은 기술이다. 따라서 SQL, H2 등은 각자 조금씩 다른 표현들을 사용하므로 설정에 사용하는 데이터베이스를 명시해주어야한다.

6️⃣ 애플리케이션 개발

public class JpaMain {

    public static void main(String[] args) {

        // ① 앤티티 매니저 설정

        // 엔티티 매니저 팩토리 생성
        EntityManagerFactory emf = Persistence.createEntityManagerFactory("jpabook");
        EntityManager em = emf.createEntityManager(); //엔티티 매니저 생성

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

        // ② 트랜잭션 관리
        try {
            tx.begin(); //트랜잭션 시작
            logic(em);  //비즈니스 로직
            tx.commit();//트랜잭션 커밋

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

    // ③ 비지니스 로직
    public static void logic(EntityManager em) { ... }
}

➡️ 코드는 크게 3부분으로 나누어진다.

• 엔티티 매니저 설정
• 트랜잭션 관리
• 비즈니스 로직

① 엔티티 매니저 설정

엔티티 매니저 생성 과정 /&nbsp;출처 : 자바 ORM 표준 JPA 프로그래밍

(1) 엔티티 매니저 팩토리 생성

➡️ persistence.xml 파일 설정을 바탕으로 앤티티 매니저 팩토리를 생성한다. 엔티티 매니저 팩토리는 애플리케이션 전체에서 딱 한번만 생성하고 공유해서 사용해야한다. (싱글톤 패턴)

(2) 엔티티 매니저 생성

➡️ JPA 기능 대부분은 엔티티 매니저가 제공한다. 엔티티 매니저를 사용해서 데이터베이스에 CRUD 할 수 있다.

❓ 엔티티 매니저는 데이터베이스 커넥션과 밀접한 관계가 있으므로 스레드간에 공유하거나 재사용하면 안 된다.

➡️ 사용이 끝난 엔티티 매니저와 매니저 팩토리는 종료해야한다.

② 트랜잭션 관리

➡️ JPA 를 사용하려면 항상 트랜잭션 안에서 데이터를 변경해야한다. 트랜잭션을 시작하기 위해서는 엔티티 매니저에서 트랜잭션 API 를 받아와야한다.

➡️ 트랜잭션 API 를 사용해서 비즈니스 로직이 정상 동작하면 트랜잭션을 커밋하고 예외가 발생하면 롤백 한다.

③ 비즈니스 로직

➡️ 엔티티 매니저를 통해 데이터베이스에 CRUD 한다.

 

⚫️ JPQL

JPQL : JPA 가 제공하는 SQL 을 추상화한 객체지향 쿼리 언어. 엔티티 객체 (클래스, 필드) 를 대상으로 쿼리문을 수행하기 때문에 JPQL 은 테이터베이스를 전혀 알지 못한다.

➡️ JPA 는 엔티티 객체를 중심으로 개발하므로 검색을 할 때도 테이블이 아닌 엔티티 객체를 대상으로 검색해야한다. 이를 위해서는 데이터베이스의 모든 데이터를 애플리케이션으로 불러와서 엔티티 객체로 변경한 다음 검색해야하지만, 사실상 이는 불가능하다.

SELECT m FROM Member m

➡️ 여기서 Member 는 MEMBER 테이블이 아닌 회원 엔티티 객체를 의미한다.

7️⃣ 정리

➡️ JPA 가 반복적인 JDBC API 와 결과 값 매핑을 처리해준 덕분에 코드량과 SQL 작성이 줄어들었다.