관계 매핑

JPA 관계 매핑 개념

JPA에서 엔터티 간의 관계를 설정할 때 연관 관계 매핑을 사용합니다. 관계는 다음과 같이 분류됩니다.

•

 1:1 (One-To-One) → @OneToOne

•

 1:N (One-To-Many) → @OneToMany

•

 N:1 (Many-To-One) → @ManyToOne

•

 N:M (Many-To-Many) → @ManyToMany

이 중 1:N & N:1 관계는 가장 많이 사용되며, 실무에서는 중간 테이블을 이용한 Many-To-Many 해결 방법이 일반적입니다.

관계 매핑 주요 어노테이션

어노테이션	설명
@OneToOne	1:1 관계 매핑
@OneToMany	1:N 관계 매핑 (한 개의 엔터티가 여러 개의 엔터티를 참조)
@ManyToOne	N:1 관계 매핑 (여러 개의 엔터티가 한 개의 엔터티를 참조)
@ManyToMany	N:M 관계 매핑 (중간 테이블을 별도로 만들지 않는 경우 사용)
@JoinColumn (name="foreign_key")	외래 키(FK)를 지정
@MappedBy	양방향 관계에서 반대쪽 매핑 설정
@Cascade(CascadeType.ALL)	연관된 엔터티의 상태 변경을 자동으로 전파
@Fetch (FetchType.LAZY / FetchType.EAGER)	연관 관계 데이터를 가져오는 방식 지정 (지연 로딩, 즉시 로딩)

Boards & Files 관계 매핑 예제 (1:N, N:1 관계 적용)

Boards(게시글)은 여러 개의 Files(파일)을 가질 수 있으므로 1:N 관계가 됩니다.

Boards 엔터티 (게시글)

import jakarta.persistence.*;
import lombok.*;
import org.springframework.data.annotation.CreatedDate;
import org.springframework.data.annotation.LastModifiedDate;

import java.time.LocalDateTime;
import java.util.List;

@Entity
@Table(name = "boards")
@Getter
@Setter
@NoArgsConstructor
@AllArgsConstructor
@Builder
public class Boards {

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

    @Column(nullable = false, length = 100)
    private String title;

    @Column(nullable = false, columnDefinition = "TEXT")
    private String content;

    @OneToMany(mappedBy = "board", cascade = CascadeType.ALL, orphanRemoval = true)
    private List<Files> files;

    @CreatedDate
    @Column(updatable = false)
    private LocalDateTime createdAt;

    @LastModifiedDate
    private LocalDateTime updatedAt;
}
Java
복사

Files 엔터티 (파일)

import jakarta.persistence.*;
import lombok.*;

@Entity
@Table(name = "files")
@Getter
@Setter
@NoArgsConstructor
@AllArgsConstructor
@Builder
public class Files {

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

    @Column(nullable = false)
    private String fileName;

    @Column(nullable = false)
    private String filePath;

    @ManyToOne
    @JoinColumn(name = "board_id", nullable = false)
    private Boards board;
}
Java
복사

관계 매핑 설명

Boards → Files (1:N 관계)

•

Boards는 여러 개의 Files를 포함합니다.

•

@OneToMany(mappedBy = "board")를 통해 양방향 매핑을 설정합니다.

•

cascade = CascadeType.ALL을 사용하면 Boards가 삭제될 때, 연관된 Files도 함께 삭제됩니다.

•

orphanRemoval = true를 설정하면 Files 엔터티가 Boards에서 제거될 경우, 자동으로 삭제됩니다.

Files → Boards (N:1 관계)

•

Files는 하나의 Boards에 속합니다.

•

@ManyToOne을 통해 board_id라는 외래 키(FK) 컬럼을 생성하고 Boards와 연결합니다.

•

@JoinColumn(name = "board_id")를 사용하여 Boards 테이블의 기본 키(id)와 연결됩니다.

JPA 관계 매핑 Best Practice

지연 로딩 (FetchType.LAZY) 추천

@ManyToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "board_id", nullable = false)
private Boards board;
Java
복사

•

기본적으로 @ManyToOne은 FetchType.EAGER(즉시 로딩)로 동작하는데, 이는 성능 저하를 일으킬 수 있음.

•

FetchType.LAZY를 사용하여 실제 데이터를 사용할 때만 조회하도록 설정.

CascadeType 설정

@OneToMany(mappedBy = "board", cascade = CascadeType.ALL, orphanRemoval = true)
private List<Files> files;
Java
복사

•

CascadeType.ALL을 사용하면 부모 엔터티 삭제 시 자식 엔터티도 함께 삭제됨.

•

orphanRemoval = true를 설정하면 관계가 끊어진 자식 엔터티는 자동 삭제됨.

정리

1:N 관계에서 @OneToMany(mappedBy = "board")를 사용하여 부모(Boards)가 자식(Files)을 관리합니다.

N:1 관계에서 @ManyToOne을 사용하여 외래 키(FK) 설정을 합니다.

지연 로딩 (FetchType.LAZY)을 기본 설정으로 사용하여 성능을 최적화합니다.

CascadeType 및 orphanRemoval 옵션을 활용하여 엔터티 수명 주기를 효과적으로 관리합니다.

이제 Boards 와 Files 간의 관계 매핑이 완료되었습니다!

JPA

•

JPA

•

JPA 주요 구성 요소

•

JPA 장점

•

JPA vs MyBatis

•

JPA 주요 기능

JPA란?

JPA(Java Persistence API)는 자바 진영의 ORM 기술 표준입니다. JPA를 사용하면 개발자가 직접 SQL을 작성하지 않고도 데이터베이스를 객체지향적으로 관리할 수 있습니다.

JPA 소개

ORM(Object-Relational Mapping)

