llm-wiki/raw/official-docs/spring-data-jpa-enable-jpa-auditing-api.md

title, source_type, url, archive_url, related_branches, related_projects, tags, created

title	source_type	url	archive_url	related_branches	related_projects	tags	created
official-doc / Spring Data JPA — @EnableJpaAuditing API Reference	official-doc	https://docs.spring.io/spring-data/jpa/docs/current/api/org/springframework/data/jpa/repository/config/EnableJpaAuditing.html		feature-persistence-auditing-contract		official-doc ca-tmpl persistence spring-data spring-boot	2026-06-10

official-doc / Spring Data JPA — @EnableJpaAuditing API Reference

Layer: raw/ — 외부 자료(공식 문서 / 대기업 기술 블로그)의 원문 발췌·출처 기록. 검증된 요약은 /ingest 후 wiki/concepts/에 source-summary-template 형식으로 별도 작성. 원본은 raw에 영구 보관.

Parent / 활용 branch

Branch	이 자료가 정당화하는 결정
raw/branch-notes/feature-persistence-auditing-contract	D4: audit timestamp 의 time-source 를 프로젝트의 injectable Clock bean 으로 고정 — dateTimeProviderRef 가 custom DateTimeProvider bean 을 가리키고, 그 bean 이 Clock 을 wrap 한다

출처 / Source

• 원본 URL: https://docs.spring.io/spring-data/jpa/docs/current/api/org/springframework/data/jpa/repository/config/EnableJpaAuditing.html
• 아카이브 URL: (미제공)
• 저자 / 조직: Thomas Darimont, Oliver Gierke, Greg Turnquist / Spring Data JPA (VMware / Broadcom)
• 발행일: (현재 버전 API 문서 — 버전 고정 URL 아님)
• 마지막 확인일: 2026-06-10

왜 저장했는지 / Why archived

@EnableJpaAuditing 의 dateTimeProviderRef 속성이 custom DateTimeProvider bean 이름을 받아 TemporalAccessor 시간 소스를 교체할 수 있음을 공식 API 문서로 확인. 이는 Clock bean 으로 시간 소스를 고정하는 D4 결정의 직접 근거. auditorAwareRef, modifyOnCreate, setDates 속성도 함께 포착해 동일 브랜치의 auditor 및 타임스탬프 설정 결정에 활용.

핵심 인용 / Key quotes (verbatim, 3~5문장)

[annotation-level] "@EnableJpaAuditing is an annotation to enable auditing in JPA via annotation configuration."

[§dateTimeProviderRef] "Configures a DateTimeProvider bean name that allows customizing the TemporalAccessor to be used for setting creation and modification dates."

[§auditorAwareRef] "Configures the AuditorAware bean to be used to lookup the current principal."

[§modifyOnCreate] "Configures whether the entity shall be marked as modified on creation. Defaults to true."

[§setDates] "Configures whether the creation and modification dates are set. Defaults to true."

Claims Extracted / 추출된 주장

Claim ID	Claim (이 자료가 직접 말하는 것)	Evidence quote	Strength	Applies to	Does not prove
C1	@EnableJpaAuditing 의 dateTimeProviderRef 속성은 DateTimeProvider bean 이름을 받아 creation/modification 날짜 기록에 사용할 TemporalAccessor 를 커스터마이징할 수 있다	[§dateTimeProviderRef] "Configures a DateTimeProvider bean name that allows customizing the TemporalAccessor to be used for setting creation and modification dates."	official-reference	Spring Data JPA 감사(auditing) 활성화 시 시간 소스를 교체해야 하는 모든 경우	DateTimeProvider 구현 내에서 Clock 을 inject 하는 방법 자체는 증명하지 않음; Clock 기반 구현이 올바른지는 별도 검증 필요
C2	auditorAwareRef 속성은 현재 principal 을 조회하기 위한 AuditorAware bean 이름을 설정한다	[§auditorAwareRef] "Configures the AuditorAware bean to be used to lookup the current principal."	official-reference	@CreatedBy / @LastModifiedBy 필드 자동 기록이 필요한 경우	AuditorAware 구현이 어떤 방식으로 principal 을 resolve 해야 하는지는 증명하지 않음
C3	modifyOnCreate 는 기본값 true 로, entity 생성 시 수정 필드도 함께 기록된다	[§modifyOnCreate] "Configures whether the entity shall be marked as modified on creation. Defaults to true."	official-reference	@LastModifiedDate / @LastModifiedBy 가 entity 최초 저장 시에도 채워져야 하는 경우	false 로 설정 시의 정확한 동작 범위 (Hibernate dirty-check 상호작용 등) 는 본 문서만으로 증명 불가
C4	setDates 는 기본값 true 로, creation/modification 날짜 자동 기록이 활성화되어 있다	[§setDates] "Configures whether the creation and modification dates are set. Defaults to true."	official-reference	@CreatedDate / @LastModifiedDate 동작 제어가 필요한 모든 경우	false 로 설정 시 auditorAwareRef 동작에 미치는 영향은 증명하지 않음

Strength 허용값

• official-reference — 공식 reference/API 문서 (본 문서 해당)

Usage Boundaries / 적용 경계

• 이 자료가 직접 증명하는 것:
  • C1: dateTimeProviderRef 속성 존재 + DateTimeProvider bean name 을 받는다는 계약
  • C2: auditorAwareRef 속성 존재 + AuditorAware bean name 을 받는다는 계약
  • C3: modifyOnCreate 기본값 true
  • C4: setDates 기본값 true
• 이 자료가 증명하지 않는 것:
  • DateTimeProvider 구현 내부에서 Clock 을 사용하는 방법
  • @EnableJpaAuditing 이 없을 경우 @CreatedDate 어노테이션이 무시되는지 여부
  • Spring Boot auto-configuration 이 @EnableJpaAuditing 을 자동 등록하는지 여부 (별도 auto-config 문서 확인 필요)
• 내 프로젝트에 적용하려면 추가 확인이 필요한 것:
  • ca-tmpl 에서 ClockDateTimeProvider implements DateTimeProvider 구현 및 @Bean 등록 후 동작 검증
  • dateTimeProviderRef = "clockDateTimeProvider" 바인딩이 Spring context 로드 시 오류 없이 연결되는지 통합 테스트

메모 / Notes

• 이 페이지는 API Javadoc 페이지이므로 prose 설명이 짧다. attribute 당 한 줄 description + default value 가 전부.
• String dateTimeProviderRef 의 default 는 "" (empty string = 커스텀 빈 미설정, 기본 시스템 시간 사용).
• String auditorAwareRef 의 default 도 "" (미설정 시 @CreatedBy/@LastModifiedBy 미기록).
• 추가로 봐야 할 동일 출처 페이지: DateTimeProvider 인터페이스 Javadoc, AuditorAware 인터페이스 Javadoc.

Related / 관련

• raw/official-docs/at-transactional-spring-official — Spring @Transactional 공식 문서 (persistence 영역 관련)
• 같은 브랜치의 다른 근거 자료: raw/branch-notes/feature-persistence-auditing-contract 의 Sources 표 참조