[Spring Boot JPA 게시판 만들기] 3. Entity 생성

간단한 게시판을 만들기 위해서 Board라는 Entity 클래스를 만들어 주겠습니다. JPA를 사용하면 데이터베이스의 구조를 자바의 클래스로 표현해 줄 수 있습니다. 이를 ORM이라고 하는데, ORM은 Object Relational Mapping의 약자입니다. 자바의 객체와 관계형 데이터베이스를 매핑하는 기술을 말합니다. JPA는 ORM을 사용할 수 있도록 인터페이스를 제공합니다. 

 

 공통으로 사용하는 Entity

 

데이터베이스 설계를 하다보면 공통적으로 자주 사용하는 컬럼들이 있습니다. 예를 들어 생성일과 수정일 등이 있습니다. 클래스 정의할 때 마다 매번 정의 하지 않고 공통 Entity 클래스로 만들어 사용할 수 있어요. 먼저 BaseTime이라는 클래스를 생성해 봅시다!

 

import lombok.Getter;
import jakarta.persistence.Column;
import jakarta.persistence.EntityListeners;
import jakarta.persistence.MappedSuperclass;
import org.springframework.data.annotation.CreatedDate;
import org.springframework.data.annotation.LastModifiedDate;
import org.springframework.data.jpa.domain.support.AuditingEntityListener;

import java.time.LocalDateTime;

@Getter
@MappedSuperclass
@EntityListeners(value = AuditingEntityListener.class)
public abstract class BaseTime {
    @CreatedDate
    @Column(updatable = false)
    private LocalDateTime createdDate;

    @LastModifiedDate
    private LocalDateTime modifiedDate;
}

 

생성일, 수정일 자동 채움

@EntityListeners(value = AuditingEntityListener.class)를 사용하면 JPA에서 자동으로 그 값을 채워 줍니다. 생성일에는 @CreatedDate 애너테이션을 명시해 주고, 수정일에는 @LastModifiedDate로 설정해 주세요. 생성일의 경우 한번 설정되고 난뒤 수정되지 않으므로 Column의 uptable를 false로 설정해 줍니다. 

 

 

처음 Entity 객체가 생성되고 데이터베이스에 저장되면 created_date, modified_date는 동일한 날짜와 시간을 가질거에요. 이후에 값이 변경되면 개발자가 따로 값을 업데이트하는 로직을 작성하지 않아도 JPA에서 자동으로 modified_date를 수정해 줍니다. 

첫번째 줄을 보면 created_date와 modified_date가 다른 것을 볼 수 있는데, 생성 후 수정했고 자동으로 업데이트 된 시간을 기록합니다. 

 

 Board Entity 생성

 

board 테이블과 매핑하기 위한 Board라는 Entity class를 생성해 주도록 하겠습니다.

 

import jakarta.persistence.Entity;
import jakarta.persistence.Id;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.AccessLevel;
import lombok.Builder;

 

임포트해야 하는 라이브러리입니다.

 

@Entity
@Getter
@NoArgsConstructor(access = AccessLevel.PROTECTED)
public class Board extends BaseTime {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String title;
    private String content;
    private String author;

    @Builder
    public Board(String title, String content, String author) {
        this.title = title;
        this.content = content;
        this.author = author;
    }

    public void updateBoard(String title, String content) {
        this.title = title;
        this.content = content;
    }
}

 

@Entity에 따로 테이블 이름을 명시하지 않으면 클래스의 이름으로 자동 매핑 됩니다. 

@NoArgsConstructor(access = AccessLevel.PROTECTED)를 사용하면 매개변수가 없는 생성자를 사용할 수 없습니다. 

Board myBoard = new Board(); // 사용불가

 

매개변수가 없는 기본 생성자가 protected 레벨로 지정되어 외부에서 해당 생성자로 인스턴스를 만들 수 없도록 지정합니다. 

 

@Setter 없이 @Getter만 지정한 이유는 id와 같이 직접 지정하지 않아야 하는 필드도 접근하여 값을 지정할 수 있기 때문입니다. Getter만 사용하고

    @Builder
    public Board(String title, String content, String author) {
        this.title = title;
        this.content = content;
        this.author = author;
    }

 

롬복의 @Builder를 사용해서 값을 직접 지정할 수 있는 값만 변경 가능하도록 지정해 줍니다

 

        Board board = Board.builder()
                .title(title)
                .content(content)
                .author(author)
                .build();

 

사용할 때는 롬복의 builder로 값을 지정해 줄 수 있고, @Builder로 설정하지 않는 파라미터에 대해서는 접근하여 값을 지정할 수 없습니다. 

 

 마치며

 

다음 포스팅에서는 리스트를 조회하는 법에 대해서 알아보겠습니다 🙌