liveBook · Manning

Configuration class

As explained in Testing Spring Boot Applications

A configuration class is a class that declares application configuration, including component or bean definitions, for a framework container.

A configuration class declares application configuration, including beans that Spring Boot adds to an application context. Component scanning discovers configuration classes on the classpath when they reside in the main application package or a subpackage. section 3.3.3

Choose the configuration form according to its scope:

  • Place a regular @Configuration class under the main application package to make its beans available broadly, including to every matching @SpringBootTest. section 3.3.3
  • Use @TestConfiguration for test-only beans that should be added explicitly, either by nesting it in a test or importing it with @Import. section 3.3.3
  • Avoid nesting ordinary @Configuration in a test: it can replace the application’s entire configuration instead of adding selected beans. section 3.3.3

Adding a test bean selectively

@SpringBootTest @Import(CustomTestConfiguration.class) class ImportConfigTests { } A nested @TestConfiguration can instead declare @Bean methods directly, such as myCustomThing(), and applies only to the test that includes it.

How Testing Spring Boot Applications covers it

How deep it goes
Explains package discovery, explicit test inclusion, and configuration override behavior, but stops short of bean lifecycle internals.
Examples
Uses production and test package layouts, nested @TestConfiguration, @Bean declarations, and explicit @Import.
What it assumes
Assumes familiarity with Spring Boot tests and component scanning while demonstrating configuration placement and explicit inclusion.
What you can do after
Apply @Configuration, @TestConfiguration, and @Import to control which beans enter Spring Boot test contexts.
How it connects
Connects configuration classes with Spring Boot, component scanning, @SpringBootTest, @TestConfiguration, @Import, and @Bean.

Also explained in

Compare how 3 books explain configuration class →

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Testing Spring Boot Applications. The section links point to the parts of the book it draws on.