Java JPA 기초, @Entity와 @Id로 배우는 엔티티 매핑 완벽 가이드

🔗 JPA와 엔티티 매핑 기본 개념

JPA(Java Persistence API)는 자바 객체와 관계형 데이터베이스 간의 데이터를 매핑하고 관리하기 위한 표준 ORM(Object-Relational Mapping) 기술입니다.
기존 JDBC 방식처럼 SQL 쿼리를 직접 작성하지 않고, 객체 중심으로 데이터베이스 작업을 처리할 수 있게 해주죠.
이를 통해 개발자는 객체지향적인 설계와 데이터베이스 연동을 자연스럽게 결합할 수 있습니다.

JPA의 핵심은 자바 클래스와 데이터베이스 테이블 간의 엔티티(Entity) 매핑입니다.
즉, 데이터베이스의 한 테이블이 자바 클래스 하나와 연결되고, 테이블의 각 컬럼이 클래스의 필드와 매칭됩니다.
이 과정을 통해 자바 객체를 데이터베이스에 저장하거나 조회할 때 SQL을 직접 작성하지 않아도 되며, JPA가 내부적으로 적절한 SQL을 생성해 실행합니다.

📌 엔티티 매핑이 중요한 이유

엔티티 매핑은 단순히 테이블과 클래스를 연결하는 작업을 넘어, 애플리케이션의 유지보수성과 확장성을 높이는 핵심 과정입니다.
클래스 구조를 변경하면 매핑 설정만 수정해 데이터베이스와 동기화할 수 있어, 대규모 프로젝트에서도 안정적으로 데이터 모델을 관리할 수 있습니다.
또한 엔티티 매핑 규칙을 잘 지키면 데이터 무결성과 성능 최적화에도 유리합니다.

💬 엔티티 매핑은 JPA의 시작이자 끝이라고 할 수 있습니다. 올바른 매핑 구조를 잡아두면 이후 개발이 훨씬 수월해집니다.

• 🛠️클래스와 테이블 간 매핑 규칙 이해
• ⚙️@Entity와 @Id 기본 용도 숙지
• 🔌매핑 전략과 키 생성 정책 선택

🛠️ @Entity 어노테이션 사용법

@Entity는 JPA에서 해당 클래스가 데이터베이스의 테이블과 매핑된 엔티티임을 나타내는 어노테이션입니다.
이 어노테이션이 선언된 클래스는 JPA의 관리 대상이 되어, 데이터베이스 CRUD 작업을 객체 지향적으로 수행할 수 있게 됩니다.
즉, @Entity를 붙여야만 해당 클래스가 영속성 컨텍스트에 의해 관리될 수 있습니다.

기본적으로 @Entity를 선언할 때 클래스에는 다음과 같은 규칙을 지켜야 합니다.
기본 생성자가 반드시 존재해야 하며, final 클래스나 final 메서드는 피하는 것이 좋습니다.
또한, 필드는 private 또는 protected로 선언하고, getter/setter를 통해 접근하도록 하는 것이 JPA 표준 가이드라인입니다.

📌 @Entity 속성과 옵션

@Entity에는 name 속성을 지정해 엔티티의 이름을 변경할 수 있습니다.
기본적으로 엔티티 이름은 클래스명과 동일하지만, name 속성을 사용하면 JPQL 쿼리에서 다른 이름을 사용할 수 있죠.
이는 데이터베이스 테이블명과 혼동을 피하거나, 비즈니스 용어에 맞춘 명명 규칙을 적용할 때 유용합니다.

import jakarta.persistence.Entity;
import jakarta.persistence.Id;

@Entity(name = "MemberEntity")
public class Member {

    @Id
    private Long id;
    private String name;

    // 기본 생성자
    public Member() {}

    public Member(Long id, String name) {
        this.id = id;
        this.name = name;
    }

    // Getter & Setter
}

⚙️ @Id로 기본 키 매핑하기

@Id 어노테이션은 엔티티의 필드를 데이터베이스 테이블의 기본 키(Primary Key)와 매핑할 때 사용합니다.
JPA에서 엔티티를 저장하려면 반드시 식별자가 필요하며, 이 식별자는 데이터베이스에서 각 레코드를 유일하게 구분하는 값입니다.
@Id가 선언되지 않은 엔티티는 JPA가 관리할 수 없습니다.

기본 키를 설정할 때는 단순히 필드에 @Id를 붙이는 것 외에도, 키 생성 전략을 함께 고려해야 합니다.
키 값은 직접 애플리케이션에서 지정할 수도 있고, 데이터베이스나 JPA가 자동으로 생성하도록 할 수도 있습니다.
대표적인 자동 생성 전략은 IDENTITY, SEQUENCE, TABLE 전략이 있습니다.

📌 @Id 필드 선언 예시

import jakarta.persistence.Entity;
import jakarta.persistence.Id;

@Entity
public class Product {

    @Id
    private String productId;
    private String name;
    private int price;

    public Product() {}

    public Product(String productId, String name, int price) {
        this.productId = productId;
        this.name = name;
        this.price = price;
    }

    // Getter & Setter
}

🔌 기본 키 생성 전략 이해하기

JPA에서 @Id를 사용할 때는 기본 키를 어떤 방식으로 생성할지도 함께 고려해야 합니다.
이를 위해 @GeneratedValue 어노테이션을 사용하며, 전략에 따라 키 생성 방식이 달라집니다.
대표적인 생성 전략은 다음과 같습니다.

📌 기본 키 생성 전략 예시

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

@Entity
public class Order {

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

    private String orderNumber;
}

💡 실전 예제: @Entity와 @Id 적용 코드

지금까지 살펴본 @Entity와 @Id 개념을 종합해, 실제로 JPA에서 엔티티를 선언하고 기본 키를 설정하는 예제를 만들어 보겠습니다.
아래 예제는 회원(Member) 엔티티를 생성하고, IDENTITY 전략을 사용해 기본 키를 자동 생성하는 방식입니다.

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 username;
    private String email;

    public Member() {}

    public Member(String username, String email) {
        this.username = username;
        this.email = email;
    }

    // Getter & Setter
}

📌 실행 및 확인

이 엔티티를 Spring Data JPA 저장소를 통해 저장하면, JPA가 자동으로 INSERT 쿼리를 생성해 데이터베이스에 레코드를 추가합니다.
저장 후에는 id 필드가 DB에서 생성된 기본 키 값으로 자동 채워집니다.
이는 JPA의 영속성 컨텍스트가 엔티티를 관리하기 때문에 가능한 동작입니다.

💬 실제 프로젝트에서는 엔티티 클래스 하나로 수많은 SQL 작업을 자동 처리할 수 있어, 생산성과 유지보수성이 크게 향상됩니다.

❓ 자주 묻는 질문 (FAQ)