주요 어노테이션

JPA 주요 어노테이션

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

엔터티 기본 어노테이션

어노테이션	설명
@Entity	해당 클래스가 JPA 엔터티임을 선언
@Table(name = "table_name")	매핑할 테이블 이름 지정
@Id	기본 키(Primary Key) 지정
@GeneratedValue (strategy = GenerationType.IDENTITY)	기본 키 생성 전략 지정 (AUTO, IDENTITY, SEQUENCE, TABLE)
@Column (name = "name", nullable = false, length = 100)	컬럼 속성 지정 (이름, 길이, NULL 허용 여부 등)
@Embedded	객체 값 타입(내장 타입) 매핑
@Embeddable	내장 타입 클래스 지정
@Transient	DB에 매핑되지 않는 필드 지정

관계 매핑 어노테이션

어노테이션	설명
@OneToOne	1:1 관계 설정
@OneToMany(mappedBy = "field_name")	1:N 관계 설정 (부모)
@ManyToOne	N:1 관계 설정 (자식)
@ManyToMany	N:M 관계 설정
@JoinColumn(name = "foreign_key")	외래 키(FK) 설정
@JoinTable(name = "middle_table")	다대다(N:M) 관계에서 중간 테이블 매핑
@MappedBy	양방향 관계에서 연관된 필드명 지정
@Cascade(CascadeType.ALL)	연관된 엔터티의 변경 사항 전파
@Fetch(FetchType.LAZY / FetchType.EAGER)	지연 로딩(LAZY) or 즉시 로딩(EAGER) 설정

기타 주요 어노테이션

어노테이션	설명
@Lob	대용량 데이터(BLOB, CLOB) 저장
@Enumerated(EnumType.STRING)	Enum 타입 매핑 (STRING or ORDINAL)
@Temporal(TemporalType.TIMESTAMP)	날짜 및 시간 타입 매핑
@CreatedDate	엔터티 생성 시 자동으로 날짜 저장 (Spring Data JPA)
@LastModifiedDate	엔터티 수정 시 자동으로 날짜 업데이트 (Spring Data JPA)
@Version	낙관적 락(Optimistic Lock) 사용
@NamedQuery(name = "queryName", query = "JPQL_QUERY")	정적 JPQL 쿼리 지정
@Query("JPQL_QUERY")	Spring Data JPA에서 JPQL 쿼리 실행
@Modifying	데이터 변경 JPQL 실행 시 사용 (INSERT, UPDATE, DELETE)

실전 예제: 엔터티와 관계 매핑

Users 엔터티

import jakarta.persistence.*;
import lombok.*;
import java.time.LocalDateTime;

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

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

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

    @Column(nullable = false)
    private String password;

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

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

    @LastModifiedDate
    private LocalDateTime updatedAt;
}
Java
복사

Boards 엔터티

@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;

    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "user_id", nullable = false)
    private Users user;

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

    @LastModifiedDate
    private LocalDateTime updatedAt;
}
Java
복사

Files 엔터티

@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(fetch = FetchType.LAZY)
    @JoinColumn(name = "board_id", nullable = false)
    private Boards board;
}
Java
복사

정리

기본 엔터티 어노테이션 (@Entity, @Table, @Id, @GeneratedValue) 필수

관계 매핑 (@OneToMany, @ManyToOne, @JoinColumn) 활용

Cascade, FetchType 등 최적화 설정 고려

Spring Data JPA 어노테이션 (@CreatedDate, @LastModifiedDate) 활용

이렇게 JPA 어노테이션을 활용하면 엔터티와 관계를 효율적으로 관리할 수 있습니다!

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 해결 방법이 일반적입니다.

관계 매핑

JPA 주요 어노테이션

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

엔터티 기본 어노테이션

어노테이션	설명
@Entity	해당 클래스가 JPA 엔터티임을 선언
@Table(name = "table_name")	매핑할 테이블 이름 지정
@Id	기본 키(Primary Key) 지정
@GeneratedValue (strategy = GenerationType.IDENTITY)	기본 키 생성 전략 지정 (AUTO, IDENTITY, SEQUENCE, TABLE)
@Column (name = "name", nullable = false, length = 100)	컬럼 속성 지정 (이름, 길이, NULL 허용 여부 등)
@Embedded	객체 값 타입(내장 타입) 매핑
@Embeddable	내장 타입 클래스 지정
@Transient	DB에 매핑되지 않는 필드 지정

관계 매핑 어노테이션

어노테이션	설명
@OneToOne	1:1 관계 설정
@OneToMany(mappedBy = "field_name")	1:N 관계 설정 (부모)
@ManyToOne	N:1 관계 설정 (자식)
@ManyToMany	N:M 관계 설정
@JoinColumn(name = "foreign_key")	외래 키(FK) 설정
@JoinTable(name = "middle_table")	다대다(N:M) 관계에서 중간 테이블 매핑
@MappedBy	양방향 관계에서 연관된 필드명 지정
@Cascade(CascadeType.ALL)	연관된 엔터티의 변경 사항 전파
@Fetch(FetchType.LAZY / FetchType.EAGER)	지연 로딩(LAZY) or 즉시 로딩(EAGER) 설정

기타 주요 어노테이션

어노테이션	설명
@Lob	대용량 데이터(BLOB, CLOB) 저장
@Enumerated(EnumType.STRING)	Enum 타입 매핑 (STRING or ORDINAL)
@Temporal(TemporalType.TIMESTAMP)	날짜 및 시간 타입 매핑
@CreatedDate	엔터티 생성 시 자동으로 날짜 저장 (Spring Data JPA)
@LastModifiedDate	엔터티 수정 시 자동으로 날짜 업데이트 (Spring Data JPA)
@Version	낙관적 락(Optimistic Lock) 사용
@NamedQuery(name = "queryName", query = "JPQL_QUERY")	정적 JPQL 쿼리 지정
@Query("JPQL_QUERY")	Spring Data JPA에서 JPQL 쿼리 실행
@Modifying	데이터 변경 JPQL 실행 시 사용 (INSERT, UPDATE, DELETE)

실전 예제: 엔터티와 관계 매핑

Users 엔터티

Boards 엔터티

Files 엔터티

정리

기본 엔터티 어노테이션 (@Entity, @Table, @Id, @GeneratedValue) 필수

관계 매핑 (@OneToMany, @ManyToOne, @JoinColumn) 활용

Cascade, FetchType 등 최적화 설정 고려

Spring Data JPA 어노테이션 (@CreatedDate, @LastModifiedDate) 활용

이렇게 JPA 어노테이션을 활용하면 엔터티와 관계를 효율적으로 관리할 수 있습니다!

주요 어노테이션

JPQL (Java Persistence Query Language)

JPQL 정의

특징

•

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

•

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

JPQL

Criteria API

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

Criteria API 정의

특징

•

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

Criteria API

Querydsl

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

Querydsl 정의

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

Querydsl