2025-04-08T19:56:24

2025-04-08 19:56:24 +09:00
parent a75a1dbd0f
commit eef061c1c9
100 changed files with 18639 additions and 0 deletions
--- a/docs/jpa/07_값
+++ b/docs/jpa/07_값
@@ -0,0 +1,223 @@
+아래는 "값 타입과 임베디드 타입의 활용"에 대해 설명하는 글입니다. JPA의 값 타입(Value Type)과 임베디드 타입(Embedded Type)을 실무 관점에서 다루며, 예시를 포함해 구체적으로 작성했습니다.
+
+---
+
+### 값 타입과 임베디드 타입의 활용
+
+JPA에서 값 타입(Value Type)은 엔티티와 달리 독립적인 생명주기를 가지지 않고, 특정 엔티티에 속해 그 엔티티와 함께 생성되고 소멸되는 데이터입니다. 값 타입은 단순 데이터(예: 기본 타입)와 복합 데이터(임베디드 타입)로 나뉘며, 특히 임베디드 타입은 객체지향 설계의 재사용성과 가독성을 높이는 데 유용합니다. 이를 잘 활용하면 코드 중복을 줄이고 도메인 모델을 더 풍부하게 표현할 수 있습니다.
+
+#### 값 타입의 종류
+1. **기본 값 타입 (Basic Value Type)**  
+   - 자바의 기본형(`int`, `boolean`)과 래퍼 클래스(`Integer`, `String`) 등.
+   - 엔티티 필드에 직접 매핑되며, 데이터베이스 컬럼에 저장됩니다.
+2. **임베디드 타입 (Embedded Type)**  
+   - 사용자 정의 클래스를 값 타입으로 사용하며, `@Embeddable`과 `@Embedded`로 정의합니다.
+   - 여러 필드를 묶어 논리적 단위를 형성합니다.
+3. **컬렉션 값 타입 (Collection Value Type)**  
+   - `List`, `Set` 등으로 값 타입을 여러 개 관리합니다(여기서는 생략하고 별도 장에서 다룰 수 있음).
+
+#### 임베디드 타입의 정의와 활용
+임베디드 타입은 `@Embeddable`로 정의된 클래스를 엔티티 내에서 `@Embedded`로 사용합니다. 주로 주소, 기간, 좌표 같은 복합 데이터를 표현할 때 유용합니다.
+
+#### 예시 1: 주소(Address) 임베디드 타입
+```java
+import jakarta.persistence.Embeddable;
+
+@Embeddable
+public class Address {
+    private String city;
+    private String street;
+    private String zipcode;
+
+    // JPA를 위한 기본 생성자
+    public Address() {}
+
+    public Address(String city, String street, String zipcode) {
+        this.city = city;
+        this.street = street;
+        this.zipcode = zipcode;
+    }
+
+    // getter만 제공해 불변성 보장
+    public String getCity() { return city; }
+    public String getStreet() { return street; }
+    public String getZipcode() { return zipcode; }
+}
+```
+
+```java
+import jakarta.persistence.Entity;
+import jakarta.persistence.Id;
+import jakarta.persistence.Embedded;
+
+@Entity
+public class Member {
+    @Id
+    private Long id;
+    private String name;
+
+    @Embedded
+    private Address address;
+
+    public Member() {}
+    public Member(Long id, String name, Address address) {
+        this.id = id;
+        this.name = name;
+        this.address = address;
+    }
+
+    // getter, setter
+    public Long getId() { return id; }
+    public String getName() { return name; }
+    public Address getAddress() { return address; }
+    public void setAddress(Address address) { this.address = address; }
+}
+```
+
+- **테이블 구조**:
+  ```sql
+  CREATE TABLE member (
+      id BIGINT PRIMARY KEY,
+      name VARCHAR(255),
+      city VARCHAR(255),
+      street VARCHAR(255),
+      zipcode VARCHAR(255)
+  );
+  ```
+- **설명**: `Address`는 독립적인 엔티티가 아니라 `Member`에 속한 값 타입입니다. 데이터베이스에서는 `Member` 테이블에 포함되며, 별도 테이블이 생성되지 않습니다.
+
+#### 예시 2: 기간(Period) 임베디드 타입
+```java
+import jakarta.persistence.Embeddable;
+import java.time.LocalDate;
+
+@Embeddable
+public class Period {
+    private LocalDate startDate;
+    private LocalDate endDate;
+
+    public Period() {}
+    public Period(LocalDate startDate, LocalDate endDate) {
+        this.startDate = startDate;
+        this.endDate = endDate;
+    }
+
+    public LocalDate getStartDate() { return startDate; }
+    public LocalDate getEndDate() { return endDate; }
+}
+```
+
+```java
+import jakarta.persistence.Entity;
+import jakarta.persistence.Id;
+import jakarta.persistence.Embedded;
+
+@Entity
+public class Project {
+    @Id
+    private Long id;
+    private String title;
+
+    @Embedded
+    private Period duration;
+
+    public Project() {}
+    public Project(Long id, String title, Period duration) {
+        this.id = id;
+        this.title = title;
+        this.duration = duration;
+    }
+
+    // getter, setter
+}
+```
+
+- **테이블 구조**:
+  ```sql
+  CREATE TABLE project (
+      id BIGINT PRIMARY KEY,
+      title VARCHAR(255),
+      start_date DATE,
+      end_date DATE
+  );
+  ```
+
+#### 임베디드 타입의 장점
+1. **재사용성**: `Address`나 `Period` 같은 타입을 여러 엔티티에서 재사용 가능.
+2. **가독성**: 관련 필드를 논리적으로 묶어 도메인 의미를 명확히 표현.
+3. **불변성**: setter를 제거하고 생성자로만 값을 설정하면 부작용 방지.
+4. **코드 간소화**: 공통 로직(예: 주소 유효성 검사)을 임베디드 타입에 추가 가능.
+
+#### 활용 팁
+- **컬럼명 커스터마이징**: 동일한 임베디드 타입을 여러 번 사용할 경우 충돌을 피하기 위해 `@AttributeOverrides`를 사용합니다.
+  ```java
+  @Entity
+  public class Member {
+      @Id
+      private Long id;
+
+      @Embedded
+      private Address homeAddress;
+
+      @Embedded
+      @AttributeOverrides({
+          @AttributeOverride(name = "city", column = @Column(name = "work_city")),
+          @AttributeOverride(name = "street", column = @Column(name = "work_street")),
+          @AttributeOverride(name = "zipcode", column = @Column(name = "work_zipcode"))
+      })
+      private Address workAddress;
+
+      // 생성자, getter
+  }
+  ```
+  - `homeAddress`와 `workAddress`가 동일 테이블에서 다른 컬럼명으로 매핑됩니다.
+
+- **null 처리**: 임베디드 타입이 `null`이면 모든 필드가 `null`로 저장됩니다. 이를 활용해 선택적 데이터를 표현할 수 있습니다.
+- **비즈니스 로직 추가**: 예를 들어, `Period`에 `isActive()` 메서드를 추가해 현재 날짜가 기간 내인지 확인 가능.
+
+#### 주의사항
+- **생명주기 의존성**: 임베디드 타입은 엔티티에 종속적이므로 독립적으로 저장하거나 조회할 수 없습니다.
+- **불변성 권장**: 값 타입은 변경 시 기존 객체를 교체하는 방식으로 관리해야 부작용을 줄입니다(예: `setAddress(new Address(...))`).
+- **성능 고려**: 임베디드 타입이 지나치게 복잡하면 테이블 구조가 비대해질 수 있으니 적절히 분리합니다.
+
+#### 실무 활용 예시
+주문 엔티티에서 배송 정보와 결제 정보를 임베디드 타입으로 분리:
+```java
+@Embeddable
+public class DeliveryInfo {
+    private String receiver;
+    private String address;
+
+    // 생성자, getter
+}
+
+@Embeddable
+public class PaymentInfo {
+    private String method;
+    private int amount;
+
+    // 생성자, getter
+}
+
+@Entity
+public class Order {
+    @Id
+    private Long id;
+
+    @Embedded
+    private DeliveryInfo delivery;
+
+    @Embedded
+    private PaymentInfo payment;
+
+    // 생성자, getter
+}
+```
+
+---
+
+값 타입과 임베디드 타입은 JPA에서 도메인 모델을 풍부하게 만들고, 객체지향 설계를 데이터베이스에 효과적으로 반영하는 도구입니다. 이를 활용하면 코드의 응집도를 높이고 유지보수성을 강화할 수 있습니다. 다음 장에서는 성능 최적화와 관련된 주제를 다뤄보겠습니다.
+
+---
+
+책의 흐름에 맞는지, 추가 예시나 수정이 필요하면 말씀해 주세요!