[Spring] 6_4. 스프링 DB 접근 기술 - JPA

JdbcTemplate으로 바꾸고 나니까 중복되는 코드가 확! 줄었다. 그럼에도 불구하고 아직도 SQL 쿼리도 개발자가 직접 작성해야한다. . .

• JPA는 기존의 반복 코드는 물론이고, 기본적인 SQL도 JPA가 직접 만들어서 실행해준다.
• JPA를 사용하면, SQL과 데이터 중심의 설계에서 객체 중심의 설계로 패러다임을 전환을 할 수 있다.
• JPA를 사용하면 개발 생산성을 크게 높일 수 있다.

여기서는 JPA로 코드를 작성하는 방법을 간단하게 알아볼거고, 이후 JPA 1 강의를 보며 JPA로 코드를 작성해볼 예정이다!

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

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
    implementation 'org.springframework.boot:spring-boot-starter-web'
    // implementation 'org.springframework.boot:spring-boot-starter-jdbc'
    implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
    runtimeOnly 'com.h2database:h2'
    
    testImplementation('org.springframework.boot:spring-boot-starter-test') {
        exclude group: 'org.junit.vintage', module: 'junit-vintage-engine'
    }
}

스프링 부트에 JPA 설정 추가

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 엔티티 매핑

package hello.hello_spring.domain;

import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;

@Entity
public class Member {
    @Id @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String name;

    public Long getId() {
        return id;
    }

    public String getName() {
        return name;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public void setName(String name) {
        this.name = name;
    }
}

• @Entity 어노테이션을 사용하여 해당 클래스가 JPA에서 관리하는 엔티티 클래스임을 명시하고,
• 기본 키 역할을 하는 id 필드에는 @Id와 @GeneratedValue(strategy = GenerationType.IDENTITY)를 사용해 DB에서 자동 증가되는 PK로 매핑해줍니다.

💡 만약 DB 컬럼명이 username이라면 아래처럼 매핑해줘야 한다

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

JPA 회원 레포지토리

package hello.hello_spring.repository;

import hello.hello_spring.domain.Member;
import jakarta.persistence.EntityManager;

import java.sql.SQLException;
import java.util.List;
import java.util.Optional;

public class JpaMemberRepository implements MemberRepository {

    // Jpa를 사용하려면 EntityManager를 주입받아야한다.
    private final EntityManager em;

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

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

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

    @Override
    public Optional<Member> findMyName(String name) throws SQLException{
        List<Member> result = em.createQuery("select m from Member m where m.name = :name", Member.class)
                .setParameter("name", name)
                .getResultList();
        return result.stream().findAny();
    }

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

 

EntityManager

• JPA의 핵심 객체로, DB 작업의 모든 기능을 제공
• @PersistenceContext 또는 생성자 주입을 통해 사용

save()

em.persist(member);

• 새로운 데이터를 DB에 저장
• @GeneratedValue 설정 시, id 값은 자동으로 생성

findMyId(Long id)

em.find(Member.class, id);

• 기본 키(PK)로 한 건을 조회

findMyName(String name)

em.createQuery("select m from Member m where m.name = :name")

• JPQL을 사용하여 name 필드로 조회
• 결과가 0개일 수 있으므로 Optional로 감쌌다.

findAll()

em.createQuery("select m from Member m")

• 전체 멤버 리스트를 조회

Entity 클래스 매핑 예시

@Entity
public class Member {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String name;
}

• @Entity: JPA가 관리하는 객체로 지정
• @Id: 기본 키 설정
• @GeneratedValue: 자동 증가 설정

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

import org.springframework.transaction.annotation.Transactional

@Transactional

public class MemberService {}

• 스프링은 해당 클래스의 메서드를 실행할 때 트랜잭션을 시작하고, 메서드가 정상 종료되면 트랜잭션을 커밋한다. 만약 런타임 예외가 발생하면 롤백한다.
• JPA를 통한 모든 데이터 변경은 트랜잭션 안에서 실행해야 한다.

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

package hello.hello_spring;

import hello.hello_spring.repository.*;
import hello.hello_spring.service.MemberService;
import jakarta.persistence.EntityManager;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import javax.sql.DataSource;

@Configuration
public class SpringConfig {

    private DataSource dataSource;

//    @Autowired
//    public SpringConfig(DataSource datasource){
//        this.dataSource = datasource;
//    }

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

    @Bean
    public MemberService memberService(){
        return new MemberService(memberRepository());
    }

    @Bean
    MemberRepository memberRepository(){
//        return new MemoryMemberRepository();
//        return new JdbcMemberRepository(dataSource);
//        return new JdbcTemplateMemberRepository(dataSource);
        return new JpaMemberRepository(em);
    }
}