Spring Boot 4

1.8.0에서 사용할 수 있습니다. Spring Boot 통합은 starter와 별도로 게시된 auto-configuration 모듈, 두 artifact로 Maven Central에 게시되어 있습니다.

의존성

Java 21 이상에서 실행되는 Spring Boot 4.0.6 애플리케이션에 r2d1-spring-boot-starter artifact를 추가합니다:

dependencies {
    implementation("dev.nexcraft:r2d1-spring-boot-starter:1.8.0")
}

starter는 별도로 게시된 r2d1-spring-boot-autoconfigure 모듈에 의존합니다. 일반 애플리케이션에는 starter를 사용하고, custom starter를 구성할 때는 auto-configuration 모듈을 직접 사용하세요.

구성하는 항목

통합을 활성화하려면 r2d1.enabled=true을 설정하세요. 이 구성은 R2 또는 filesystem 문서 저장소와 D1 또는 JDBC 인덱싱을 지원하면서 framework-neutral R2D1 collection API를 유지합니다.

JDBC는 기본적으로 platform-thread 실행을 사용합니다. Java 25 runtime에서만 virtual-thread 실행을 명시적으로 선택하세요. 통합은 이전 runtime에 대한 fallback을 제공하지 않습니다.

리소스 소유권

애플리케이션의 DataSource, Executor, S3AsyncClient, 와 HttpClient bean은 이름으로 선택되거나 유일한 bean 또는 @Primary bean인 경우 재사용됩니다. 애플리케이션 소유 resource는 통합이 닫지 않습니다. 통합이 생성한 resource는 관리 bean과 함께 닫힙니다.

범위

Spring Data repository, transaction, AOP, controller, retry 및 compensation policy, R2DBC, server lifecycle, connection-pool management는 이 모듈의 범위 밖입니다. 구체적인 Spring AOT 요구사항이 검증되기 전까지 native-image hint는 포함하지 않습니다.