[JPA] 값 타입

✅ JPA 값 타입 분류와 특징

• 엔티티 타입
  • @Entity로 정의하는 객체
  • 데이터가 변해도 식별자로 지속해서 추적 가능
  • ex) 회원 엔티티의 키나 나이 값을 변경해도 식별자로 인식 가능

• 값 타입
  • int, Integer, String 처럼 단순히 값으로 사용하는 자바 기본 타입이나 객체
  • 식별자가 없고 값만 있으므로 변경 시 추적 불가
  • 생명 주기를 엔티티에 의존
  • 공유하지 않고, 복사해서 사용해야 한다
  • 불변 객체로 만들어 사용하는 것이 좋다

✅ 임베디드 타입(embedded type, 복합 값 타입)

• 새로운 값 타입을 직접 정의할 수 있다.

• JPA는 임베디드 타입(embedded type)이라고 한다.

• 주로 기본 값 타입을 모아서 만들어서 복합 값 타입이라고도 한다.

• int, String과 같은 값타입이다. 추적도 되지 않고 변경하면 다른값으로 대체된다.

• 기존 Member Class

  @Entity
  public class Member extends BaseEntity {
  
      @Id @GeneratedValue
      @Column(name = "MEMBER_ID")
      private Long id;
  
      private String name;
  		
  		// 근무 기간		
  		@temporal(TemporalType.DATE) Date startDate;
  		@temporal(TemporalType.DATE) Date endDate;
  
  		// 집 주소
      private String city;
      private String street;
      private String zipcode;
  
      @OneToMany(mappedBy = "member")
      private List<Order> orders = new ArrayList<Order>();

  위 Member Entity를 설명하면 아래와 같을 것이다.

  "회원 엔티티는 이름, [근무 시작일, 근무 종료일], [주소 도시, 주소 동호수, 우편 번호]를 가진다."

이는 단순히 정보를 풀어서 설명한 것이다. 최종적으로 회원은 위와 같이 상세한 데이터를 가지게 되는 것은 맞지만 객체지향적이진 않다. [ ]를 기준으로 근무기간과 주소 같은 타입이 있다면 코드가 더 명확해지고 응집력도 높일 수 있다.

"회원 엔티티는 이름, [ 근무 기간 ], [ 집 주소 ]를 가진다."

🤖 코드

• @Embeddable : 값 타입을 정의하는 곳에 표시

• @Embedded : 값 타입을 사용하는 곳에 표시

• 기본 생성자 필수

• Member

  @Entity
  public class Member {
  
      @Id @GeneratedValue
      @Column(name = "MEMBER_ID")
      private Long id;
  
      private String name;
  
      @Embedded
      private Address address;
      
      @Embedded
      private Period workPeriod;

• Address

  @Embeddable
  public class Address {
  
      private String city;
      private String street;
      private String zipcode;
  
      public Address() {}
  
  		//... getter, setter ...//

• Period

  @Embeddable
  public class Period {
  
      @Temporal(TemporalType.DATE)
      Date startDate;
  
      @Temporal(TemporalType.DATE)
      Date endDate;
      
      public Period(){}
  
  		//... getter, setter ...//

  

  

  

  기간칼럼 2개와 주소칼럼 3개를 하나로 묶고 각각 Period, Address 값 타입으로 생성한다. Member 엔티티가 가지고 있던 많은 칼럼들이 임베디드 값 타입으로 인해 굉장히 간단해졌다. 특징은, 임베디드 값 타입의 칼럼들은 새로운 엔티티가 아니라, 일반적인 int, String 타입처럼 기본 값 타입으로 Member 테이블에 그대로 칼럼으로 들어있다는 것이다.

  ➡️ 엔티티와 테이블을 함께 보면 아래와 같다.

  

  임베디드 타입은 엔티티의 “값”일 뿐이다. 임베디드 타입을 사용하기 전과 후에 매핑하는 테이블의 컬럼이 동일한 것을 확인할 수 있다.

🔹같은 값 타입을 여러 개 넣고 싶은 경우(@AttribteOverrides)

같은 값 타입이 2개 이상이면, 컬럼명이 중복되어 충돌이 날 것이다. 예를 들자면 현재 임베디드 값타입으로 주소가 들어가 있는데, 집, 회사 주소 이렇게 2개가 있을 수 있다. 이때 @AttribteOverrides를 사용한다. 속성을 재정의한다. name에는 기존 값 타입의 칼럼명을, column에는 내가 원하는 새로운 칼럼명을 적는다.

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


@Embedded
@AttributeOverrides({
        @AttributeOverride(name ="city", column = @Column(name = "home_city")),
        @AttributeOverride(name ="street", column = @Column(name = "home_street")),
        @AttributeOverride(name ="zipcode", column = @Column(name = "home_zipcode"))
})
private Address homeAddress;

❗주의할 점

임베디드 타입은 자바의 기본 타입이 아니라 "객체 타입"이다. 따라서, getter, setter로 값을 바꾸는 순간 해당 객체를 참조하고 있던 엔티티의 모든 필드 값이 변경된다. 그래서 임베디드 값 객체 칼럼들을 하나하나 "복사"해서 새로운 객체를 생성해 값을 넣어주어야 한다.

• 부작용 확인

  public static void valueTypeCopyTest(EntityManager em) {
      // 주소1
      Address address = new Address("1000", "zip", "Street");
  
      // 회원1
      Member member1 = new Member();
      member1.setName("member1");
      member1.setHomeAddress(address);
      em.persist(member1);
  
      // 회원2
      Member member2 = new Member();
      member2.setName("member2");
      member2.setHomeAddress(address);
      em.persist(member2);
  
      // 회원1의 주소만 변경하고 싶어서 getter, setter을 사용
      member1.getHomeAddress().setCity("homeCity");
  }

  

  member1의 HOME_CITY만 homeCity로 바꾸고 싶었는데, member2의 HOME_CITY까지도 같이 바뀌어버렸다. 임베디드 값 타입이 같은 값 타입은 여러 엔티티에서 공유하면 참조하는 모든 대상의 값을 변경하는 위험이 있다. 따라서, 대신 값을 "복사"해서 사용해야 한다.

• 새로운 임베디드 값 객체를 만들어서 대입

  public static void valueTypeCopy(EntityManager em) {
      // 주소1
      Address address = new Address("city", "zip", "Street");
  
      // 회원1
      Member member1 = new Member();
      member1.setName("member1");
      member1.setHomeAddress(address);
      em.persist(member1);
  
      // 생성자를 통한 주소1 복사
      Address newAddress = new Address(address.getCity(), address.getStreet(), address.getZipcode());
  
      // 회원2
      Member member2 = new Member();
      member2.setName("member2");
      member2.setHomeAddress(newAddress);
      em.persist(member2);
  
      member1.getHomeAddress().setCity("homeCity");
  }

  

  하지만, 누군가가 실수로 getter, setter를 사용할 수도 있다. 따라서 생성시점 이후 절대 값을 변경할 수 없는 불변객체로 만드는 것이다. 방법은, 생성자로만 값을 설정하고 Setter를 만들지 않는다. (참고로, Integer, String은 자바가 제공하는 대표적인 불변객체이다.)

✅ 컬렉션 값 타입(collection value type)

컬렉션 값 타입은 Lists, Set 같은 타입으로, 값 타입을 하나 이상 저장할 때 사용한다. List, Set같은 컬렉션은 한 테이블 안에 저장할 수 있는 방법이 존재하지 않는다. 따라서, 1:N으로 풀어서 별도의 테이블을 만들어야 한다. 즉, 컬렉션 칼럼은 별도의 테이블로 분리해야 한다.

• 코드

  @Entity
  public class Member {
      @Id
      @GeneratedValue
      private Long id;
  
      private String name;
  
      private int age;
  
      @Embedded
      private Period workPeriod;
  
      @Embedded
      private Address homeAddress;
  
      @ElementCollection
      @CollectionTable(name = "favorite_food", joinColumns = @JoinColumn(name = "member_id"))
      private Set<String> favoriteFoods = new HashSet<>();
  
      @ElementCollection
      @CollectionTable(name = "address", joinColumns = @JoinColumn(name = "member_id"))
      private List<Address> addressHistory = new ArrayList<>();
  }

  

Member를 @JoinColumn으로 지정하여 외래키를 가지며 1: N 관계처럼 생각할 수 있다. 단, 각 컬렉션 타입의 칼럼들은 모두 PK이다. 따라서, 해당 테이블 칼럼의 전체를 비교해서 중복을 허용하지 않는다.

---

🏷️이미지 출처 및 참고한 사이트

Hibernate Types and Entity vs Value Types

In this guide we are going to discuss about Hibernate types and what are the distinguish between Hibernate Entity types and Value types.

Uploaded by N2T