[JPA] BaseEntity로 공통 엔티티 속성 추상화하기

🤔 시간과 같은 공통 엔티티 속성을 효율적으로 관리하는 방법은 없을까?

엔티티를 작성하다 보면 중복되는 코드가 자주 등장한다.
대표적인 예로 등록된 시간(createdAt), 수정된 시간(updatedAt) 과 같은 필드가 있다.

이 필드는 거의 모든 엔티티에 필요하지만,
매번 같은 코드를 반복해서 작성하는 것은 불필요하고 유지보수에도 좋지 않다.

그렇다면 이 시간 관련 속성을 효율적으로 추상화할 수는 없을까?
그리고 한 번 만들어두면 자동으로 관리되게 할 수 있을까?

---

💡 추상 클래스 BaseEntity로 공통 필드 추상화하기

이를 해결하기 위한 가장 좋은 방법은 공통 속성을 관리하는 추상 클래스(BaseEntity)를 두는 것이다.
JPA의 @MappedSuperclass와 스프링 데이터 JPA의 Auditing 기능을 함께 사용하면,
생성 시간과 수정 시간을 자동으로 관리할 수 있다.

@MappedSuperclass
@EntityListeners(AuditingEntityListener.class)
@Slf4j
public abstract class BaseEntity {

	@CreatedDate
	@Column(updatable = false)
	private LocalDateTime createdAt;

	@LastModifiedDate
	private LocalDateTime updatedAt;

	@PrePersist
	public void beforeInsert() {
		log.info("[PrePersist] 저장 직전! createdAt={}, updatedAt={}", createdAt, updatedAt);
	}

	@PreUpdate
	public void beforeUpdate() {
		log.info("[PreUpdate] 수정 직전! updatedAt={}", updatedAt);
	}
}

@Entity
public class Member extends BaseEntity {

	@Id
	private String name;
	private String address;
	private String phone;

	// 생성자
	public Member(String name, String address, String phone) {
		this.name = name;
		this.address = address;
		this.phone = phone;
	}
	public Member() {}

	void updatePhoneNumber(String phoneNumber) {
		this.phone = phoneNumber;
	}
}

🔹 @MappedSuperclass

• 해당 클래스는 테이블로 직접 매핑되지 않는다.
• 하위 엔티티(Member, Order, Post 등)가 상속받으면
  createdAt, updatedAt 필드가 그 엔티티의 테이블 컬럼으로 포함된다.
• 즉, DB에 BaseEntity 테이블은 생성되지 않는다.

 

🔹 @EntityListeners(AuditingEntityListener.class)

• JPA의 엔티티 이벤트 감지 기능을 활성화한다.
• 스프링 데이터 JPA의 AuditingEntityListener가 엔티티의 저장/수정 이벤트를 감지하여
  @CreatedDate, @LastModifiedDate에 자동으로 값을 넣어준다.

📍 이 기능이 동작하려면 프로젝트 내에 반드시 아래 설정이 필요하다.

@Configuration
@EnableJpaAuditing
public class JpaConfig {}

or

@SpringBootApplication
@EnableJpaAuditing
public class DemoApplication {

 

🔹 @CreatedDate, @LastModifiedDate

• 엔티티의 생성일과 수정일을 자동으로 기록하는 어노테이션.
• @CreatedDate → 엔티티 최초 저장 시 한 번만 자동 입력
• @LastModifiedDate → 엔티티가 수정될 때마다 자동 갱신

🔹 @PrePersist, @PreUpdate

• JPA의 엔티티 생명주기 콜백(Lifecycle Callback) 어노테이션이다.
• 각각 INSERT 실행 직전, UPDATE 실행 직전에 호출된다.
• 이 예제에서는 단순히 로그를 찍지만,
  실제로는 특정 값 초기화나 커스텀 로직을 추가할 수도 있다.

---

🤩 실제 실행 로그로 보는 동작 과정

 

1️⃣  Hibernate: select ... from member where m1_0.name=?
2️⃣  [PrePersist] 저장 직전! createdAt=2025-11-06T16:13:19.266154, updatedAt=2025-11-06T16:13:19.266154
3️⃣  Hibernate: insert into member (address, created_at, phone, updated_at, name) values (?, ?, ?, ?, ?)

1️⃣  Hibernate: select ... from member where m1_0.name=?
2️⃣  [PreUpdate] 수정 직전! updatedAt=2025-11-06T16:13:21.879723
3️⃣  Hibernate: update member set address=?, phone=?, updated_at=? where name=?

 

실제 코드를 동작시켜보면 다음과 같은 결과가 나온다.

 

즉, 매번 엔티티를 건드릴 때마다 시간에 대한 설정을 해줘야하는 것이 아닌 JPA가 자동으로 설정을 하게 해주는 것이다.

 

그 외 다양한 시점에 JPA를 조작해야할 일이 있다면 아래 글을 참고하자.

https://to-travel-coding.tistory.com/463

[JPA]JPA Entity 생명주기(Entity LifeCycle)