Spring 기초 Part 4: JPA, Entity와 Repository

Spring 기초 Part 4: JPA, Entity와 Repository

JPA는 자바 객체와 데이터베이스 테이블을 매핑하여 객체 중심으로 데이터를 다룰 수 있게 해주는 자바 표준이다.

개발자는 Entity와 Repository를 작성하고, JPA 구현체는 객체 정보를 바탕으로 SQL을 만든다.

Java 객체
   ↓
Spring Data JPA
   ↓
JPA
   ↓
Hibernate
   ↓
JDBC
   ↓
Database

1. 먼저 알아둘 단어

2. ORM은 왜 필요한가

자바는 객체를 사용하고 관계형 데이터베이스는 테이블을 사용한다.

두 구조가 다르기 때문에 JDBC만 사용하면 SQL 작성과 결과 변환을 직접 처리해야 한다.

String sql = "SELECT id, name, email FROM users WHERE id = ?";

// Connection, PreparedStatement, ResultSet 처리
// ResultSet 값을 꺼내 User 객체로 직접 변환

ORM을 사용하면 매핑 정보를 기준으로 반복 코드를 줄일 수 있다.

User user = userRepository.findById(id).orElseThrow();

ORM이 SQL 지식을 없애주는 것은 아니다. 생성되는 SQL과 데이터베이스 구조를 이해해야 성능 문제를 찾을 수 있다.

3. JPA, Hibernate, Spring Data JPA의 차이

세 단어는 같은 뜻이 아니다.

개발자가 UserRepository 호출
          ↓
Spring Data JPA가 Repository 구현 제공
          ↓
JPA 표준 방식으로 Entity 관리 요청
          ↓
Hibernate가 SQL 생성
          ↓
JDBC가 DB에 SQL 전달

JPA는 규칙이고, Hibernate는 그 규칙의 구현체이며, Spring Data JPA는 JPA를 편하게 사용하도록 도와준다.

4. Entity 만들기

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

@Entity
@Table(name = "users")
public class User {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(nullable = false, length = 50)
    private String name;

    @Column(nullable = false, unique = true)
    private String email;

    protected User() {
    }

    public User(String name, String email) {
        this.name = name;
        this.email = email;
    }
}

Entity 클래스에는 다음 조건이 필요하다.

• 클래스에 @Entity를 붙인다.
• @Id로 기본키를 지정한다.
• JPA가 사용할 public 또는 protected 기본 생성자가 필요하다.
• Entity 클래스 자체를 final로 선언하지 않는다.

주요 어노테이션

@GeneratedValue

@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;

IDENTITY 전략은 기본키 생성을 데이터베이스에 맡긴다. 새로운 사용자를 만들 때 개발자가 id를 직접 지정하지 않는다.

@Column

@Column 설정만 믿기보다 운영 DB에는 마이그레이션 도구 등을 이용해 실제 제약조건도 함께 관리해야 한다.

5. Repository 만들기

Spring Data JPA의 JpaRepository를 상속하면 기본 CRUD 기능을 사용할 수 있다.

public interface UserRepository extends JpaRepository<User, Long> {
}

두 타입의 의미는 다음과 같다.

• User: Repository가 관리할 Entity 타입
• Long: User의 기본키 타입

기본 제공 메서드는 다음과 같다.

메서드 이름을 분석해 조회 조건을 만들 수도 있다.

Optional<User> findByEmail(String email);

boolean existsByEmail(String email);

List<User> findByNameContaining(String keyword);

6. 사용자 저장 흐름

Service

@Service
public class UserService {

    private final UserRepository userRepository;

    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    @Transactional
    public Long createUser(String name, String email) {
        User user = new User(name, email);
        User savedUser = userRepository.save(user);
        return savedUser.getId();
    }
}

실행 흐름은 다음과 같다.

Spring Data JPA 저장 흐름

flowchart TD
    S[Service가 User 생성] --> R[UserRepository.save 호출]
    R --> SD[Spring Data JPA]
    SD --> H[Hibernate가 Entity 관리]
    H --> SQL[INSERT SQL 생성]
    SQL --> J[JDBC가 SQL 전달]
    J --> DB[(Database 저장)]

Hibernate는 Entity의 매핑 정보를 보고 대략 다음과 같은 SQL을 실행한다.

INSERT INTO users (name, email)
VALUES ('민형', 'min@example.com');

7. JPA와 JDBC 비교

JPA도 내부적으로 JDBC를 사용해 SQL을 전달한다.

JPA와 JDBC 중 하나만 선택

이 아니라 다음 구조에 가깝다.

JPA / Hibernate
      ↓
    JDBC
      ↓
  Database

8. H2 연결 설정

H2는 학습과 테스트에 많이 사용하는 가벼운 관계형 데이터베이스다.

spring:
  datasource:
    url: jdbc:h2:mem:testdb
    driver-class-name: org.h2.Driver
    username: sa
    password:

  h2:
    console:
      enabled: true
      path: /h2-console

  jpa:
    hibernate:
      ddl-auto: create-drop
    show-sql: true

create-drop은 애플리케이션 종료 시 테이블을 삭제하므로 운영 환경에서 사용하면 안 된다.

핵심 정리

JPA를 사용한다는 것은 SQL을 몰라도 된다는 뜻이 아니라, 객체와 테이블의 매핑을 이용해 반복적인 데이터 접근 코드를 줄인다는 뜻이다.

참고 자료

• Spring Data JPA 공식 문서
• Jakarta Persistence 공식 명세