All Implemented Interfaces and Traits:

java.lang.annotation.Annotation

@java.lang.annotation.Retention(value: RetentionPolicy.RUNTIME)
@java.lang.annotation.Target(value: [ElementType.TYPE, ElementType.METHOD])
@interface DatabaseCleanup

Annotation to indicate that database tables should be truncated after test execution.

When applied at the class level, all test methods in the specification will have their database cleaned up after each test and after the spec completes. When applied at the method level, only the annotated test methods will trigger cleanup.

The optional value() attribute specifies which datasource bean names to clean and optionally which database type (cleaner) to use. Each entry can be:

• "datasourceName" — clean the named datasource, auto-discovering the appropriate DatabaseCleaner via DatabaseCleaner.supports
• "datasourceName:databaseType" — clean the named datasource using the DatabaseCleaner that declares the specified DatabaseCleaner.databaseType

If the value is empty (the default), all datasources in the application context will be cleaned using auto-discovery.

The resolver() attribute allows users to specify a custom ApplicationContextResolver implementation for tests that store the org.springframework.context.ApplicationContext in a non-standard location. The default resolver, DefaultApplicationContextResolver, covers the common cases (Groovy property, field reflection, and Spring TestContextManager).

Example usage:

 // Clean all datasources after every test (auto-discover cleaners)
 @DatabaseCleanup
 class MySpec extends Specification { ... }

 // Clean only specific datasources (auto-discover cleaners)
 @DatabaseCleanup(['dataSource', 'dataSource_secondary'])
 class MySpec extends Specification { ... }

 // Clean specific datasources with explicit cleaner types
 @DatabaseCleanup(['dataSource:h2', 'dataSource_pg:postgresql'])
 class MySpec extends Specification { ... }

 // Mixed: some explicit, some auto-discovered
 @DatabaseCleanup(['dataSource:h2', 'dataSource_other'])
 class MySpec extends Specification { ... }

 // Clean after a specific test method
 @DatabaseCleanup
 void "my test"() { ... }

 // Use a custom ApplicationContext resolver
 @DatabaseCleanup(resolver = MyCustomResolver)
 class MySpec extends Specification { ... }