🌱 Spring Boot 시작하기 17 -JPA Entity와 주요 어노테이션

날짜:2025-10-23

---

학습 목표

• @Entity, @Table, @Id, @GeneratedValue, @Column 등 주요 어노테이션 이해
• 엔티티와 테이블 구조 1:1 매핑 이해
• DDL 자동 생성 옵션 설정 이해

---

✅ Entity 개념

Entity란?

• 데이터베이스 테이블과 1:1 대응되는 자바 클래스
• 테이블의 행(row)을 객체(object) 로 매핑
• ORM(Object-Relational Mapping)의 핵심

---

✅ 주요 어노테이션

1)@Entity

• 클래스가 JPA 엔티티임을 나타냄
• 엔티티 클래스 이름이 테이블 이름과 매핑됨
  

 @Entity
     public class Member {
    // 클래스 내용
    }

---

2) @Table

• 엔티티와 매핑할 테이블 이름 지정
• 클래스와 테이블 이름 충돌이나 예약어 문제 방지

  @Entity
    @Table(name = "members")
    public class Member {
    // 클래스 내용
    }

---

Id & @GeneratedValue**

• Id: 기본 키(Primary Key) 매핑
• GeneratedValue: 기본 키 자동 생성 전략 지정
• ySQL에서는 IDENTITY 전략 사용

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

---

## **4)@Column**
- 필드와 컬럼 매핑 정보 지정
- @Column의 속성
  - name: 컬럼명 지정
  - length: 문자 길이 제약
  - nullable: null 허용 여부
  - unique: 유니크 제약 조건

```java
 @Column(unique = true, nullable = false, length = 50)
    private String email; 

---

✅ 엔티티와 테이블 매핑

• 엔티티는 테이블 구조를 자바 코드로 표현
• DB 컬럼은 엔티티의 필드와 1:1 대응
• ORM을 통해 자바 코드로 데이터 삽입, 조회, 수정, 삭제 가능
• @Column 기본값: length=255, nullable=true

테이블 SQL

CREATE TABLE users (
   id BIGINT AUTO_INCREMENT PRIMARY KEY,
   name VARCHAR(50) NOT NULL,
   email VARCHAR(255) NOT NULL UNIQUE,
   address VARCHAR(255)
   );

---

엔티티 클래스

@Getter
   @Entity
   @Table(name = "users")
   @NoArgsConstructor(access = AccessLevel.PROTECTED)
   public class User {

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

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

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

   private String address;
   }

💡 포인트

• @Column 미사용 시 length=255, nullable=true 기본값
• @NoArgsConstructor(access = AccessLevel.PROTECTED): JPA 내부 생성용 기본 생성자 제공

---

✅ JPA DDL 설정

application.properties 예시

spring.datasource.url=jdbc:mysql://localhost:3306/test
    spring.datasource.username=root
    spring.datasource.password=12345678
    spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
          spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect
    spring.jpa.hibernate.ddl-auto=create
    spring.jpa.show-sql=true
    spring.jpa.properties.hibernate.format_sql=true

---

ddl-auto 옵션

옵션	설명 사용 시기
create	기존 테이블 삭제 후 재생성
create-drop	create + 종료 시 삭제
update	변경분만 반영(컬럼 추가)
validate	엔티티와 테이블 매핑 정보만 확인
none	DDL 자동 생성 사용 안함

---

SQL 출력 옵션

옵션	설명
show-sql	실행되는 SQL 로그 출력
format_sql	로그 가독성을 위해 SQL 포맷팅

---

정리

• Entity는 DB 테이블을 코드로 표현한 클래스
• .@Entity, @Table, @Id, @GeneratedValue, @Column는 JPA 매핑의 핵심
• @NoArgsConstructor(PROTECTED): JPA가 객체를 생성할 때 사용
• DDL 옵션(create, update, validate)으로 애플리케이션 시작 시 테이블 자동 관리 가능
• JPA를 통해 SQL을 직접 작성하지 않고도 자바 코드로 데이터베이스 조작 가능