스프링 입문 - (17) JPA(Java Persistence API)

 

JPA는 자바 진영에서 ORM(Object-Relational Mapping) 기술 표준으로 사용되는 인터페이스의 모음이다

실제적으로 구현된것이 아니라 구현된 클래스와 매핑을 해주기 위해 사용되는 프레임워크이다.

JPA를 구현한 대표적인 오픈소스로는 Hibernate가 있다

( JPA는 인터페이스 /  구현 hibernate )

 

 

ORM(Object-Relational Mapping)

객체-관계 매핑

객체지향 언어의 객체와 관계형 데이터베이스의 데이터 사이에서 나타나는 미묘한 차이와

이로 인한 문제들을 극복하기 위해 등장한 기술이다.

 

우리가 일반 적으로 알고 있는 애플리케이션 Class와 RDB(Relational DataBase)의 테이블을 매핑(연결)한다는 뜻이며,

기술적으로는 어플리케이션의 객체를 RDB 테이블에 자동으로 영속화 해주는 것이라고 보면된다.

 

SQL문이 아닌 Method를 통해 DB를 조작

(내부적으로는 쿼리를 생성하여 DB를 조작함. 하지만 개발자가 이를 신경 쓰지 않아도됨)

 

 

JPA는 기존의 반복 코드는 물론이고, 기본적인 SQL도 JPA가 직접 만들어서 실행해준다.

JPA를 사용하면, SQL과 데이터 중심의 설계에서 객체 중심의 설계로 패러다임을 전환을 할 수 있다.

 

JPA를 사용하면 개발 생산성을 크게 높일 수 있다.

 

 

build.gradle 파일에 JPA, h2 데이터베이스 관련 라이브러리 추가

implementation 'org.springframework.boot:spring-boot-starter-data-jpa'

spring-boot-starter-data-jpa 는 내부에 jdbc 관련 라이브러리를 포함한다. 따라서 jdbc는 제거해도 된다.

 

 

스프링 부트에 JPA 설정 추가

resources/application.properties

spring.datasource.url=jdbc:h2:tcp://localhost/~/test
spring.datasource.driver-class-name=org.h2.Driver
spring.datasource.username=sa
spring.jpa.show-sql=true
spring.jpa.hibernate.ddl-auto=none

 

show-sql : JPA가 생성하는 SQL을 출력한다.
ddl-auto : JPA는 테이블을 자동으로 생성하는 기능을 제공하는데 none 를 사용하면 해당 기능을 끈다.

create 를 사용하면 엔티티 정보를 바탕으로 테이블도 직접 생성해준다. 해보자.

 

 

JPA 엔티티 매핑

import javax.persistence.Entity;

@Entity
public class Member

 

@Entity

 

JPA에서 엔티티란 쉽게 생각하면, DB 테이블에 대응하는 하나의 클래스라고 생각할 수 있습니다.

 

@Entity가 붙은 클래스는 JPA가 관리해주며,

JPA를 사용해서 DB 테이블과 매핑할 클래스는 @Entity를 꼭 붙여야만 매핑이 가능합니다.

 

엔티티 클래스는 테이블과 매핑되는 클래스이다. 

애노테이션을 사용하여 적절히 엔티티 클래스를 구성하고, 완성된 엔티티 클래스는 명세를 기반으로 테이블과 매핑된다.

 

insert into member(name) values("spring1");

쿼리에 id를 넣지않았음

 

@Id @GeneratedValue(strategy = GenerationType.IDENTITY)

 

@Id

데이터베이스 테이블의 기본 키(PK)와 객체의 필드를 매핑시켜주는 어노테이션입니다.

 

기본 키를 애플리케이션에서 직접 엔티티클래스의 @Id 필드에 set해준다.

기본 키를 직접 할당하는 대신 데이터베이스가 생성해주는 값을 사용하려면 @GeneratedValue를 사용해주면 됩니다.

 

@GeneratedValue

기본 키를 자동 생성해주는 어노테이션입니다.

기본 키 생성을 데이터베이스에 위임

 

@GeneratedValue(strategy = GenerationType.IDENTITY)