객체와 테이블을 1:1로 매핑하여 SQL을 직접 사용하지 않고도 데이터베이스를 조작할 수 있도록 도와주는 기술입니다.

•

Persistence Framework

•

ORM vs SQL Mapper

Persistence Framework

•

ORM

ORM

엔터티(Entity)

@Entity 어노테이션을 사용하여 정의됩니다. 각 엔터티는 고유한 식별자(@Id)를 가지며, 데이터베이스 테이블의 레코드를 자바 객체로 표현합니다.

•

주요 어노테이션

•

엔터티 예시 코드

주요 어노테이션

엔터티

관계 매핑

JPA 관계 매핑 개념

JPA에서 엔터티 간의 관계를 설정할 때 연관 관계 매핑을 사용합니다. 관계는 다음과 같이 분류됩니다.

•

 1:1 (One-To-One) → @OneToOne

•

 1:N (One-To-Many) → @OneToMany

•

 N:1 (Many-To-One) → @ManyToOne

•

 N:M (Many-To-Many) → @ManyToMany

이 중 1:N & N:1 관계는 가장 많이 사용되며, 실무에서는 중간 테이블을 이용한 Many-To-Many 해결 방법이 일반적입니다.

관계 매핑 주요 어노테이션

어노테이션	설명
@OneToOne	1:1 관계 매핑
@OneToMany	1:N 관계 매핑 (한 개의 엔터티가 여러 개의 엔터티를 참조)
@ManyToOne	N:1 관계 매핑 (여러 개의 엔터티가 한 개의 엔터티를 참조)
@ManyToMany	N:M 관계 매핑 (중간 테이블을 별도로 만들지 않는 경우 사용)
@JoinColumn (name="foreign_key")	외래 키(FK)를 지정
@MappedBy	양방향 관계에서 반대쪽 매핑 설정
@Cascade(CascadeType.ALL)	연관된 엔터티의 상태 변경을 자동으로 전파
@Fetch (FetchType.LAZY / FetchType.EAGER)	연관 관계 데이터를 가져오는 방식 지정 (지연 로딩, 즉시 로딩)

Boards & Files 관계 매핑 예제 (1:N, N:1 관계 적용)

Boards(게시글)은 여러 개의 Files(파일)을 가질 수 있으므로 1:N 관계가 됩니다.

Boards 엔터티 (게시글)

Files 엔터티 (파일)

관계 매핑 설명

Boards → Files (1:N 관계)

•

Boards는 여러 개의 Files를 포함합니다.

•

@OneToMany(mappedBy = "board")를 통해 양방향 매핑을 설정합니다.

•

cascade = CascadeType.ALL을 사용하면 Boards가 삭제될 때, 연관된 Files도 함께 삭제됩니다.

•

orphanRemoval = true를 설정하면 Files 엔터티가 Boards에서 제거될 경우, 자동으로 삭제됩니다.

Files → Boards (N:1 관계)

•

Files는 하나의 Boards에 속합니다.

•

@ManyToOne을 통해 board_id라는 외래 키(FK) 컬럼을 생성하고 Boards와 연결합니다.

•

@JoinColumn(name = "board_id")를 사용하여 Boards 테이블의 기본 키(id)와 연결됩니다.

JPA 관계 매핑 Best Practice

지연 로딩 (FetchType.LAZY) 추천

•

기본적으로 @ManyToOne은 FetchType.EAGER(즉시 로딩)로 동작하는데, 이는 성능 저하를 일으킬 수 있음.

•

FetchType.LAZY를 사용하여 실제 데이터를 사용할 때만 조회하도록 설정.

CascadeType 설정

•

CascadeType.ALL을 사용하면 부모 엔터티 삭제 시 자식 엔터티도 함께 삭제됨.

•

orphanRemoval = true를 설정하면 관계가 끊어진 자식 엔터티는 자동 삭제됨.

정리

1:N 관계에서 @OneToMany(mappedBy = "board")를 사용하여 부모(Boards)가 자식(Files)을 관리합니다.

N:1 관계에서 @ManyToOne을 사용하여 외래 키(FK) 설정을 합니다.

지연 로딩 (FetchType.LAZY)을 기본 설정으로 사용하여 성능을 최적화합니다.

CascadeType 및 orphanRemoval 옵션을 활용하여 엔터티 수명 주기를 효과적으로 관리합니다.

이제 Boards 와 Files 간의 관계 매핑이 완료되었습니다!

관계 매핑

JPA 주요 어노테이션

JPA에서 자주 사용되는 어노테이션을 기본 엔터티, 관계 매핑, 기타 기능으로 분류하여 정리했습니다.

엔터티 기본 어노테이션

관계 매핑 어노테이션

기타 주요 어노테이션

주요 어노테이션

JPQL (Java Persistence Query Language)

JPQL 정의

특징

•

SQL과 유사한 문법을 사용하지만 테이블이 아닌 엔터티 객체를 대상으로 실행

•

데이터베이스 독립적으로 사용 가능

JPQL

Criteria API

SQL이나 JPQL과 달리, 자바 코드만으로 쿼리를 생성하기 때문에 컴파일 시점에서 오류를 잡을 수 있으며, 메서드 체이닝 방식으로 동적 쿼리를 쉽게 조립할 수 있습니다.

Criteria API 정의

특징

•

JPQL과 동일한 기능을 제공하면서 컴파일 시점에 오류를 확인 가능

Criteria API

Querydsl

기존 JPQL과 Criteria API의 복잡한 코드 작성을 단순화하면서도 가독성과 유지보수성을 높여주는 기능을 제공합니다.

Querydsl 정의

동적 쿼리를 간결한 코드로 작성할 수 있으며, 컴파일 시점에서 오류를 검출할 수 있습니다.

Querydsl