Ahead of Time Support for Tests

This chapter covers Spring’s Ahead of Time (AOT) support for integration tests using the Spring TestContext Framework.

The testing support extends Spring’s core AOT support with the following features.

• Build-time detection of all integration tests in the current project that use the TestContext framework to load an ApplicationContext.
  • Provides explicit support for test classes based on JUnit Jupiter and JUnit 4 as well as implicit support for TestNG and other testing frameworks that use Spring’s core testing annotations — as long as the tests are run using a JUnit Platform TestEngine that is registered for the current project.
• Build-time AOT processing: each unique test ApplicationContext in the current project will be refreshed for AOT processing.
• Runtime AOT support: when executing in AOT runtime mode, a Spring integration test will use an AOT-optimized ApplicationContext that participates transparently with the context cache.

All tests are enabled in AOT mode by default. However, you can selectively disable an entire test class or individual test method in AOT mode by annotating it with @DisabledInAotMode. When using JUnit Jupiter, you may selectively enable or disable tests in a GraalVM native image via Jupiter’s @EnabledInNativeImage and @DisabledInNativeImage annotations.

Note that @DisabledInAotMode also disables the annotated test class or test method when running within a GraalVM native image, analogous to JUnit Jupiter’s @DisabledInNativeImage annotation.

기본적으로 빌드 타임 AOT 처리 중에 오류가 발생하면 예외가 던져지고 전체 프로세스가 즉시 실패합니다. 오류가 발생한 이후에도 빌드 타임 AOT 처리가 계속되기를 원한다면, failOnError 모드를 비활성화할 수 있으며, 이 경우 오류는 WARN 레벨로 로깅되거나 DEBUG 레벨에서 더 상세하게 로깅됩니다. failOnError 모드는 JVM 시스템 프로퍼티인 spring.test.aot.processing.failOnError를 false로 설정하여 커맨드 라인이나 빌드 스크립트에서 비활성화할 수 있습니다. 대안으로, 동일한 프로퍼티를 SpringProperties 메커니즘을 통해 설정할 수 있습니다.

JPA의 @PersistenceContext와 @PersistenceUnit 어노테이션은 AOT 모드에서 테스트 클래스 내에서 의존성 주입을 수행하는 데 사용할 수 없습니다. 그러나 Spring Framework 7.0부터는 EntityManager 또는 EntityManagerFactory를 테스트에 주입할 때 각각 @PersistenceContext와 @PersistenceUnit 대신 @Autowired를 사용할 수 있습니다.

@ContextHierarchy 어노테이션은 AOT 모드에서 지원되지 않습니다.

To provide test-specific runtime hints for use within a GraalVM native image, you have the following options.

• Implement a custom TestRuntimeHintsRegistrar and register it globally via META-INF/spring/aot.factories.
• Implement a custom RuntimeHintsRegistrar and register it globally via META-INF/spring/aot.factories or locally on a test class via @ImportRuntimeHints.
• Annotate a test class with @Reflective or @RegisterReflectionForBinding.
• See Runtime Hints for details on Spring’s core runtime hints and annotation support.

TestRuntimeHintsRegistrar API는 코어 RuntimeHintsRegistrar API의 컴패니언 역할을 합니다. 특정 테스트 클래스에 특화되지 않은 테스트 지원을 위한 글로벌 힌트를 등록해야 한다면, 테스트 전용 API보다 RuntimeHintsRegistrar 구현을 선호해야 합니다.

If you implement a custom ContextLoader, it must implement AotContextLoader in order to provide AOT 빌드 타임 처리 and AOT 런타임 실행 지원.

Note, however, that all context loader implementations provided by the Spring Framework and Spring Boot already implement AotContextLoader.

If you implement a custom TestExecutionListener, it must implement AotTestExecutionListener in order to participate in AOT processing. See the SqlScriptsTestExecutionListener in the spring-test module for an example.