-> DB에 값을 넣으면 DB가 id를 자동으로 생성  == IDENTITY 전략

즉, id 값을 null로 하면 DB가 알아서 AUTO_INCREMENT 해준다.

 

JPA 회원 리포지토리

public class JpaMemberRepository implements MemberRepository{

    private final EntityManager em;

    public JpaMemberRepository(EntityManager em) {
        this.em = em;
    }

 

EntityManager

Entity

• 테이블과 매칭되는 개념
• ORM 을 이루는 기반 개념 중 하나. 객체와 RDB 간 연결시켜주는 존재

 

EntityManager

• 엔티티를 관리하는 역할을 한다.

JPA는 EntityManager로 모든것을 동작

스프링부트가 자동으로 EntityManager를 생성해줌 ( 데이터베이스와 연결을 다 한 상태 ) 

우리는 만들어진것을 인젝션 받으면 된다 

 

 

[JPA] EntityManager 명령어 정리

 

 

@Override
public Member save(Member member) {
    em.persist(member);
    return member;
}

 

 

 

@Override
public Optional<Member> findById(Long id) {
     Member member = em.find(Member.class, id);
    return Optional.ofNullable(member);
}

find(class이름,기본키)

• EntityManager의 find() 메서드는 DB를 통해서 실제 엔티티 객체를 조회하는 메서드
• 해당하는 객체를 영속성 컨텍스트로 가져온다. 

 

 

@Override
public List<Member> findAll() {
    return em.createQuery("select m from Member as m", Member.class)
            .getResultList();
}

createQuery(jpql)

jpql을 sql로 쿼리를 생성해 데이터베이스에 전송한다.

 

query.getResultList()

결과를 컬렉션으로 반환한다.

 

객체(엔티티)를 대상으로 쿼리를 날린다 -> sql 로 번역

 

from Member as m : 엔티티를 조회

select m : member 엔티티 자체를 select

 

 

JPQL

(JPQL은 엔티티 객체를 조회하는 객체지향 쿼리 언어이다.)

 

결과 조회

• query.getResultList()결과를 컬렉션으로 반환한다. 결과가 없으면 빈 컬렉션이 반환된다. 1건이면 1건만 들어간 컬렉션이 반환된다.

 

https://joont92.github.io/jpa/JPQL/

 

 

@Override
public Optional<Member> findByName(String name) {
    List<Member> result = em.createQuery("select m from Member as m where m.name = :name", Member.class)
            .setParameter("name", name)
            .getResultList();

    return result.stream().findAny();
}

query.getResultList()

결과를 컬렉션으로 반환한다.

 

파라미터 바인딩

아래와 같은 이름 기준 파라미터 바인딩을 지원한다.

TypedQuery<Member> query = 
    em.createQuery("SELECT m FROM Member m WHERE m.username = :username", Member.class)
    .setParameter("username", "joont1"); // JPQL은 대부분 메서드 체인 방식으로 되어있어서 이렇게 연속해서 작성하는 것이 가능하다

List<Member> result = query.getResultLst();

username은 Member 클래스에 정의된 프로퍼티 이름이다. 앞에 :를 붙여서 바인딩한다.
username 에 joont1 이 바인딩 될 것이다.

 

JPA를 쓸려면 트랜잭션이 있어야함 ( 데이터를 저장하거나 변경할 때 ) 

-> 서비스 계층에 트랜잭션 추가

import org.springframework.transaction.annotation.Transactional

@Transactional
public class MemberService {}

스프링은 해당 클래스의 메서드를 실행할 때 트랜잭션을 시작하고, 메서드가 정상 종료되면 트랜잭션을 커밋한다.

만약 런타임 예외가 발생하면 롤백한다.

JPA를 통한 모든 데이터 변경은 트랜잭션 안에서 실행해야 한다.

 

 

JPA를 사용하도록 스프링 설정 변경

public class SpringConfig {
    
    private EntityManager em;

    @Autowired
    public SpringConfig(EntityManager em) {
        this.em = em; 
    }

public MemberRepository memberRepository() {
    return new JpaMemberRepository(em);
}