Enum, @Enumrated

[HyerimH]

❌ 문제 상황

No response

📝 핵심 내용과 방향성

Enum

Enumeration의 앞 글자로 열거라는 의미를 갖는. Enum(열거형)은 상수들의 집합을 나타내는 데이터 타입이다. 주로 상태 값, 카테고리, 역할(Role) 등을 정의할 때 사용한다.

JPA에서 @Enumerated 사용법

Spring Boot + JPA에서 Enum을 사용할 경우, @Enumerated 어노테이션을 통해 DB 저장 방식을 결정할 수 있다.

(1) @Enumerated(EnumType.STRING)

• 문자열(String) 타입으로 저장
• 가독성이 좋고, 값이 변경될 위험이 없음
• 하지만, 저장 시 데이터 크기가 커질 수 있음

@Entity
public class Order {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
@Enumerated(EnumType.STRING) // ENUM을 String으로 저장
private OrderStatus status;

}

DB 저장 예시: "PENDING", "SHIPPED"

(2) @Enumerated(EnumType.ORDINAL)

• Enum의 순서를 숫자(0부터 시작)로 저장
• 데이터 크기가 작음
• 하지만, Enum 값이 추가/변경되면 기존 데이터와 불일치 위험이 있음

@Entity
public class Order {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
@Enumerated(EnumType.ORDINAL) // ENUM을 숫자로 저장
private OrderStatus status;

}

DB 저장 예시: 0, 1, 2, 3 (PENDING = 0, SHIPPED = 1, ...)

Enum을 JPA에서 안전하게 사용하기

• EnumType.STRING 사용을 권장 → 유지보수성을 위해
• 변경 가능성이 있는 Enum에는 ORDINAL 사용 금지 (순서가 바뀌면 데이터가 꼬일 위험)
• Enum 값 추가 시 기존 데이터에 영향이 없는지 확인

@Enumerated(EnumType.STRING) // 항상 STRING 사용 권장
private OrderStatus status;

RoleType/Role의 차이점

package onepiece.dailysnapbackend.object.constants;
import lombok.AllArgsConstructor;

import lombok.Getter;
@AllArgsConstructor

@Getter

public enum Role {

ROLE_ADMIN("관리자"),

ROLE_USER("일반 회원");
private final String description;

}

package onepiece.dailysnapbackend.object.constants;

import lombok.AllArgsConstructor;
import lombok.Getter;

@AllArgsConstructor
@Getter
public enum Role {
  ROLE_ADMIN("관리자"),
  ROLE_USER("일반 회원");

  private final String description;
}

🎯 차이점 정리

항목	RoleType (문제 있음)	Role (올바른 방식)
값 저장	필드 없음 (값 저장 X)	private final String description;
생성자	매개변수 있지만 값 저장 X	@AllArgsConstructor로 필드에 값 저장
Getter	없음	있음 (@Getter)
사용 목적	USER, GUEST, ADMIN 역할 구분	역할을 표현하면서 한글 설명 추가
개선 필요성	필드 추가 및 Getter 필요	잘 설계됨

📚 트러블슈팅 및 기대효과

No response

🔗 관련 자료

No response

🙋‍ 담당자

• 백엔드: 이름
• 프로트엔드: 이름
• 디자인: 이름