[JPA] 엔티티 매핑

이 글은 인프런의 김영한 강사님 자바 ORM 표준 JPA 프로그래밍-기본 편 강의 내용을 바탕으로 작성되었습니다.

자바 ORM 표준 JPA 프로그래밍 - 기본편 - 인프런 | 강의

@Entity

• JPA가 관리하는 엔티티
• name옵션을 사용하면 테이블 이름으로 매핑할수 있음

@Entity(name = "Member1")			//매핑할 테이블 이름
public class Member {}

• catalog : 데이터베이스 catalog 매핑
• schema : 데이터베이서 schema 매핑
• uniqueConstraints : DDL 생성 시 유니크 제약 조건 생성

 

데이터베이스 스키마 자동 생성

• 어플리케이션이 실행되는 시점에 자동 생성
• 데이터베이스 방언을 활용해서 데이터베이스에 맞는 적절한 DDL 생성
• 보통은 로컬 서버에서만 활용함(개발서버, 운영서버에서는 주로 활용을 하지 않음)
• 속성
  • create : 기존테이블 삭제 후 다시 생성 (drop and create)
  • create-drop : create와 같으나 종료시점에 테이블 drop
  • update : 변경분만 반영(운영db에는 사용하면 안됨)
  • validate : 엔티티와 테이블이 정상 매핑되었는지만 확인
  • none : 사용하지 않음

매핑 어노테이션 정리

• @Column : 컬럼 매핑
• @Temporal : 날짜 타입 매핑
• @Enumerated : enum 타입 매핑
• @Lob : BLOB, CLOB 매핑
• @Transient : 특정 필드 컬럼에 매핑하지 않음

    @Column(name = "name")
    private String username;

    @Enumerated(EnumType.ORDINAL)
    private RoleType roleType;

    @Temporal(TemporalType.TIMESTAMP)
    private Date createdDate;
    
    @Lob
    private String description;

 

@Column

• name : 필드와 매핑할 테이브의 컬럼 이름

    @Column(name = "name")
    private String username;

• insertable, updateble : 등록, 변경 가능 여부

      @Column(name = "name", insertable = true, updatable = true)
      private String username;									
      // insertable와 updateable이 true 면 등록 수정이 가능함
      // false 라면 등록 수정이 불가능함

• nullable(DDL) : null 값의 허용 여부를 설정한다. false로 설정하면 DDL 생성 시에 not null 제약조건이 붙는다.

    @Column(name = "name", nullable = false)        //not null
    private String username;

• unique : 데이터가 유니크에 제약 조건을 걸때 사용한다

      @Column(name = "name", unique = true)       //유니크 제약 조건을 걸때
      private String username;

• columnDefinition : 데이터베이스 컬럼 정보를 직접 줄 수 있다

      @Column(name = "name", columnDefinition = "varchar(100) default 'EMPTY'") //컬럼 정보를 줄때
      private String username;

• length : 문자 길이 제약조건, String 타입에만 사용한다.

    @Column(length = 20) 
    private String username;
    //varchar(20)

• percision,scale

@Enumerated

• ORDINAL

    @Enumerated(EnumType.ORDINAL) 
    private RoleType roleType;
    //RoleType 클래스에 USER, ADMIN 이런식으로 되어있다면 DB에 저장할때 순서로 저장함
    //예를들어 roleType에 USER로 저장한다면 0, ADMIN으로 저장한다면 1로 저장이 됨

• STRING

    @Enumerated(EnumType.STRING) 
    private RoleType roleType;

 

기본 키 매핑

• IDENTITY : 데이터베이스에 위임, MYSQL

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

• SEQUENCE : 데이터베이스 시퀀스 오브젝트 사용, ORACLE (@SequenceGenerator 필요)
  
  • name : 식별자 생성기 이름 (기본값 필수)
  • sequenceName : 데이터베이스에 등록되어 있는 시퀀스 이름 (기본값 : hibernate_sequence)
  • initalValue : DDL생성 시에서만 사용됨, 시퀀스 DDL을 생성할 때 처음 1 시작하는 수를 지정한다 (기본값 :1)
  • allocationSize: 시퀀스 한 번 호출에 증가하는 수(성능 최적화에 사용됨 데이터베이스 시퀀스 값이 하나씩 증가하도록 설정되어 있으면 이 값을 반드시 1로 설정해야 한다 (기본값 : 50)
  • catalog, schema : 데이터베이스 catalog, schema 이름

@Entity 	//매핑할 데이터베이스 시퀀스 이름
@SequenceGenerator(name = “MEMBER_SEQ_GENERATOR",sequenceName = “MEMBER_SEQ",
				   initialValue = 1, allocationSize = 1)
public class Member {
@Id
@GeneratedValue(strategy = GenerationType.SEQUENCE,generator = "MEMBER_SEQ_GENERATOR")
private Long id;

• TABLE : 키 생성용 테이블 사용, 모든 DB에서 사용 (@TableGenerator 필요)
  • 키 생성 전용 테이블을 하나 만들어서 데이터베이스 시퀀스를 흉내내는 전략
  • 장점 : 모든 데이터베이스 적용 가능
  • 단점 : 성능
  • 속성
    • name : 식별자 생성기 이름 - 필수
    • table : 키생성 테이블명 - hibernate_sequences
    • pkColumnName : 시퀀스 컬럼명 - sequence_name
    • valueColumnNa : 시퀀스 값 컬럼명 - next_val 
    • pkColumnValue : 키로 사용할 값 이름 - 엔티티 이름
    • initialValue : 초기 값, 마지막으로 생성된 값이 기준이다. - 0
    • allocationSize : 시퀀스 한 번 호출에 증가하는 수(성능 최적화에 사용됨) - 50
    • catalog, schema : 데이터베이스 catalog, schema 이름
    • uniqueConstraints(DDL) : 유니크 제약 조건을 지정할 수 있다.

@Entity
@TableGenerator(name = "MEMBER_SEQ_GENERATOR",table = "MY_SEQUENCES",
				pkColumnValue = “MEMBER_SEQ", allocationSize = 1)
public class Member {
        @Id
        @GeneratedValue(strategy = GenerationType.TABLE,
                        generator = "MEMBER_SEQ_GENERATOR")
        private Long id;

 

create table MY_SEQUENCES (
sequence_name varchar(255) not null,
next_val bigint,
primary key ( sequence_name )
)

• AUTO : 방언에 따라 자동 지정, 기본 값

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