Skip to content

S
spring-boot
Commit ae1be76c authored by Phillip Webb's avatar Phillip Webb
Browse files
Options

Add pending-extract attribute to source 

Add `pending-extract=true` to source blocks to help us identify
those that need to be extracted to a real source file.

See gh-6313
parent 073f8c4b
Hide whitespace changes
Inline Side-by-side
Showing with 187 additions and 188 deletions
spring-boot-project/spring-boot-docs/src/docs/asciidoc/appendix-configuration-metadata.adoc
View file @ ae1be76c
...@@ -220,7 +220,7 @@ Deprecation can also be specified declaratively in code by adding the `@Deprecat ...@@ -220,7 +220,7 @@ Deprecation can also be specified declaratively in code by adding the `@Deprecat
For instance, assume that the `app.acme.target` property was confusing and was renamed to `app.acme.name`. For instance, assume that the `app.acme.target` property was confusing and was renamed to `app.acme.name`.
The following example shows how to handle that situation: The following example shows how to handle that situation:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@ConfigurationProperties("app.acme") @ConfigurationProperties("app.acme")
public class AcmeProperties { public class AcmeProperties {
...@@ -343,7 +343,7 @@ The special `.keys` and `.values` suffixes must refer to the keys and the values ...@@ -343,7 +343,7 @@ The special `.keys` and `.values` suffixes must refer to the keys and the values
Assume a `sample.contexts` maps magic `String` values to an integer, as shown in the following example: Assume a `sample.contexts` maps magic `String` values to an integer, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@ConfigurationProperties("sample") @ConfigurationProperties("sample")
public class SampleProperties { public class SampleProperties {
...@@ -762,7 +762,7 @@ The annotation processor also supports the use of the `@Data`, `@Getter`, and `@ ...@@ -762,7 +762,7 @@ The annotation processor also supports the use of the `@Data`, `@Getter`, and `@
Consider the following example: Consider the following example:
[source,java,indent=0,subs="verbatim,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,attributes"]
---- ----
@ConfigurationProperties(prefix="server") @ConfigurationProperties(prefix="server")
public class ServerProperties { public class ServerProperties {
...@@ -799,7 +799,7 @@ Also, the annotation processor cannot auto-detect default values for ``Enum``s a ...@@ -799,7 +799,7 @@ Also, the annotation processor cannot auto-detect default values for ``Enum``s a
For cases where the default value could not be detected, <<configuration-metadata-additional-metadata,manual metadata>> should be provided. For cases where the default value could not be detected, <<configuration-metadata-additional-metadata,manual metadata>> should be provided.
Consider the following example: Consider the following example:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@ConfigurationProperties(prefix = "acme.messaging") @ConfigurationProperties(prefix = "acme.messaging")
public class MessagingProperties { public class MessagingProperties {
...@@ -845,7 +845,7 @@ The annotation processor automatically considers inner classes as nested propert ...@@ -845,7 +845,7 @@ The annotation processor automatically considers inner classes as nested propert
Rather than documenting the `ip` and `port` at the root of the namespace, we could create a sub-namespace for it. Rather than documenting the `ip` and `port` at the root of the namespace, we could create a sub-namespace for it.
Consider the updated example: Consider the updated example:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@ConfigurationProperties(prefix="server") @ConfigurationProperties(prefix="server")
public class ServerProperties { public class ServerProperties {
......
spring-boot-project/spring-boot-docs/src/docs/asciidoc/build-tool-plugins.adoc
View file @ ae1be76c
...@@ -223,7 +223,7 @@ An exception is thrown if more than one candidate is found. ...@@ -223,7 +223,7 @@ An exception is thrown if more than one candidate is found.
=== Example Repackage Implementation === Example Repackage Implementation
The following example shows a typical repackage implementation: The following example shows a typical repackage implementation:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
Repackager repackager = new Repackager(sourceJarFile); Repackager repackager = new Repackager(sourceJarFile);
repackager.setBackupSource(false); repackager.setBackupSource(false);
......
spring-boot-project/spring-boot-docs/src/docs/asciidoc/deployment.adoc
View file @ ae1be76c
...@@ -135,7 +135,7 @@ Process-scoped environment variables are language agnostic. ...@@ -135,7 +135,7 @@ Process-scoped environment variables are language agnostic.
Environment variables do not always make for the easiest API, so Spring Boot automatically extracts them and flattens the data into properties that can be accessed through Spring's `Environment` abstraction, as shown in the following example: Environment variables do not always make for the easiest API, so Spring Boot automatically extracts them and flattens the data into properties that can be accessed through Spring's `Environment` abstraction, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Component @Component
class MyBean implements EnvironmentAware { class MyBean implements EnvironmentAware {
......
spring-boot-project/spring-boot-docs/src/docs/asciidoc/getting-started.adoc
View file @ ae1be76c
...@@ -483,7 +483,7 @@ If you run `mvn dependency:tree` again, you see that there are now a number of a ...@@ -483,7 +483,7 @@ If you run `mvn dependency:tree` again, you see that there are now a number of a
To finish our application, we need to create a single Java file. To finish our application, we need to create a single Java file.
By default, Maven compiles sources from `src/main/java`, so you need to create that directory structure and then add a file named `src/main/java/Example.java` to contain the following code: By default, Maven compiles sources from `src/main/java`, so you need to create that directory structure and then add a file named `src/main/java/Example.java` to contain the following code:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.boot.*; import org.springframework.boot.*;
import org.springframework.boot.autoconfigure.*; import org.springframework.boot.autoconfigure.*;
......
spring-boot-project/spring-boot-docs/src/docs/asciidoc/howto.adoc
View file @ ae1be76c
...@@ -239,7 +239,7 @@ Then the Spring Boot banner is not printed on startup, and the application is no ...@@ -239,7 +239,7 @@ Then the Spring Boot banner is not printed on startup, and the application is no
Properties defined in external configuration override the values specified with the Java API, with the notable exception of the sources used to create the `ApplicationContext`. Properties defined in external configuration override the values specified with the Java API, with the notable exception of the sources used to create the `ApplicationContext`.
Consider the following application: Consider the following application:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
new SpringApplicationBuilder() new SpringApplicationBuilder()
.bannerMode(Banner.Mode.OFF) .bannerMode(Banner.Mode.OFF)
...@@ -513,7 +513,7 @@ The best way to get that and be sure it has been initialized is to add a `@Bean` ...@@ -513,7 +513,7 @@ The best way to get that and be sure it has been initialized is to add a `@Bean`
Tests that use `@SpringBootTest(webEnvironment=WebEnvironment.RANDOM_PORT)` can also inject the actual port into a field by using the `@LocalServerPort` annotation, as shown in the following example: Tests that use `@SpringBootTest(webEnvironment=WebEnvironment.RANDOM_PORT)` can also inject the actual port into a field by using the `@LocalServerPort` annotation, as shown in the following example:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@SpringBootTest(webEnvironment=WebEnvironment.RANDOM_PORT) @SpringBootTest(webEnvironment=WebEnvironment.RANDOM_PORT)
public class MyWebIntegrationTests { public class MyWebIntegrationTests {
...@@ -658,7 +658,7 @@ and instead apply a customizer specific to your choice of server: ...@@ -658,7 +658,7 @@ and instead apply a customizer specific to your choice of server:
For Tomcat, we need to add an upgrade protocol: For Tomcat, we need to add an upgrade protocol:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@Bean @Bean
public TomcatConnectorCustomizer connectorCustomizer() { public TomcatConnectorCustomizer connectorCustomizer() {
...@@ -668,7 +668,7 @@ For Tomcat, we need to add an upgrade protocol: ...@@ -668,7 +668,7 @@ For Tomcat, we need to add an upgrade protocol:
For Jetty, we need to add a connection factory to the existing connector: For Jetty, we need to add a connection factory to the existing connector:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@Bean @Bean
public JettyServerCustomizer serverCustomizer() { public JettyServerCustomizer serverCustomizer() {
...@@ -687,7 +687,7 @@ For Jetty, we need to add a connection factory to the existing connector: ...@@ -687,7 +687,7 @@ For Jetty, we need to add a connection factory to the existing connector:
For Netty, we need to add `h2c` as a supported protocol: For Netty, we need to add `h2c` as a supported protocol:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@Bean @Bean
public NettyServerCustomizer serverCustomizer() { public NettyServerCustomizer serverCustomizer() {
...@@ -697,7 +697,7 @@ For Netty, we need to add `h2c` as a supported protocol: ...@@ -697,7 +697,7 @@ For Netty, we need to add `h2c` as a supported protocol:
For Undertow, we need to enable the HTTP2 option: For Undertow, we need to enable the HTTP2 option:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@Bean @Bean
public UndertowBuilderCustomizer builderCustomizer() { public UndertowBuilderCustomizer builderCustomizer() {
...@@ -721,7 +721,7 @@ You can declare such a component and get access to the server factory relevant t ...@@ -721,7 +721,7 @@ You can declare such a component and get access to the server factory relevant t
The example below is for Tomcat with the `spring-boot-starter-web` (Servlet stack): The example below is for Tomcat with the `spring-boot-starter-web` (Servlet stack):
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@Component @Component
public class MyTomcatWebServerCustomizer public class MyTomcatWebServerCustomizer
...@@ -802,7 +802,7 @@ Like any other Spring bean, you can define the order of Servlet filter beans; pl ...@@ -802,7 +802,7 @@ Like any other Spring bean, you can define the order of Servlet filter beans; pl
As <<howto-add-a-servlet-filter-or-listener-as-spring-bean,described earlier>>, any `Servlet` or `Filter` beans are registered with the servlet container automatically. As <<howto-add-a-servlet-filter-or-listener-as-spring-bean,described earlier>>, any `Servlet` or `Filter` beans are registered with the servlet container automatically.
To disable registration of a particular `Filter` or `Servlet` bean, create a registration bean for it and mark it as disabled, as shown in the following example: To disable registration of a particular `Filter` or `Servlet` bean, create a registration bean for it and mark it as disabled, as shown in the following example:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@Bean @Bean
public FilterRegistrationBean registration(MyFilter filter) { public FilterRegistrationBean registration(MyFilter filter) {
...@@ -987,7 +987,7 @@ include::{include-howto}/embeddedwebservers/UndertowMultipleListenersConfigurati ...@@ -987,7 +987,7 @@ include::{include-howto}/embeddedwebservers/UndertowMultipleListenersConfigurati
=== Create WebSocket Endpoints Using @ServerEndpoint === Create WebSocket Endpoints Using @ServerEndpoint
If you want to use `@ServerEndpoint` in a Spring Boot application that used an embedded container, you must declare a single `ServerEndpointExporter` `@Bean`, as shown in the following example: If you want to use `@ServerEndpoint` in a Spring Boot application that used an embedded container, you must declare a single `ServerEndpointExporter` `@Bean`, as shown in the following example:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@Bean @Bean
public ServerEndpointExporter serverEndpointExporter() { public ServerEndpointExporter serverEndpointExporter() {
...@@ -1012,7 +1012,7 @@ This section answers common questions about Spring MVC and Spring Boot. ...@@ -1012,7 +1012,7 @@ This section answers common questions about Spring MVC and Spring Boot.
=== Write a JSON REST Service === Write a JSON REST Service
Any Spring `@RestController` in a Spring Boot application should render JSON response by default as long as Jackson2 is on the classpath, as shown in the following example: Any Spring `@RestController` in a Spring Boot application should render JSON response by default as long as Jackson2 is on the classpath, as shown in the following example:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@RestController @RestController
public class MyController { public class MyController {
...@@ -1046,7 +1046,7 @@ To use the Jackson XML renderer, add the following dependency to your project: ...@@ -1046,7 +1046,7 @@ To use the Jackson XML renderer, add the following dependency to your project:
If Jackson's XML extension is not available and JAXB is available, XML can be rendered with the additional requirement of having `MyThing` annotated as `@XmlRootElement`, as shown in the following example: If Jackson's XML extension is not available and JAXB is available, XML can be rendered with the additional requirement of having `MyThing` annotated as `@XmlRootElement`, as shown in the following example:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@XmlRootElement @XmlRootElement
public class MyThing { public class MyThing {
...@@ -1251,7 +1251,7 @@ For more detail, see the following sections: ...@@ -1251,7 +1251,7 @@ For more detail, see the following sections:
Spring Security provides support for running tests as a specific user. Spring Security provides support for running tests as a specific user.
For example, the test in the snippet below will run with an authenticated user that has the `ADMIN` role. For example, the test in the snippet below will run with an authenticated user that has the `ADMIN` role.
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Test @Test
@WithMockUser(roles="ADMIN") @WithMockUser(roles="ADMIN")
...@@ -1294,7 +1294,7 @@ To use Jersey alongside another web framework, such as Spring MVC, it should be ...@@ -1294,7 +1294,7 @@ To use Jersey alongside another web framework, such as Spring MVC, it should be
First, configure Jersey to use a Filter rather than a Servlet by configuring the configprop:spring.jersey.type[] application property with a value of `filter`. First, configure Jersey to use a Filter rather than a Servlet by configuring the configprop:spring.jersey.type[] application property with a value of `filter`.
Second, configure your `ResourceConfig` to forward requests that would have resulted in a 404, as shown in the following example. Second, configure your `ResourceConfig` to forward requests that would have resulted in a 404, as shown in the following example.
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@Component @Component
public class JerseyConfig extends ResourceConfig { public class JerseyConfig extends ResourceConfig {
...@@ -1551,7 +1551,7 @@ If you need to externalize some settings, you can bind your `DataSource` to the ...@@ -1551,7 +1551,7 @@ If you need to externalize some settings, you can bind your `DataSource` to the
The following example shows how to define a data source in a bean: The following example shows how to define a data source in a bean:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@Bean @Bean
@ConfigurationProperties(prefix="app.datasource") @ConfigurationProperties(prefix="app.datasource")
...@@ -1729,7 +1729,7 @@ For more about Spring Data, see the {spring-data}[Spring Data project page]. ...@@ -1729,7 +1729,7 @@ For more about Spring Data, see the {spring-data}[Spring Data project page].
Spring Boot tries to guess the location of your `@Entity` definitions, based on the `@EnableAutoConfiguration` it finds. Spring Boot tries to guess the location of your `@Entity` definitions, based on the `@EnableAutoConfiguration` it finds.
To get more control, you can use the `@EntityScan` annotation, as shown in the following example: To get more control, you can use the `@EntityScan` annotation, as shown in the following example:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@Configuration(proxyBeanMethods = false) @Configuration(proxyBeanMethods = false)
@EnableAutoConfiguration @EnableAutoConfiguration
...@@ -1806,7 +1806,7 @@ If you prefer to use Hibernate 5's default instead, set the following property: ...@@ -1806,7 +1806,7 @@ If you prefer to use Hibernate 5's default instead, set the following property:
Alternatively, you can configure the following bean: Alternatively, you can configure the following bean:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@Bean @Bean
public PhysicalNamingStrategy physicalNamingStrategy() { public PhysicalNamingStrategy physicalNamingStrategy() {
...@@ -1858,7 +1858,7 @@ Even if the default `EntityManagerFactory` works fine, you need to define a new ...@@ -1858,7 +1858,7 @@ Even if the default `EntityManagerFactory` works fine, you need to define a new
You can use the `EntityManagerBuilder` provided by Spring Boot to help you to create one. You can use the `EntityManagerBuilder` provided by Spring Boot to help you to create one.
Alternatively, you can use the `LocalContainerEntityManagerFactoryBean` directly from Spring ORM, as shown in the following example: Alternatively, you can use the `LocalContainerEntityManagerFactoryBean` directly from Spring ORM, as shown in the following example:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
// add two data sources configured as above // add two data sources configured as above
...@@ -1896,7 +1896,7 @@ Alternatively, you might be able to use a JTA transaction manager that spans bot ...@@ -1896,7 +1896,7 @@ Alternatively, you might be able to use a JTA transaction manager that spans bot
If you use Spring Data, you need to configure `@EnableJpaRepositories` accordingly, as shown in the following example: If you use Spring Data, you need to configure `@EnableJpaRepositories` accordingly, as shown in the following example:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@Configuration(proxyBeanMethods = false) @Configuration(proxyBeanMethods = false)
@EnableJpaRepositories(basePackageClasses = Customer.class, @EnableJpaRepositories(basePackageClasses = Customer.class,
...@@ -2206,7 +2206,7 @@ If your JMS broker does not support transacted sessions, you have to disable the ...@@ -2206,7 +2206,7 @@ If your JMS broker does not support transacted sessions, you have to disable the
If you create your own `JmsListenerContainerFactory`, there is nothing to do, since, by default it cannot be transacted. If you create your own `JmsListenerContainerFactory`, there is nothing to do, since, by default it cannot be transacted.
If you want to use the `DefaultJmsListenerContainerFactoryConfigurer` to reuse Spring Boot's default, you can disable transacted sessions, as follows: If you want to use the `DefaultJmsListenerContainerFactoryConfigurer` to reuse Spring Boot's default, you can disable transacted sessions, as follows:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Bean @Bean
public DefaultJmsListenerContainerFactory jmsListenerContainerFactory( public DefaultJmsListenerContainerFactory jmsListenerContainerFactory(
...@@ -2399,7 +2399,7 @@ Alternatively, you can add the `RemoteIpValve` by customizing the `TomcatServlet ...@@ -2399,7 +2399,7 @@ Alternatively, you can add the `RemoteIpValve` by customizing the `TomcatServlet
To configure Spring Security to require a secure channel for all (or some) requests, consider adding your own `SecurityFilterChain` bean that adds the following `HttpSecurity` configuration: To configure Spring Security to require a secure channel for all (or some) requests, consider adding your own `SecurityFilterChain` bean that adds the following `HttpSecurity` configuration:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@Bean @Bean
public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception { public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
...@@ -2798,7 +2798,7 @@ The first step in producing a deployable war file is to provide a `SpringBootSer ...@@ -2798,7 +2798,7 @@ The first step in producing a deployable war file is to provide a `SpringBootSer
Doing so makes use of Spring Framework's Servlet 3.0 support and lets you configure your application when it is launched by the servlet container. Doing so makes use of Spring Framework's Servlet 3.0 support and lets you configure your application when it is launched by the servlet container.
Typically, you should update your application's main class to extend `SpringBootServletInitializer`, as shown in the following example: Typically, you should update your application's main class to extend `SpringBootServletInitializer`, as shown in the following example:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@SpringBootApplication @SpringBootApplication
public class Application extends SpringBootServletInitializer { public class Application extends SpringBootServletInitializer {
...@@ -2875,7 +2875,7 @@ See the https://spring.io/guides/gs/convert-jar-to-war/[Getting Started Guide on ...@@ -2875,7 +2875,7 @@ See the https://spring.io/guides/gs/convert-jar-to-war/[Getting Started Guide on
To create a deployable war by extending `SpringBootServletInitializer` (for example, in a class called `Application`) and adding the Spring Boot `@SpringBootApplication` annotation, use code similar to that shown in the following example: To create a deployable war by extending `SpringBootServletInitializer` (for example, in a class called `Application`) and adding the Spring Boot `@SpringBootApplication` annotation, use code similar to that shown in the following example:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@SpringBootApplication @SpringBootApplication
public class Application extends SpringBootServletInitializer { public class Application extends SpringBootServletInitializer {
...@@ -2908,7 +2908,7 @@ If you have other features in your application (for instance, using other servle ...@@ -2908,7 +2908,7 @@ If you have other features in your application (for instance, using other servle
Once the war file is working, you can make it executable by adding a `main` method to your `Application`, as shown in the following example: Once the war file is working, you can make it executable by adding a `main` method to your `Application`, as shown in the following example:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
public static void main(String[] args) { public static void main(String[] args) {
SpringApplication.run(Application.class, args); SpringApplication.run(Application.class, args);
...@@ -2919,7 +2919,7 @@ Once the war file is working, you can make it executable by adding a `main` meth ...@@ -2919,7 +2919,7 @@ Once the war file is working, you can make it executable by adding a `main` meth
==== ====
If you intend to start your application as a war or as an executable application, you need to share the customizations of the builder in a method that is both available to the `SpringBootServletInitializer` callback and in the `main` method in a class similar to the following: If you intend to start your application as a war or as an executable application, you need to share the customizations of the builder in a method that is both available to the `SpringBootServletInitializer` callback and in the `main` method in a class similar to the following:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@SpringBootApplication @SpringBootApplication
public class Application extends SpringBootServletInitializer { public class Application extends SpringBootServletInitializer {
...@@ -2969,7 +2969,7 @@ To deploy a Spring Boot application to WebLogic, you must ensure that your servl ...@@ -2969,7 +2969,7 @@ To deploy a Spring Boot application to WebLogic, you must ensure that your servl
A typical initializer for WebLogic should resemble the following example: A typical initializer for WebLogic should resemble the following example:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.web.servlet.support.SpringBootServletInitializer; import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;
...@@ -3052,7 +3052,7 @@ It integrates with JUnit, allowing you to write a test class that can start up a ...@@ -3052,7 +3052,7 @@ It integrates with JUnit, allowing you to write a test class that can start up a
Testcontainers is especially useful for writing integration tests that talk to a real backend service such as MySQL, MongoDB, Cassandra etc. Testcontainers is especially useful for writing integration tests that talk to a real backend service such as MySQL, MongoDB, Cassandra etc.
Testcontainers can be used in a Spring Boot test as follows: Testcontainers can be used in a Spring Boot test as follows:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@SpringBootTest @SpringBootTest
@Testcontainers @Testcontainers
...@@ -3069,7 +3069,7 @@ In most cases, you will need to configure the application using details from the ...@@ -3069,7 +3069,7 @@ In most cases, you will need to configure the application using details from the
This can be done with a static `@DynamicPropertySource` method that allows adding dynamic property values to the Spring Environment. This can be done with a static `@DynamicPropertySource` method that allows adding dynamic property values to the Spring Environment.
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@SpringBootTest @SpringBootTest
@Testcontainers @Testcontainers
......
spring-boot-project/spring-boot-docs/src/docs/asciidoc/production-ready-features.adoc
View file @ ae1be76c
...@@ -357,7 +357,7 @@ If you wish to configure custom security for HTTP endpoints, for example, only a ...@@ -357,7 +357,7 @@ If you wish to configure custom security for HTTP endpoints, for example, only a
A typical Spring Security configuration might look something like the following example: A typical Spring Security configuration might look something like the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Bean @Bean
public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception { public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
...@@ -386,7 +386,7 @@ You can do so by changing the configprop:management.endpoints.web.exposure.inclu ...@@ -386,7 +386,7 @@ You can do so by changing the configprop:management.endpoints.web.exposure.inclu
Additionally, if Spring Security is present, you would need to add custom security configuration that allows unauthenticated access to the endpoints as shown in the following example: Additionally, if Spring Security is present, you would need to add custom security configuration that allows unauthenticated access to the endpoints as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Bean @Bean
public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception { public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
...@@ -776,7 +776,7 @@ You need to provide an implementation of the `health()` method and return a `Hea ...@@ -776,7 +776,7 @@ You need to provide an implementation of the `health()` method and return a `Hea
The `Health` response should include a status and can optionally include additional details to be displayed. The `Health` response should include a status and can optionally include additional details to be displayed.
The following code shows a sample `HealthIndicator` implementation: The following code shows a sample `HealthIndicator` implementation:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.boot.actuate.health.Health; import org.springframework.boot.actuate.health.Health;
import org.springframework.boot.actuate.health.HealthIndicator; import org.springframework.boot.actuate.health.HealthIndicator;
...@@ -870,7 +870,7 @@ If you need to register a regular `HealthContributor`, you should wrap it using ...@@ -870,7 +870,7 @@ If you need to register a regular `HealthContributor`, you should wrap it using
To provide custom health information from a reactive API, you can register Spring beans that implement the {spring-boot-actuator-module-code}/health/ReactiveHealthIndicator.java[`ReactiveHealthIndicator`] interface. To provide custom health information from a reactive API, you can register Spring beans that implement the {spring-boot-actuator-module-code}/health/ReactiveHealthIndicator.java[`ReactiveHealthIndicator`] interface.
The following code shows a sample `ReactiveHealthIndicator` implementation: The following code shows a sample `ReactiveHealthIndicator` implementation:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Component @Component
public class MyReactiveHealthIndicator implements ReactiveHealthIndicator { public class MyReactiveHealthIndicator implements ReactiveHealthIndicator {
...@@ -1226,7 +1226,7 @@ To provide custom application information, you can register Spring beans that im ...@@ -1226,7 +1226,7 @@ To provide custom application information, you can register Spring beans that im
The following example contributes an `example` entry with a single value: The following example contributes an `example` entry with a single value:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import java.util.Collections; import java.util.Collections;
...@@ -1612,7 +1612,7 @@ Spring Boot will also add any auto-configured registries to the global static co ...@@ -1612,7 +1612,7 @@ Spring Boot will also add any auto-configured registries to the global static co
You can register any number of `MeterRegistryCustomizer` beans to further configure the registry, such as applying common tags, before any meters are registered with the registry: You can register any number of `MeterRegistryCustomizer` beans to further configure the registry, such as applying common tags, before any meters are registered with the registry:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Bean @Bean
MeterRegistryCustomizer<MeterRegistry> metricsCommonTags() { MeterRegistryCustomizer<MeterRegistry> metricsCommonTags() {
...@@ -1622,7 +1622,7 @@ You can register any number of `MeterRegistryCustomizer` beans to further config ...@@ -1622,7 +1622,7 @@ You can register any number of `MeterRegistryCustomizer` beans to further config
You can apply customizations to particular registry implementations by being more specific about the generic type: You can apply customizations to particular registry implementations by being more specific about the generic type:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Bean @Bean
MeterRegistryCustomizer<GraphiteMeterRegistry> graphiteMetricsNamingConvention() { MeterRegistryCustomizer<GraphiteMeterRegistry> graphiteMetricsNamingConvention() {
...@@ -1780,12 +1780,12 @@ Micrometer provides a default `HierarchicalNameMapper` that governs how a dimens ...@@ -1780,12 +1780,12 @@ Micrometer provides a default `HierarchicalNameMapper` that governs how a dimens
TIP: To take control over this behaviour, define your `GraphiteMeterRegistry` and supply your own `HierarchicalNameMapper`. TIP: To take control over this behaviour, define your `GraphiteMeterRegistry` and supply your own `HierarchicalNameMapper`.
An auto-configured `GraphiteConfig` and `Clock` beans are provided unless you define your own: An auto-configured `GraphiteConfig` and `Clock` beans are provided unless you define your own:
[source,java] [source,java,pending-extract=true,indent=0]
---- ----
@Bean @Bean
public GraphiteMeterRegistry graphiteMeterRegistry(GraphiteConfig config, Clock clock) { public GraphiteMeterRegistry graphiteMeterRegistry(GraphiteConfig config, Clock clock) {
return new GraphiteMeterRegistry(config, clock, MY_HIERARCHICAL_MAPPER); return new GraphiteMeterRegistry(config, clock, MY_HIERARCHICAL_MAPPER);
} }
---- ----
...@@ -1855,12 +1855,12 @@ Micrometer provides a default `HierarchicalNameMapper` that governs how a dimens ...@@ -1855,12 +1855,12 @@ Micrometer provides a default `HierarchicalNameMapper` that governs how a dimens
TIP: To take control over this behaviour, define your `JmxMeterRegistry` and supply your own `HierarchicalNameMapper`. TIP: To take control over this behaviour, define your `JmxMeterRegistry` and supply your own `HierarchicalNameMapper`.
An auto-configured `JmxConfig` and `Clock` beans are provided unless you define your own: An auto-configured `JmxConfig` and `Clock` beans are provided unless you define your own:
[source,java] [source,java,pending-extract=true,indent=0]
---- ----
@Bean @Bean
public JmxMeterRegistry jmxMeterRegistry(JmxConfig config, Clock clock) { public JmxMeterRegistry jmxMeterRegistry(JmxConfig config, Clock clock) {
return new JmxMeterRegistry(config, clock, MY_HIERARCHICAL_MAPPER); return new JmxMeterRegistry(config, clock, MY_HIERARCHICAL_MAPPER);
} }
---- ----
...@@ -2128,7 +2128,7 @@ Auto-configuration enables the instrumentation of requests handled by Spring MVC ...@@ -2128,7 +2128,7 @@ Auto-configuration enables the instrumentation of requests handled by Spring MVC
When `management.metrics.web.server.request.autotime.enabled` is `true`, this instrumentation occurs for all requests. When `management.metrics.web.server.request.autotime.enabled` is `true`, this instrumentation occurs for all requests.
Alternatively, when set to `false`, you can enable instrumentation by adding `@Timed` to a request-handling method: Alternatively, when set to `false`, you can enable instrumentation by adding `@Timed` to a request-handling method:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@RestController @RestController
@Timed <1> @Timed <1>
...@@ -2217,7 +2217,7 @@ When Micrometer's `micrometer-jersey2` module is on the classpath, auto-configur ...@@ -2217,7 +2217,7 @@ When Micrometer's `micrometer-jersey2` module is on the classpath, auto-configur
When `management.metrics.web.server.request.autotime.enabled` is `true`, this instrumentation occurs for all requests. When `management.metrics.web.server.request.autotime.enabled` is `true`, this instrumentation occurs for all requests.
Alternatively, when set to `false`, you can enable instrumentation by adding `@Timed` to a request-handling method: Alternatively, when set to `false`, you can enable instrumentation by adding `@Timed` to a request-handling method:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Component @Component
@Path("/api/people") @Path("/api/people")
......
spring-boot-project/spring-boot-docs/src/docs/asciidoc/spring-boot-cli.adoc
View file @ ae1be76c
...@@ -209,7 +209,7 @@ The preceding declaration picks up `custom-bom-1.0.0.pom` in a Maven repository ...@@ -209,7 +209,7 @@ The preceding declaration picks up `custom-bom-1.0.0.pom` in a Maven repository
When you specify multiple BOMs, they are applied in the order in which you declare them, as shown in the following example: When you specify multiple BOMs, they are applied in the order in which you declare them, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@DependencyManagementBom(["com.example.custom-bom:1.0.0", @DependencyManagementBom(["com.example.custom-bom:1.0.0",
"com.example.another-bom:1.0.0"]) "com.example.another-bom:1.0.0"])
......
spring-boot-project/spring-boot-docs/src/docs/asciidoc/spring-boot-features.adoc
View file @ ae1be76c
...@@ -13,7 +13,7 @@ If you have not already done so, you might want to read the "<<getting-started.a ...@@ -13,7 +13,7 @@ If you have not already done so, you might want to read the "<<getting-started.a
The `SpringApplication` class provides a convenient way to bootstrap a Spring application that is started from a `main()` method. The `SpringApplication` class provides a convenient way to bootstrap a Spring application that is started from a `main()` method.
In many situations, you can delegate to the static `SpringApplication.run` method, as shown in the following example: In many situations, you can delegate to the static `SpringApplication.run` method, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
public static void main(String[] args) { public static void main(String[] args) {
SpringApplication.run(MySpringConfiguration.class, args); SpringApplication.run(MySpringConfiguration.class, args);
...@@ -168,7 +168,7 @@ This will initialize the `application.*` banner variables before building the cl ...@@ -168,7 +168,7 @@ This will initialize the `application.*` banner variables before building the cl
If the `SpringApplication` defaults are not to your taste, you can instead create a local instance and customize it. If the `SpringApplication` defaults are not to your taste, you can instead create a local instance and customize it.
For example, to turn off the banner, you could write: For example, to turn off the banner, you could write:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
public static void main(String[] args) { public static void main(String[] args) {
SpringApplication app = new SpringApplication(MySpringConfiguration.class); SpringApplication app = new SpringApplication(MySpringConfiguration.class);
...@@ -247,7 +247,7 @@ More often, applications will want to listen to state updates or update the stat ...@@ -247,7 +247,7 @@ More often, applications will want to listen to state updates or update the stat
For example, we can export the "Readiness" state of the application to a file so that a Kubernetes "exec Probe" can look at this file: For example, we can export the "Readiness" state of the application to a file so that a Kubernetes "exec Probe" can look at this file:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Component @Component
public class ReadinessStateExporter { public class ReadinessStateExporter {
...@@ -269,7 +269,7 @@ For example, we can export the "Readiness" state of the application to a file so ...@@ -269,7 +269,7 @@ For example, we can export the "Readiness" state of the application to a file so
We can also update the state of the application, when the application breaks and cannot recover: We can also update the state of the application, when the application breaks and cannot recover:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Component @Component
public class LocalCacheVerifier { public class LocalCacheVerifier {
...@@ -372,7 +372,7 @@ TIP: It is often desirable to call `setWebApplicationType(WebApplicationType.NON ...@@ -372,7 +372,7 @@ TIP: It is often desirable to call `setWebApplicationType(WebApplicationType.NON
If you need to access the application arguments that were passed to `SpringApplication.run(...)`, you can inject a `org.springframework.boot.ApplicationArguments` bean. If you need to access the application arguments that were passed to `SpringApplication.run(...)`, you can inject a `org.springframework.boot.ApplicationArguments` bean.
The `ApplicationArguments` interface provides access to both the raw `String[]` arguments as well as parsed `option` and `non-option` arguments, as shown in the following example: The `ApplicationArguments` interface provides access to both the raw `String[]` arguments as well as parsed `option` and `non-option` arguments, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.boot.*; import org.springframework.boot.*;
import org.springframework.beans.factory.annotation.*; import org.springframework.beans.factory.annotation.*;
...@@ -407,7 +407,7 @@ NOTE: This contract is well suited for tasks that should run after application s ...@@ -407,7 +407,7 @@ NOTE: This contract is well suited for tasks that should run after application s
The `CommandLineRunner` interfaces provides access to application arguments as a string array, whereas the `ApplicationRunner` uses the `ApplicationArguments` interface discussed earlier. The `CommandLineRunner` interfaces provides access to application arguments as a string array, whereas the `ApplicationRunner` uses the `ApplicationArguments` interface discussed earlier.
The following example shows a `CommandLineRunner` with a `run` method: The following example shows a `CommandLineRunner` with a `run` method:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.boot.*; import org.springframework.boot.*;
import org.springframework.stereotype.*; import org.springframework.stereotype.*;
...@@ -465,7 +465,7 @@ This data can be collected for profiling purposes, or just to have a better unde ...@@ -465,7 +465,7 @@ This data can be collected for profiling purposes, or just to have a better unde
You can choose an `ApplicationStartup` implementation when setting up the `SpringApplication` instance. You can choose an `ApplicationStartup` implementation when setting up the `SpringApplication` instance.
For example, to use the `BufferingApplicationStartup`, you could write: For example, to use the `BufferingApplicationStartup`, you could write:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
public static void main(String[] args) { public static void main(String[] args) {
SpringApplication app = new SpringApplication(MySpringConfiguration.class); SpringApplication app = new SpringApplication(MySpringConfiguration.class);
...@@ -524,7 +524,7 @@ Config data files are considered in the following order: ...@@ -524,7 +524,7 @@ Config data files are considered in the following order:
To provide a concrete example, suppose you develop a `@Component` that uses a `name` property, as shown in the following example: To provide a concrete example, suppose you develop a `@Component` that uses a `name` property, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.stereotype.*; import org.springframework.stereotype.*;
import org.springframework.beans.factory.annotation.*; import org.springframework.beans.factory.annotation.*;
...@@ -1107,7 +1107,7 @@ TIP: See also the <<boot-features-external-config-vs-value,differences between ` ...@@ -1107,7 +1107,7 @@ TIP: See also the <<boot-features-external-config-vs-value,differences between `
==== JavaBean properties binding ==== JavaBean properties binding
It is possible to bind a bean declaring standard JavaBean properties as shown in the following example: It is possible to bind a bean declaring standard JavaBean properties as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
package com.example; package com.example;
...@@ -1197,7 +1197,7 @@ Finally, only standard Java Bean properties are considered and binding on static ...@@ -1197,7 +1197,7 @@ Finally, only standard Java Bean properties are considered and binding on static
==== Constructor binding ==== Constructor binding
The example in the previous section can be rewritten in an immutable fashion as shown in the following example: The example in the previous section can be rewritten in an immutable fashion as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
package com.example; package com.example;
...@@ -1265,7 +1265,7 @@ Default values can be specified using `@DefaultValue` and the same conversion se ...@@ -1265,7 +1265,7 @@ Default values can be specified using `@DefaultValue` and the same conversion se
By default, if no properties are bound to `Security`, the `AcmeProperties` instance will contain a `null` value for `security`. By default, if no properties are bound to `Security`, the `AcmeProperties` instance will contain a `null` value for `security`.
If you wish you return a non-null instance of `Security` even when no properties are bound to it, you can use an empty `@DefaultValue` annotation to do so: If you wish you return a non-null instance of `Security` even when no properties are bound to it, you can use an empty `@DefaultValue` annotation to do so:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
package com.example; package com.example;
import java.net.InetAddress; import java.net.InetAddress;
...@@ -1314,7 +1314,7 @@ Sometimes, classes annotated with `@ConfigurationProperties` might not be suitab ...@@ -1314,7 +1314,7 @@ Sometimes, classes annotated with `@ConfigurationProperties` might not be suitab
In these cases, specify the list of types to process using the `@EnableConfigurationProperties` annotation. In these cases, specify the list of types to process using the `@EnableConfigurationProperties` annotation.
This can be done on any `@Configuration` class, as shown in the following example: This can be done on any `@Configuration` class, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Configuration(proxyBeanMethods = false) @Configuration(proxyBeanMethods = false)
@EnableConfigurationProperties(AcmeProperties.class) @EnableConfigurationProperties(AcmeProperties.class)
...@@ -1327,7 +1327,7 @@ Typically, it is added to the main application class that is annotated with `@Sp ...@@ -1327,7 +1327,7 @@ Typically, it is added to the main application class that is annotated with `@Sp
By default, scanning will occur from the package of the class that declares the annotation. By default, scanning will occur from the package of the class that declares the annotation.
If you want to define specific packages to scan, you can do so as shown in the following example: If you want to define specific packages to scan, you can do so as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@SpringBootApplication @SpringBootApplication
@ConfigurationPropertiesScan({ "com.example.app", "org.acme.another" }) @ConfigurationPropertiesScan({ "com.example.app", "org.acme.another" })
...@@ -1366,7 +1366,7 @@ This style of configuration works particularly well with the `SpringApplication` ...@@ -1366,7 +1366,7 @@ This style of configuration works particularly well with the `SpringApplication`
To work with `@ConfigurationProperties` beans, you can inject them in the same way as any other bean, as shown in the following example: To work with `@ConfigurationProperties` beans, you can inject them in the same way as any other bean, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Service @Service
public class MyService { public class MyService {
...@@ -1401,7 +1401,7 @@ Doing so can be particularly useful when you want to bind properties to third-pa ...@@ -1401,7 +1401,7 @@ Doing so can be particularly useful when you want to bind properties to third-pa
To configure a bean from the `Environment` properties, add `@ConfigurationProperties` to its bean registration, as shown in the following example: To configure a bean from the `Environment` properties, add `@ConfigurationProperties` to its bean registration, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@ConfigurationProperties(prefix = "another") @ConfigurationProperties(prefix = "another")
@Bean @Bean
...@@ -1421,7 +1421,7 @@ Common examples where this is useful include dash-separated environment properti ...@@ -1421,7 +1421,7 @@ Common examples where this is useful include dash-separated environment properti
As an example, consider the following `@ConfigurationProperties` class: As an example, consider the following `@ConfigurationProperties` class:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@ConfigurationProperties(prefix="acme.my-project.person") @ConfigurationProperties(prefix="acme.my-project.person")
public class OwnerProperties { public class OwnerProperties {
...@@ -1553,7 +1553,7 @@ When lists are configured in more than one place, overriding works by replacing ...@@ -1553,7 +1553,7 @@ When lists are configured in more than one place, overriding works by replacing
For example, assume a `MyPojo` object with `name` and `description` attributes that are `null` by default. For example, assume a `MyPojo` object with `name` and `description` attributes that are `null` by default.
The following example exposes a list of `MyPojo` objects from `AcmeProperties`: The following example exposes a list of `MyPojo` objects from `AcmeProperties`:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@ConfigurationProperties("acme") @ConfigurationProperties("acme")
public class AcmeProperties { public class AcmeProperties {
...@@ -1617,7 +1617,7 @@ For `Map` properties, you can bind with property values drawn from multiple sour ...@@ -1617,7 +1617,7 @@ For `Map` properties, you can bind with property values drawn from multiple sour
However, for the same property in multiple sources, the one with the highest priority is used. However, for the same property in multiple sources, the one with the highest priority is used.
The following example exposes a `Map<String, MyPojo>` from `AcmeProperties`: The following example exposes a `Map<String, MyPojo>` from `AcmeProperties`:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@ConfigurationProperties("acme") @ConfigurationProperties("acme")
public class AcmeProperties { public class AcmeProperties {
...@@ -1784,7 +1784,7 @@ Spring Boot attempts to validate `@ConfigurationProperties` classes whenever the ...@@ -1784,7 +1784,7 @@ Spring Boot attempts to validate `@ConfigurationProperties` classes whenever the
You can use JSR-303 `javax.validation` constraint annotations directly on your configuration class. You can use JSR-303 `javax.validation` constraint annotations directly on your configuration class.
To do so, ensure that a compliant JSR-303 implementation is on your classpath and then add constraint annotations to your fields, as shown in the following example: To do so, ensure that a compliant JSR-303 implementation is on your classpath and then add constraint annotations to your fields, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@ConfigurationProperties(prefix="acme") @ConfigurationProperties(prefix="acme")
@Validated @Validated
...@@ -1803,7 +1803,7 @@ TIP: You can also trigger validation by annotating the `@Bean` method that creat ...@@ -1803,7 +1803,7 @@ TIP: You can also trigger validation by annotating the `@Bean` method that creat
To ensure that validation is always triggered for nested properties, even when no properties are found, the associated field must be annotated with `@Valid`. To ensure that validation is always triggered for nested properties, even when no properties are found, the associated field must be annotated with `@Valid`.
The following example builds on the preceding `AcmeProperties` example: The following example builds on the preceding `AcmeProperties` example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@ConfigurationProperties(prefix="acme") @ConfigurationProperties(prefix="acme")
@Validated @Validated
...@@ -1881,7 +1881,7 @@ If the value of a property from an application property file is a `SpEL` express ...@@ -1881,7 +1881,7 @@ If the value of a property from an application property file is a `SpEL` express
Spring Profiles provide a way to segregate parts of your application configuration and make it be available only in certain environments. Spring Profiles provide a way to segregate parts of your application configuration and make it be available only in certain environments.
Any `@Component`, `@Configuration` or `@ConfigurationProperties` can be marked with `@Profile` to limit when it is loaded, as shown in the following example: Any `@Component`, `@Configuration` or `@ConfigurationProperties` can be marked with `@Profile` to limit when it is loaded, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Configuration(proxyBeanMethods = false) @Configuration(proxyBeanMethods = false)
@Profile("production") @Profile("production")
...@@ -2522,7 +2522,7 @@ Methods in your controller are mapped to HTTP by using `@RequestMapping` annotat ...@@ -2522,7 +2522,7 @@ Methods in your controller are mapped to HTTP by using `@RequestMapping` annotat
The following code shows a typical `@RestController` that serves JSON data: The following code shows a typical `@RestController` that serves JSON data:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@RestController @RestController
@RequestMapping(value="/users") @RequestMapping(value="/users")
...@@ -2591,7 +2591,7 @@ By default, strings are encoded in `UTF-8`. ...@@ -2591,7 +2591,7 @@ By default, strings are encoded in `UTF-8`.
If you need to add or customize converters, you can use Spring Boot's `HttpMessageConverters` class, as shown in the following listing: If you need to add or customize converters, you can use Spring Boot's `HttpMessageConverters` class, as shown in the following listing:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.boot.autoconfigure.http.HttpMessageConverters; import org.springframework.boot.autoconfigure.http.HttpMessageConverters;
import org.springframework.context.annotation.*; import org.springframework.context.annotation.*;
...@@ -2623,7 +2623,7 @@ Custom serializers are usually https://github.com/FasterXML/jackson-docs/wiki/Ja ...@@ -2623,7 +2623,7 @@ Custom serializers are usually https://github.com/FasterXML/jackson-docs/wiki/Ja
You can use the `@JsonComponent` annotation directly on `JsonSerializer`, `JsonDeserializer` or `KeyDeserializer` implementations. You can use the `@JsonComponent` annotation directly on `JsonSerializer`, `JsonDeserializer` or `KeyDeserializer` implementations.
You can also use it on classes that contain serializers/deserializers as inner classes, as shown in the following example: You can also use it on classes that contain serializers/deserializers as inner classes, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import java.io.*; import java.io.*;
import com.fasterxml.jackson.core.*; import com.fasterxml.jackson.core.*;
...@@ -2888,7 +2888,7 @@ To do so, extend `BasicErrorController`, add a public method with a `@RequestMap ...@@ -2888,7 +2888,7 @@ To do so, extend `BasicErrorController`, add a public method with a `@RequestMap
You can also define a class annotated with `@ControllerAdvice` to customize the JSON document to return for a particular controller and/or exception type, as shown in the following example: You can also define a class annotated with `@ControllerAdvice` to customize the JSON document to return for a particular controller and/or exception type, as shown in the following example:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@ControllerAdvice(basePackageClasses = AcmeController.class) @ControllerAdvice(basePackageClasses = AcmeController.class)
public class AcmeControllerAdvice extends ResponseEntityExceptionHandler { public class AcmeControllerAdvice extends ResponseEntityExceptionHandler {
...@@ -2953,7 +2953,7 @@ To map all `5xx` errors by using a FreeMarker template, your directory structure ...@@ -2953,7 +2953,7 @@ To map all `5xx` errors by using a FreeMarker template, your directory structure
For more complex mappings, you can also add beans that implement the `ErrorViewResolver` interface, as shown in the following example: For more complex mappings, you can also add beans that implement the `ErrorViewResolver` interface, as shown in the following example:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
public class MyErrorViewResolver implements ErrorViewResolver { public class MyErrorViewResolver implements ErrorViewResolver {
...@@ -2978,7 +2978,7 @@ The `ErrorController` then picks up any unhandled exceptions. ...@@ -2978,7 +2978,7 @@ The `ErrorController` then picks up any unhandled exceptions.
For applications that do not use Spring MVC, you can use the `ErrorPageRegistrar` interface to directly register `ErrorPages`. For applications that do not use Spring MVC, you can use the `ErrorPageRegistrar` interface to directly register `ErrorPages`.
This abstraction works directly with the underlying embedded servlet container and works even if you do not have a Spring MVC `DispatcherServlet`. This abstraction works directly with the underlying embedded servlet container and works even if you do not have a Spring MVC `DispatcherServlet`.
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@Bean @Bean
public ErrorPageRegistrar errorPageRegistrar(){ public ErrorPageRegistrar errorPageRegistrar(){
...@@ -2999,7 +2999,7 @@ This abstraction works directly with the underlying embedded servlet container a ...@@ -2999,7 +2999,7 @@ This abstraction works directly with the underlying embedded servlet container a
NOTE: If you register an `ErrorPage` with a path that ends up being handled by a `Filter` (as is common with some non-Spring web frameworks, like Jersey and Wicket), then the `Filter` has to be explicitly registered as an `ERROR` dispatcher, as shown in the following example: NOTE: If you register an `ErrorPage` with a path that ends up being handled by a `Filter` (as is common with some non-Spring web frameworks, like Jersey and Wicket), then the `Filter` has to be explicitly registered as an `ERROR` dispatcher, as shown in the following example:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@Bean @Bean
public FilterRegistrationBean myFilter() { public FilterRegistrationBean myFilter() {
...@@ -3050,7 +3050,7 @@ As of version 4.2, Spring MVC {spring-framework-docs}/web.html#mvc-cors[supports ...@@ -3050,7 +3050,7 @@ As of version 4.2, Spring MVC {spring-framework-docs}/web.html#mvc-cors[supports
Using {spring-framework-docs}/web.html#mvc-cors-controller[controller method CORS configuration] with {spring-framework-api}/web/bind/annotation/CrossOrigin.html[`@CrossOrigin`] annotations in your Spring Boot application does not require any specific configuration. Using {spring-framework-docs}/web.html#mvc-cors-controller[controller method CORS configuration] with {spring-framework-api}/web/bind/annotation/CrossOrigin.html[`@CrossOrigin`] annotations in your Spring Boot application does not require any specific configuration.
{spring-framework-docs}/web.html#mvc-cors-global[Global CORS configuration] can be defined by registering a `WebMvcConfigurer` bean with a customized `addCorsMappings(CorsRegistry)` method, as shown in the following example: {spring-framework-docs}/web.html#mvc-cors-global[Global CORS configuration] can be defined by registering a `WebMvcConfigurer` bean with a customized `addCorsMappings(CorsRegistry)` method, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Configuration(proxyBeanMethods = false) @Configuration(proxyBeanMethods = false)
public class MyConfiguration { public class MyConfiguration {
...@@ -3077,7 +3077,7 @@ Unlike Spring MVC, it does not require the Servlet API, is fully asynchronous an ...@@ -3077,7 +3077,7 @@ Unlike Spring MVC, it does not require the Servlet API, is fully asynchronous an
Spring WebFlux comes in two flavors: functional and annotation-based. Spring WebFlux comes in two flavors: functional and annotation-based.
The annotation-based one is quite close to the Spring MVC model, as shown in the following example: The annotation-based one is quite close to the Spring MVC model, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@RestController @RestController
@RequestMapping("/users") @RequestMapping("/users")
...@@ -3103,7 +3103,7 @@ The annotation-based one is quite close to the Spring MVC model, as shown in the ...@@ -3103,7 +3103,7 @@ The annotation-based one is quite close to the Spring MVC model, as shown in the
"`WebFlux.fn`", the functional variant, separates the routing configuration from the actual handling of the requests, as shown in the following example: "`WebFlux.fn`", the functional variant, separates the routing configuration from the actual handling of the requests, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Configuration(proxyBeanMethods = false) @Configuration(proxyBeanMethods = false)
public class RoutingConfiguration { public class RoutingConfiguration {
...@@ -3173,7 +3173,7 @@ For example, `+spring.jackson.*+` configuration keys are applied to the Jackson ...@@ -3173,7 +3173,7 @@ For example, `+spring.jackson.*+` configuration keys are applied to the Jackson
If you need to add or customize codecs, you can create a custom `CodecCustomizer` component, as shown in the following example: If you need to add or customize codecs, you can create a custom `CodecCustomizer` component, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.boot.web.codec.CodecCustomizer; import org.springframework.boot.web.codec.CodecCustomizer;
...@@ -3258,7 +3258,7 @@ For that, you can add a bean of type `ErrorAttributes`. ...@@ -3258,7 +3258,7 @@ For that, you can add a bean of type `ErrorAttributes`.
To change the error handling behavior, you can implement `ErrorWebExceptionHandler` and register a bean definition of that type. To change the error handling behavior, you can implement `ErrorWebExceptionHandler` and register a bean definition of that type.
Because a `WebExceptionHandler` is quite low-level, Spring Boot also provides a convenient `AbstractErrorWebExceptionHandler` to let you handle errors in a WebFlux functional way, as shown in the following example: Because a `WebExceptionHandler` is quite low-level, Spring Boot also provides a convenient `AbstractErrorWebExceptionHandler` to let you handle errors in a WebFlux functional way, as shown in the following example:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
public class CustomErrorWebExceptionHandler extends AbstractErrorWebExceptionHandler { public class CustomErrorWebExceptionHandler extends AbstractErrorWebExceptionHandler {
...@@ -3350,7 +3350,7 @@ Jersey has some native Spring support, so we also provide auto-configuration sup ...@@ -3350,7 +3350,7 @@ Jersey has some native Spring support, so we also provide auto-configuration sup
To get started with Jersey, include the `spring-boot-starter-jersey` as a dependency and then you need one `@Bean` of type `ResourceConfig` in which you register all the endpoints, as shown in the following example: To get started with Jersey, include the `spring-boot-starter-jersey` as a dependency and then you need one `@Bean` of type `ResourceConfig` in which you register all the endpoints, as shown in the following example:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@Component @Component
public class JerseyConfig extends ResourceConfig { public class JerseyConfig extends ResourceConfig {
...@@ -3370,7 +3370,7 @@ For more advanced customizations, you can also register an arbitrary number of b ...@@ -3370,7 +3370,7 @@ For more advanced customizations, you can also register an arbitrary number of b
All the registered endpoints should be `@Components` with HTTP resource annotations (`@GET` and others), as shown in the following example: All the registered endpoints should be `@Components` with HTTP resource annotations (`@GET` and others), as shown in the following example:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
@Component @Component
@Path("/hello") @Path("/hello")
...@@ -3493,7 +3493,7 @@ If you need to programmatically configure your embedded servlet container, you c ...@@ -3493,7 +3493,7 @@ If you need to programmatically configure your embedded servlet container, you c
`WebServerFactoryCustomizer` provides access to the `ConfigurableServletWebServerFactory`, which includes numerous customization setter methods. `WebServerFactoryCustomizer` provides access to the `ConfigurableServletWebServerFactory`, which includes numerous customization setter methods.
The following example shows programmatically setting the port: The following example shows programmatically setting the port:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.boot.web.server.WebServerFactoryCustomizer; import org.springframework.boot.web.server.WebServerFactoryCustomizer;
import org.springframework.boot.web.servlet.server.ConfigurableServletWebServerFactory; import org.springframework.boot.web.servlet.server.ConfigurableServletWebServerFactory;
...@@ -3683,7 +3683,7 @@ This is done on purpose since this builder is stateful and you shouldn't create ...@@ -3683,7 +3683,7 @@ This is done on purpose since this builder is stateful and you shouldn't create
The following code shows a typical example: The following code shows a typical example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Service @Service
public class MyService { public class MyService {
...@@ -3767,7 +3767,7 @@ Spring Boot provides convenience methods that can be used to override access rul ...@@ -3767,7 +3767,7 @@ Spring Boot provides convenience methods that can be used to override access rul
For example, you can customize your security configuration by adding something like: For example, you can customize your security configuration by adding something like:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
include::{include-springbootfeatures}/security/CustomWebFluxSecurityConfiguration.java[tag=*] include::{include-springbootfeatures}/security/CustomWebFluxSecurityConfiguration.java[tag=*]
---- ----
...@@ -3846,7 +3846,7 @@ By default, Spring Security's `OAuth2LoginAuthenticationFilter` only processes U ...@@ -3846,7 +3846,7 @@ By default, Spring Security's `OAuth2LoginAuthenticationFilter` only processes U
If you want to customize the `redirect-uri` to use a different pattern, you need to provide configuration to process that custom pattern. If you want to customize the `redirect-uri` to use a different pattern, you need to provide configuration to process that custom pattern.
For example, for servlet applications, you can add your own `SecurityFilterChain` that resembles the following: For example, for servlet applications, you can add your own `SecurityFilterChain` that resembles the following:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Bean @Bean
public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception { public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
...@@ -4170,7 +4170,7 @@ For example, the following section in `application.properties` shows how you can ...@@ -4170,7 +4170,7 @@ For example, the following section in `application.properties` shows how you can
=== Using JdbcTemplate === Using JdbcTemplate
Spring's `JdbcTemplate` and `NamedParameterJdbcTemplate` classes are auto-configured, and you can `@Autowire` them directly into your own beans, as shown in the following example: Spring's `JdbcTemplate` and `NamedParameterJdbcTemplate` classes are auto-configured, and you can `@Autowire` them directly into your own beans, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.jdbc.core.JdbcTemplate; import org.springframework.jdbc.core.JdbcTemplate;
...@@ -4230,7 +4230,7 @@ By default, all packages below your main configuration class (the one annotated ...@@ -4230,7 +4230,7 @@ By default, all packages below your main configuration class (the one annotated
Any classes annotated with `@Entity`, `@Embeddable`, or `@MappedSuperclass` are considered. Any classes annotated with `@Entity`, `@Embeddable`, or `@MappedSuperclass` are considered.
A typical entity class resembles the following example: A typical entity class resembles the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
package com.example.myapp.domain; package com.example.myapp.domain;
...@@ -4293,7 +4293,7 @@ If you use auto-configuration, repositories are searched from the package contai ...@@ -4293,7 +4293,7 @@ If you use auto-configuration, repositories are searched from the package contai
The following example shows a typical Spring Data repository interface definition: The following example shows a typical Spring Data repository interface definition:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
package com.example.myapp.domain; package com.example.myapp.domain;
...@@ -4438,7 +4438,7 @@ The fluent API offered by jOOQ is initiated through the `org.jooq.DSLContext` in ...@@ -4438,7 +4438,7 @@ The fluent API offered by jOOQ is initiated through the `org.jooq.DSLContext` in
Spring Boot auto-configures a `DSLContext` as a Spring Bean and connects it to your application `DataSource`. Spring Boot auto-configures a `DSLContext` as a Spring Bean and connects it to your application `DataSource`.
To use the `DSLContext`, you can `@Autowire` it, as shown in the following example: To use the `DSLContext`, you can `@Autowire` it, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Component @Component
public class JooqExample implements CommandLineRunner { public class JooqExample implements CommandLineRunner {
...@@ -4457,7 +4457,7 @@ TIP: The jOOQ manual tends to use a variable named `create` to hold the `DSLCont ...@@ -4457,7 +4457,7 @@ TIP: The jOOQ manual tends to use a variable named `create` to hold the `DSLCont
You can then use the `DSLContext` to construct your queries, as shown in the following example: You can then use the `DSLContext` to construct your queries, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
public List<GregorianCalendar> authorsBornAfter1980() { public List<GregorianCalendar> authorsBornAfter1980() {
return this.create.selectFrom(AUTHOR) return this.create.selectFrom(AUTHOR)
...@@ -4512,7 +4512,7 @@ TIP: The "`How-to`" section includes a <<howto.adoc#howto-initialize-a-database- ...@@ -4512,7 +4512,7 @@ TIP: The "`How-to`" section includes a <<howto.adoc#howto-initialize-a-database-
To customize the connections created by a `ConnectionFactory`, i.e., set specific parameters that you do not want (or cannot) configure in your central database configuration, you can use a `ConnectionFactoryOptionsBuilderCustomizer` `@Bean`. To customize the connections created by a `ConnectionFactory`, i.e., set specific parameters that you do not want (or cannot) configure in your central database configuration, you can use a `ConnectionFactoryOptionsBuilderCustomizer` `@Bean`.
The following example shows how to manually override the database port while the rest of the options is taken from the application configuration: The following example shows how to manually override the database port while the rest of the options is taken from the application configuration:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Bean @Bean
public ConnectionFactoryOptionsBuilderCustomizer connectionFactoryPortCustomizer() { public ConnectionFactoryOptionsBuilderCustomizer connectionFactoryPortCustomizer() {
...@@ -4522,7 +4522,7 @@ The following example shows how to manually override the database port while the ...@@ -4522,7 +4522,7 @@ The following example shows how to manually override the database port while the
The following examples show how to set some PostgreSQL connection options: The following examples show how to set some PostgreSQL connection options:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Bean @Bean
public ConnectionFactoryOptionsBuilderCustomizer postgresCustomizer() { public ConnectionFactoryOptionsBuilderCustomizer postgresCustomizer() {
...@@ -4565,7 +4565,7 @@ If you want to make sure that each context has a separate embedded database, you ...@@ -4565,7 +4565,7 @@ If you want to make sure that each context has a separate embedded database, you
==== Using DatabaseClient ==== Using DatabaseClient
A `DatabaseClient` bean is auto-configured, and you can `@Autowire` it directly into your own beans, as shown in the following example: A `DatabaseClient` bean is auto-configured, and you can `@Autowire` it directly into your own beans, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.r2dbc.function.DatabaseClient; import org.springframework.data.r2dbc.function.DatabaseClient;
...@@ -4601,7 +4601,7 @@ If you use auto-configuration, repositories are searched from the package contai ...@@ -4601,7 +4601,7 @@ If you use auto-configuration, repositories are searched from the package contai
The following example shows a typical Spring Data repository interface definition: The following example shows a typical Spring Data repository interface definition:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
package com.example.myapp.domain; package com.example.myapp.domain;
...@@ -4658,7 +4658,7 @@ You can inject an auto-configured `RedisConnectionFactory`, `StringRedisTemplate ...@@ -4658,7 +4658,7 @@ You can inject an auto-configured `RedisConnectionFactory`, `StringRedisTemplate
By default, the instance tries to connect to a Redis server at `localhost:6379`. By default, the instance tries to connect to a Redis server at `localhost:6379`.
The following listing shows an example of such a bean: The following listing shows an example of such a bean:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Component @Component
public class MyBean { public class MyBean {
...@@ -4696,7 +4696,7 @@ To access MongoDB databases, you can inject an auto-configured `org.springframew ...@@ -4696,7 +4696,7 @@ To access MongoDB databases, you can inject an auto-configured `org.springframew
By default, the instance tries to connect to a MongoDB server at `mongodb://localhost/test`. By default, the instance tries to connect to a MongoDB server at `mongodb://localhost/test`.
The following example shows how to connect to a MongoDB database: The following example shows how to connect to a MongoDB database:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.data.mongodb.MongoDatabaseFactory; import org.springframework.data.mongodb.MongoDatabaseFactory;
import com.mongodb.client.MongoDatabase; import com.mongodb.client.MongoDatabase;
...@@ -4767,7 +4767,7 @@ The auto-configuration configures this factory automatically if Netty is availab ...@@ -4767,7 +4767,7 @@ The auto-configuration configures this factory automatically if Netty is availab
{spring-data-mongodb}[Spring Data MongoDB] provides a {spring-data-mongodb-api}/core/MongoTemplate.html[`MongoTemplate`] class that is very similar in its design to Spring's `JdbcTemplate`. {spring-data-mongodb}[Spring Data MongoDB] provides a {spring-data-mongodb-api}/core/MongoTemplate.html[`MongoTemplate`] class that is very similar in its design to Spring's `JdbcTemplate`.
As with `JdbcTemplate`, Spring Boot auto-configures a bean for you to inject the template, as follows: As with `JdbcTemplate`, Spring Boot auto-configures a bean for you to inject the template, as follows:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.data.mongodb.core.MongoTemplate; import org.springframework.data.mongodb.core.MongoTemplate;
import org.springframework.stereotype.Component; import org.springframework.stereotype.Component;
...@@ -4799,7 +4799,7 @@ As with the JPA repositories discussed earlier, the basic principle is that quer ...@@ -4799,7 +4799,7 @@ As with the JPA repositories discussed earlier, the basic principle is that quer
In fact, both Spring Data JPA and Spring Data MongoDB share the same common infrastructure. In fact, both Spring Data JPA and Spring Data MongoDB share the same common infrastructure.
You could take the JPA example from earlier and, assuming that `City` is now a MongoDB data class rather than a JPA `@Entity`, it works in the same way, as shown in the following example: You could take the JPA example from earlier and, assuming that `City` is now a MongoDB data class rather than a JPA `@Entity`, it works in the same way, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
package com.example.myapp.domain; package com.example.myapp.domain;
...@@ -4852,7 +4852,7 @@ To access a Neo4j server, you can inject an auto-configured `org.neo4j.driver.Dr ...@@ -4852,7 +4852,7 @@ To access a Neo4j server, you can inject an auto-configured `org.neo4j.driver.Dr
By default, the instance tries to connect to a Neo4j server at `localhost:7687` using the Bolt protocol. By default, the instance tries to connect to a Neo4j server at `localhost:7687` using the Bolt protocol.
The following example shows how to inject a Neo4j `Driver` that gives you access, amongst other things, to a `Session`: The following example shows how to inject a Neo4j `Driver` that gives you access, amongst other things, to a `Session`:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Component @Component
public class MyBean { public class MyBean {
...@@ -4896,7 +4896,7 @@ For complete details of Spring Data Neo4j, refer to the {spring-data-neo4j-docs} ...@@ -4896,7 +4896,7 @@ For complete details of Spring Data Neo4j, refer to the {spring-data-neo4j-docs}
Spring Data Neo4j shares the common infrastructure with Spring Data JPA as many other Spring Data modules do. Spring Data Neo4j shares the common infrastructure with Spring Data JPA as many other Spring Data modules do.
You could take the JPA example from earlier and define `City` as Spring Data Neo4j `@Node` rather than JPA `@Entity` and the repository abstraction works in the same way, as shown in the following example: You could take the JPA example from earlier and define `City` as Spring Data Neo4j `@Node` rather than JPA `@Entity` and the repository abstraction works in the same way, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
package com.example.myapp.domain; package com.example.myapp.domain;
...@@ -4943,7 +4943,7 @@ You can inject an auto-configured `SolrClient` instance as you would any other S ...@@ -4943,7 +4943,7 @@ You can inject an auto-configured `SolrClient` instance as you would any other S
By default, the instance tries to connect to a server at `http://localhost:8983/solr`. By default, the instance tries to connect to a server at `http://localhost:8983/solr`.
The following example shows how to inject a Solr bean: The following example shows how to inject a Solr bean:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Component @Component
public class MyBean { public class MyBean {
...@@ -5053,7 +5053,7 @@ With this configuration in place, an ...@@ -5053,7 +5053,7 @@ With this configuration in place, an
`ElasticsearchRestTemplate` can be injected like any other Spring bean, `ElasticsearchRestTemplate` can be injected like any other Spring bean,
as shown in the following example: as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Component @Component
public class MyBean { public class MyBean {
...@@ -5154,7 +5154,7 @@ NOTE: If you're using `CqlSessionBuilder` to create multiple `CqlSession` beans, ...@@ -5154,7 +5154,7 @@ NOTE: If you're using `CqlSessionBuilder` to create multiple `CqlSession` beans,
The following code listing shows how to inject a Cassandra bean: The following code listing shows how to inject a Cassandra bean:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Component @Component
public class MyBean { public class MyBean {
...@@ -5244,7 +5244,7 @@ This happens when a `Cluster` is available, as described above, and a bucket nam ...@@ -5244,7 +5244,7 @@ This happens when a `Cluster` is available, as described above, and a bucket nam
The following examples shows how to inject a `CouchbaseTemplate` bean: The following examples shows how to inject a `CouchbaseTemplate` bean:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Component @Component
public class MyBean { public class MyBean {
...@@ -5270,7 +5270,7 @@ There are a few beans that you can define in your own configuration to override ...@@ -5270,7 +5270,7 @@ There are a few beans that you can define in your own configuration to override
To avoid hard-coding those names in your own config, you can reuse `BeanNames` provided by Spring Data Couchbase. To avoid hard-coding those names in your own config, you can reuse `BeanNames` provided by Spring Data Couchbase.
For instance, you can customize the converters to use, as follows: For instance, you can customize the converters to use, as follows:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Configuration(proxyBeanMethods = false) @Configuration(proxyBeanMethods = false)
public class SomeConfiguration { public class SomeConfiguration {
...@@ -5327,7 +5327,7 @@ For complete details of Spring Data LDAP, refer to the https://docs.spring.io/sp ...@@ -5327,7 +5327,7 @@ For complete details of Spring Data LDAP, refer to the https://docs.spring.io/sp
You can also inject an auto-configured `LdapTemplate` instance as you would with any other Spring Bean, as shown in the following example: You can also inject an auto-configured `LdapTemplate` instance as you would with any other Spring Bean, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Component @Component
public class MyBean { public class MyBean {
...@@ -5420,7 +5420,7 @@ NOTE: Check the {spring-framework-docs}/integration.html#cache[relevant section] ...@@ -5420,7 +5420,7 @@ NOTE: Check the {spring-framework-docs}/integration.html#cache[relevant section]
In a nutshell, to add caching to an operation of your service add the relevant annotation to its method, as shown in the following example: In a nutshell, to add caching to an operation of your service add the relevant annotation to its method, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.cache.annotation.Cacheable; import org.springframework.cache.annotation.Cacheable;
import org.springframework.stereotype.Component; import org.springframework.stereotype.Component;
...@@ -5481,7 +5481,7 @@ If you add dependencies manually, you must include `spring-context-support` in o ...@@ -5481,7 +5481,7 @@ If you add dependencies manually, you must include `spring-context-support` in o
If the `CacheManager` is auto-configured by Spring Boot, you can further tune its configuration before it is fully initialized by exposing a bean that implements the `CacheManagerCustomizer` interface. If the `CacheManager` is auto-configured by Spring Boot, you can further tune its configuration before it is fully initialized by exposing a bean that implements the `CacheManagerCustomizer` interface.
The following example sets a flag to say that `null` values should be passed down to the underlying map: The following example sets a flag to say that `null` values should be passed down to the underlying map:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Bean @Bean
public CacheManagerCustomizer<ConcurrentMapCacheManager> cacheManagerCustomizer() { public CacheManagerCustomizer<ConcurrentMapCacheManager> cacheManagerCustomizer() {
...@@ -5844,7 +5844,7 @@ You can use the configprop:spring.jms.jndi-name[] property if you need to specif ...@@ -5844,7 +5844,7 @@ You can use the configprop:spring.jms.jndi-name[] property if you need to specif
==== Sending a Message ==== Sending a Message
Spring's `JmsTemplate` is auto-configured, and you can autowire it directly into your own beans, as shown in the following example: Spring's `JmsTemplate` is auto-configured, and you can autowire it directly into your own beans, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.jms.core.JmsTemplate; import org.springframework.jms.core.JmsTemplate;
...@@ -5885,7 +5885,7 @@ This also includes sending response messages that have been performed on the sam ...@@ -5885,7 +5885,7 @@ This also includes sending response messages that have been performed on the sam
The following component creates a listener endpoint on the `someQueue` destination: The following component creates a listener endpoint on the `someQueue` destination:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Component @Component
public class MyBean { public class MyBean {
...@@ -5904,7 +5904,7 @@ If you need to create more `JmsListenerContainerFactory` instances or if you wan ...@@ -5904,7 +5904,7 @@ If you need to create more `JmsListenerContainerFactory` instances or if you wan
For instance, the following example exposes another factory that uses a specific `MessageConverter`: For instance, the following example exposes another factory that uses a specific `MessageConverter`:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Configuration(proxyBeanMethods = false) @Configuration(proxyBeanMethods = false)
static class JmsConfiguration { static class JmsConfiguration {
...@@ -5924,8 +5924,7 @@ For instance, the following example exposes another factory that uses a specific ...@@ -5924,8 +5924,7 @@ For instance, the following example exposes another factory that uses a specific
Then you can use the factory in any `@JmsListener`-annotated method as follows: Then you can use the factory in any `@JmsListener`-annotated method as follows:
[source,java,indent=0] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes"]
[subs="verbatim,quotes"]
---- ----
@Component @Component
public class MyBean { public class MyBean {
...@@ -5989,7 +5988,7 @@ TIP: See https://spring.io/blog/2010/06/14/understanding-amqp-the-protocol-used- ...@@ -5989,7 +5988,7 @@ TIP: See https://spring.io/blog/2010/06/14/understanding-amqp-the-protocol-used-
==== Sending a Message ==== Sending a Message
Spring's `AmqpTemplate` and `AmqpAdmin` are auto-configured, and you can autowire them directly into your own beans, as shown in the following example: Spring's `AmqpTemplate` and `AmqpAdmin` are auto-configured, and you can autowire them directly into your own beans, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.amqp.core.AmqpAdmin; import org.springframework.amqp.core.AmqpAdmin;
import org.springframework.amqp.core.AmqpTemplate; import org.springframework.amqp.core.AmqpTemplate;
...@@ -6045,7 +6044,7 @@ If a `MessageConverter` or a `MessageRecoverer` bean is defined, it is automatic ...@@ -6045,7 +6044,7 @@ If a `MessageConverter` or a `MessageRecoverer` bean is defined, it is automatic
The following sample component creates a listener endpoint on the `someQueue` queue: The following sample component creates a listener endpoint on the `someQueue` queue:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Component @Component
public class MyBean { public class MyBean {
...@@ -6067,7 +6066,7 @@ Those two beans are exposed by the auto-configuration. ...@@ -6067,7 +6066,7 @@ Those two beans are exposed by the auto-configuration.
For instance, the following configuration class exposes another factory that uses a specific `MessageConverter`: For instance, the following configuration class exposes another factory that uses a specific `MessageConverter`:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Configuration(proxyBeanMethods = false) @Configuration(proxyBeanMethods = false)
static class RabbitConfiguration { static class RabbitConfiguration {
...@@ -6087,7 +6086,7 @@ For instance, the following configuration class exposes another factory that use ...@@ -6087,7 +6086,7 @@ For instance, the following configuration class exposes another factory that use
Then you can use the factory in any `@RabbitListener`-annotated method, as follows: Then you can use the factory in any `@RabbitListener`-annotated method, as follows:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
[subs="verbatim,quotes"] [subs="verbatim,quotes"]
---- ----
@Component @Component
...@@ -6140,7 +6139,7 @@ See {spring-boot-autoconfigure-module-code}/kafka/KafkaProperties.java[`KafkaPro ...@@ -6140,7 +6139,7 @@ See {spring-boot-autoconfigure-module-code}/kafka/KafkaProperties.java[`KafkaPro
==== Sending a Message ==== Sending a Message
Spring's `KafkaTemplate` is auto-configured, and you can autowire it directly in your own beans, as shown in the following example: Spring's `KafkaTemplate` is auto-configured, and you can autowire it directly in your own beans, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Component @Component
public class MyBean { public class MyBean {
...@@ -6169,7 +6168,7 @@ If no `KafkaListenerContainerFactory` has been defined, a default one is automat ...@@ -6169,7 +6168,7 @@ If no `KafkaListenerContainerFactory` has been defined, a default one is automat
The following component creates a listener endpoint on the `someTopic` topic: The following component creates a listener endpoint on the `someTopic` topic:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Component @Component
public class MyBean { public class MyBean {
...@@ -6291,7 +6290,7 @@ There are several ways to do that: ...@@ -6291,7 +6290,7 @@ There are several ways to do that:
* Provide a system property to map embedded broker addresses into configprop:spring.kafka.bootstrap-servers[] in the test class: * Provide a system property to map embedded broker addresses into configprop:spring.kafka.bootstrap-servers[] in the test class:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
static { static {
System.setProperty(EmbeddedKafkaBroker.BROKER_LIST_PROPERTY, "spring.kafka.bootstrap-servers"); System.setProperty(EmbeddedKafkaBroker.BROKER_LIST_PROPERTY, "spring.kafka.bootstrap-servers");
...@@ -6300,7 +6299,7 @@ There are several ways to do that: ...@@ -6300,7 +6299,7 @@ There are several ways to do that:
* Configure a property name on the `@EmbeddedKafka` annotation: * Configure a property name on the `@EmbeddedKafka` annotation:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@EmbeddedKafka(topics = "someTopic", @EmbeddedKafka(topics = "someTopic",
bootstrapServersProperty = "spring.kafka.bootstrap-servers") bootstrapServersProperty = "spring.kafka.bootstrap-servers")
...@@ -6326,7 +6325,7 @@ The auto-configured `RestTemplateBuilder` ensures that sensible `HttpMessageConv ...@@ -6326,7 +6325,7 @@ The auto-configured `RestTemplateBuilder` ensures that sensible `HttpMessageConv
The following code shows a typical example: The following code shows a typical example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Service @Service
public class MyService { public class MyService {
...@@ -6391,7 +6390,7 @@ Spring Boot is configuring that builder to share HTTP resources, reflect codecs ...@@ -6391,7 +6390,7 @@ Spring Boot is configuring that builder to share HTTP resources, reflect codecs
The following code shows a typical example: The following code shows a typical example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Service @Service
public class MyService { public class MyService {
...@@ -6452,7 +6451,7 @@ Target classes with such annotated methods need to be annotated with the `@Valid ...@@ -6452,7 +6451,7 @@ Target classes with such annotated methods need to be annotated with the `@Valid
For instance, the following service triggers the validation of the first argument, making sure its size is between 8 and 10: For instance, the following service triggers the validation of the first argument, making sure its size is between 8 and 10:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Service @Service
@Validated @Validated
...@@ -6552,7 +6551,7 @@ For consistency, the `jmsConnectionFactory` bean is also provided by using the b ...@@ -6552,7 +6551,7 @@ For consistency, the `jmsConnectionFactory` bean is also provided by using the b
The following example shows how to inject `ConnectionFactory` instances: The following example shows how to inject `ConnectionFactory` instances:
[source,java,indent=0,subs="verbatim,quotes,attributes"] [source,java,pending-extract=true,indent=0,subs="verbatim,quotes,attributes"]
---- ----
// Inject the primary (XA aware) ConnectionFactory // Inject the primary (XA aware) ConnectionFactory
@Autowired @Autowired
...@@ -6670,7 +6669,7 @@ If you need to customize the task executor, consider implementing `SchedulerFact ...@@ -6670,7 +6669,7 @@ If you need to customize the task executor, consider implementing `SchedulerFact
Jobs can define setters to inject data map properties. Jobs can define setters to inject data map properties.
Regular beans can also be injected in a similar manner, as shown in the following example: Regular beans can also be injected in a similar manner, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
public class SampleJob extends QuartzJobBean { public class SampleJob extends QuartzJobBean {
...@@ -6954,7 +6953,7 @@ If you have only Spring WebFlux, we'll detect that and configure a WebFlux-based ...@@ -6954,7 +6953,7 @@ If you have only Spring WebFlux, we'll detect that and configure a WebFlux-based
If both are present, Spring MVC takes precedence. If both are present, Spring MVC takes precedence.
If you want to test a reactive web application in this scenario, you must set the configprop:spring.main.web-application-type[] property: If you want to test a reactive web application in this scenario, you must set the configprop:spring.main.web-application-type[] property:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@SpringBootTest(properties = "spring.main.web-application-type=reactive") @SpringBootTest(properties = "spring.main.web-application-type=reactive")
class MyWebFluxTests { ... } class MyWebFluxTests { ... }
...@@ -6998,7 +6997,7 @@ As we <<boot-features-testing-spring-boot-applications-detecting-config,have see ...@@ -6998,7 +6997,7 @@ As we <<boot-features-testing-spring-boot-applications-detecting-config,have see
When placed on a top-level class, `@TestConfiguration` indicates that classes in `src/test/java` should not be picked up by scanning. When placed on a top-level class, `@TestConfiguration` indicates that classes in `src/test/java` should not be picked up by scanning.
You can then import that class explicitly where it is required, as shown in the following example: You can then import that class explicitly where it is required, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@SpringBootTest @SpringBootTest
@Import(MyTestsConfiguration.class) @Import(MyTestsConfiguration.class)
...@@ -7128,7 +7127,7 @@ Mock beans are automatically reset after each test method. ...@@ -7128,7 +7127,7 @@ Mock beans are automatically reset after each test method.
If your test uses one of Spring Boot's test annotations (such as `@SpringBootTest`), this feature is automatically enabled. If your test uses one of Spring Boot's test annotations (such as `@SpringBootTest`), this feature is automatically enabled.
To use this feature with a different arrangement, a listener must be explicitly added, as shown in the following example: To use this feature with a different arrangement, a listener must be explicitly added, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@TestExecutionListeners(MockitoTestExecutionListener.class) @TestExecutionListeners(MockitoTestExecutionListener.class)
---- ----
...@@ -7137,7 +7136,7 @@ To use this feature with a different arrangement, a listener must be explicitly ...@@ -7137,7 +7136,7 @@ To use this feature with a different arrangement, a listener must be explicitly
The following example replaces an existing `RemoteService` bean with a mock implementation: The following example replaces an existing `RemoteService` bean with a mock implementation:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.junit.jupiter.api.Test; import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.*; import org.springframework.beans.factory.annotation.*;
...@@ -7228,7 +7227,7 @@ The `JacksonTester`, `GsonTester`, `JsonbTester`, and `BasicJsonTester` classes ...@@ -7228,7 +7227,7 @@ The `JacksonTester`, `GsonTester`, `JsonbTester`, and `BasicJsonTester` classes
Any helper fields on the test class can be `@Autowired` when using `@JsonTest`. Any helper fields on the test class can be `@Autowired` when using `@JsonTest`.
The following example shows a test class for Jackson: The following example shows a test class for Jackson:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.junit.jupiter.api.Test; import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.*; import org.springframework.beans.factory.annotation.*;
...@@ -7273,11 +7272,11 @@ If you're using Spring Boot's AssertJ-based helpers to assert on a number value ...@@ -7273,11 +7272,11 @@ If you're using Spring Boot's AssertJ-based helpers to assert on a number value
Instead, you can use AssertJ's `satisfies` to assert that the value matches the given condition. Instead, you can use AssertJ's `satisfies` to assert that the value matches the given condition.
For instance, the following example asserts that the actual number is a float value close to `0.15` within an offset of `0.01`. For instance, the following example asserts that the actual number is a float value close to `0.15` within an offset of `0.01`.
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
assertThat(json.write(message)) assertThat(json.write(message))
.extractingJsonPathNumberValue("@.test.numberValue") .extractingJsonPathNumberValue("@.test.numberValue")
.satisfies((number) -> assertThat(number.floatValue()).isCloseTo(0.15f, within(0.01f))); .satisfies((number) -> assertThat(number.floatValue()).isCloseTo(0.15f, within(0.01f)));
---- ----
...@@ -7301,7 +7300,7 @@ Mock MVC offers a powerful way to quickly test MVC controllers without needing t ...@@ -7301,7 +7300,7 @@ Mock MVC offers a powerful way to quickly test MVC controllers without needing t
TIP: You can also auto-configure `MockMvc` in a non-`@WebMvcTest` (such as `@SpringBootTest`) by annotating it with `@AutoConfigureMockMvc`. TIP: You can also auto-configure `MockMvc` in a non-`@WebMvcTest` (such as `@SpringBootTest`) by annotating it with `@AutoConfigureMockMvc`.
The following example uses `MockMvc`: The following example uses `MockMvc`:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.junit.jupiter.api.*; import org.junit.jupiter.api.*;
import org.springframework.beans.factory.annotation.*; import org.springframework.beans.factory.annotation.*;
...@@ -7338,7 +7337,7 @@ TIP: If you need to configure elements of the auto-configuration (for example, w ...@@ -7338,7 +7337,7 @@ TIP: If you need to configure elements of the auto-configuration (for example, w
If you use HtmlUnit or Selenium, auto-configuration also provides an HtmlUnit `WebClient` bean and/or a Selenium `WebDriver` bean. If you use HtmlUnit or Selenium, auto-configuration also provides an HtmlUnit `WebClient` bean and/or a Selenium `WebDriver` bean.
The following example uses HtmlUnit: The following example uses HtmlUnit:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import com.gargoylesoftware.htmlunit.*; import com.gargoylesoftware.htmlunit.*;
import org.junit.jupiter.api.*; import org.junit.jupiter.api.*;
...@@ -7401,7 +7400,7 @@ Often, `@WebFluxTest` is limited to a single controller and used in combination ...@@ -7401,7 +7400,7 @@ Often, `@WebFluxTest` is limited to a single controller and used in combination
TIP: You can also auto-configure `WebTestClient` in a non-`@WebFluxTest` (such as `@SpringBootTest`) by annotating it with `@AutoConfigureWebTestClient`. TIP: You can also auto-configure `WebTestClient` in a non-`@WebFluxTest` (such as `@SpringBootTest`) by annotating it with `@AutoConfigureWebTestClient`.
The following example shows a class that uses both `@WebFluxTest` and a `WebTestClient`: The following example shows a class that uses both `@WebFluxTest` and a `WebTestClient`:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.junit.jupiter.api.Test; import org.junit.jupiter.api.Test;
...@@ -7456,7 +7455,7 @@ TIP: A list of the auto-configuration settings that are enabled by `@DataCassand ...@@ -7456,7 +7455,7 @@ TIP: A list of the auto-configuration settings that are enabled by `@DataCassand
The following example shows a typical setup for using Cassandra tests in Spring Boot: The following example shows a typical setup for using Cassandra tests in Spring Boot:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.data.cassandra.DataCassandraTest; import org.springframework.boot.test.autoconfigure.data.cassandra.DataCassandraTest;
...@@ -7487,7 +7486,7 @@ By default, data JPA tests are transactional and roll back at the end of each te ...@@ -7487,7 +7486,7 @@ By default, data JPA tests are transactional and roll back at the end of each te
See the {spring-framework-docs}/testing.html#testcontext-tx-enabling-transactions[relevant section] in the Spring Framework Reference Documentation for more details. See the {spring-framework-docs}/testing.html#testcontext-tx-enabling-transactions[relevant section] in the Spring Framework Reference Documentation for more details.
If that is not what you want, you can disable transaction management for a test or for the whole class as follows: If that is not what you want, you can disable transaction management for a test or for the whole class as follows:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.junit.jupiter.api.Test; import org.junit.jupiter.api.Test;
import org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTest; import org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTest;
...@@ -7506,7 +7505,7 @@ If you want to use `TestEntityManager` outside of `@DataJpaTest` instances, you ...@@ -7506,7 +7505,7 @@ If you want to use `TestEntityManager` outside of `@DataJpaTest` instances, you
A `JdbcTemplate` is also available if you need that. A `JdbcTemplate` is also available if you need that.
The following example shows the `@DataJpaTest` annotation in use: The following example shows the `@DataJpaTest` annotation in use:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.junit.jupiter.api.Test; import org.junit.jupiter.api.Test;
import org.springframework.boot.test.autoconfigure.orm.jpa.*; import org.springframework.boot.test.autoconfigure.orm.jpa.*;
...@@ -7536,7 +7535,7 @@ The following example shows the `@DataJpaTest` annotation in use: ...@@ -7536,7 +7535,7 @@ The following example shows the `@DataJpaTest` annotation in use:
In-memory embedded databases generally work well for tests, since they are fast and do not require any installation. In-memory embedded databases generally work well for tests, since they are fast and do not require any installation.
If, however, you prefer to run tests against a real database you can use the `@AutoConfigureTestDatabase` annotation, as shown in the following example: If, however, you prefer to run tests against a real database you can use the `@AutoConfigureTestDatabase` annotation, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@DataJpaTest @DataJpaTest
@AutoConfigureTestDatabase(replace=Replace.NONE) @AutoConfigureTestDatabase(replace=Replace.NONE)
...@@ -7562,7 +7561,7 @@ By default, JDBC tests are transactional and roll back at the end of each test. ...@@ -7562,7 +7561,7 @@ By default, JDBC tests are transactional and roll back at the end of each test.
See the {spring-framework-docs}/testing.html#testcontext-tx-enabling-transactions[relevant section] in the Spring Framework Reference Documentation for more details. See the {spring-framework-docs}/testing.html#testcontext-tx-enabling-transactions[relevant section] in the Spring Framework Reference Documentation for more details.
If that is not what you want, you can disable transaction management for a test or for the whole class, as follows: If that is not what you want, you can disable transaction management for a test or for the whole class, as follows:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.junit.jupiter.api.Test; import org.junit.jupiter.api.Test;
import org.springframework.boot.test.autoconfigure.jdbc.JdbcTest; import org.springframework.boot.test.autoconfigure.jdbc.JdbcTest;
...@@ -7613,7 +7612,7 @@ TIP: A list of the auto-configurations that are enabled by `@JooqTest` can be << ...@@ -7613,7 +7612,7 @@ TIP: A list of the auto-configurations that are enabled by `@JooqTest` can be <<
`@JooqTest` configures a `DSLContext`. `@JooqTest` configures a `DSLContext`.
The following example shows the `@JooqTest` annotation in use: The following example shows the `@JooqTest` annotation in use:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.jooq.DSLContext; import org.jooq.DSLContext;
import org.junit.jupiter.api.Test; import org.junit.jupiter.api.Test;
...@@ -7644,7 +7643,7 @@ TIP: A list of the auto-configuration settings that are enabled by `@DataMongoTe ...@@ -7644,7 +7643,7 @@ TIP: A list of the auto-configuration settings that are enabled by `@DataMongoTe
The following class shows the `@DataMongoTest` annotation in use: The following class shows the `@DataMongoTest` annotation in use:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.data.mongo.DataMongoTest; import org.springframework.boot.test.autoconfigure.data.mongo.DataMongoTest;
...@@ -7663,7 +7662,7 @@ The following class shows the `@DataMongoTest` annotation in use: ...@@ -7663,7 +7662,7 @@ The following class shows the `@DataMongoTest` annotation in use:
In-memory embedded MongoDB generally works well for tests, since it is fast and does not require any developer installation. In-memory embedded MongoDB generally works well for tests, since it is fast and does not require any developer installation.
If, however, you prefer to run tests against a real MongoDB server, you should exclude the embedded MongoDB auto-configuration, as shown in the following example: If, however, you prefer to run tests against a real MongoDB server, you should exclude the embedded MongoDB auto-configuration, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.boot.autoconfigure.mongo.embedded.EmbeddedMongoAutoConfiguration; import org.springframework.boot.autoconfigure.mongo.embedded.EmbeddedMongoAutoConfiguration;
import org.springframework.boot.test.autoconfigure.data.mongo.DataMongoTest; import org.springframework.boot.test.autoconfigure.data.mongo.DataMongoTest;
...@@ -7688,7 +7687,7 @@ TIP: A list of the auto-configuration settings that are enabled by `@DataNeo4jTe ...@@ -7688,7 +7687,7 @@ TIP: A list of the auto-configuration settings that are enabled by `@DataNeo4jTe
The following example shows a typical setup for using Neo4J tests in Spring Boot: The following example shows a typical setup for using Neo4J tests in Spring Boot:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.data.neo4j.DataNeo4jTest; import org.springframework.boot.test.autoconfigure.data.neo4j.DataNeo4jTest;
...@@ -7707,7 +7706,7 @@ By default, Data Neo4j tests are transactional and roll back at the end of each ...@@ -7707,7 +7706,7 @@ By default, Data Neo4j tests are transactional and roll back at the end of each
See the {spring-framework-docs}/testing.html#testcontext-tx-enabling-transactions[relevant section] in the Spring Framework Reference Documentation for more details. See the {spring-framework-docs}/testing.html#testcontext-tx-enabling-transactions[relevant section] in the Spring Framework Reference Documentation for more details.
If that is not what you want, you can disable transaction management for a test or for the whole class, as follows: If that is not what you want, you can disable transaction management for a test or for the whole class, as follows:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.boot.test.autoconfigure.data.neo4j.DataNeo4jTest; import org.springframework.boot.test.autoconfigure.data.neo4j.DataNeo4jTest;
import org.springframework.transaction.annotation.Propagation; import org.springframework.transaction.annotation.Propagation;
...@@ -7737,7 +7736,7 @@ TIP: A list of the auto-configuration settings that are enabled by `@DataRedisTe ...@@ -7737,7 +7736,7 @@ TIP: A list of the auto-configuration settings that are enabled by `@DataRedisTe
The following example shows the `@DataRedisTest` annotation in use: The following example shows the `@DataRedisTest` annotation in use:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.data.redis.DataRedisTest; import org.springframework.boot.test.autoconfigure.data.redis.DataRedisTest;
...@@ -7766,7 +7765,7 @@ TIP: A list of the auto-configuration settings that are enabled by `@DataLdapTes ...@@ -7766,7 +7765,7 @@ TIP: A list of the auto-configuration settings that are enabled by `@DataLdapTes
The following example shows the `@DataLdapTest` annotation in use: The following example shows the `@DataLdapTest` annotation in use:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.data.ldap.DataLdapTest; import org.springframework.boot.test.autoconfigure.data.ldap.DataLdapTest;
...@@ -7785,7 +7784,7 @@ The following example shows the `@DataLdapTest` annotation in use: ...@@ -7785,7 +7784,7 @@ The following example shows the `@DataLdapTest` annotation in use:
In-memory embedded LDAP generally works well for tests, since it is fast and does not require any developer installation. In-memory embedded LDAP generally works well for tests, since it is fast and does not require any developer installation.
If, however, you prefer to run tests against a real LDAP server, you should exclude the embedded LDAP auto-configuration, as shown in the following example: If, however, you prefer to run tests against a real LDAP server, you should exclude the embedded LDAP auto-configuration, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.boot.autoconfigure.ldap.embedded.EmbeddedLdapAutoConfiguration; import org.springframework.boot.autoconfigure.ldap.embedded.EmbeddedLdapAutoConfiguration;
import org.springframework.boot.test.autoconfigure.data.ldap.DataLdapTest; import org.springframework.boot.test.autoconfigure.data.ldap.DataLdapTest;
...@@ -7809,7 +7808,7 @@ TIP: A list of the auto-configuration settings that are enabled by `@RestClientT ...@@ -7809,7 +7808,7 @@ TIP: A list of the auto-configuration settings that are enabled by `@RestClientT
The specific beans that you want to test should be specified by using the `value` or `components` attribute of `@RestClientTest`, as shown in the following example: The specific beans that you want to test should be specified by using the `value` or `components` attribute of `@RestClientTest`, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@RestClientTest(RemoteVehicleDetailsService.class) @RestClientTest(RemoteVehicleDetailsService.class)
class ExampleRestClientTest { class ExampleRestClientTest {
...@@ -7849,7 +7848,7 @@ It can also be used to configure the host, scheme, and port that appears in any ...@@ -7849,7 +7848,7 @@ It can also be used to configure the host, scheme, and port that appears in any
`@AutoConfigureRestDocs` customizes the `MockMvc` bean to use Spring REST Docs when testing Servlet-based web applications. `@AutoConfigureRestDocs` customizes the `MockMvc` bean to use Spring REST Docs when testing Servlet-based web applications.
You can inject it by using `@Autowired` and use it in your tests as you normally would when using Mock MVC and Spring REST Docs, as shown in the following example: You can inject it by using `@Autowired` and use it in your tests as you normally would when using Mock MVC and Spring REST Docs, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.junit.jupiter.api.Test; import org.junit.jupiter.api.Test;
...@@ -7881,7 +7880,7 @@ You can inject it by using `@Autowired` and use it in your tests as you normally ...@@ -7881,7 +7880,7 @@ You can inject it by using `@Autowired` and use it in your tests as you normally
If you require more control over Spring REST Docs configuration than offered by the attributes of `@AutoConfigureRestDocs`, you can use a `RestDocsMockMvcConfigurationCustomizer` bean, as shown in the following example: If you require more control over Spring REST Docs configuration than offered by the attributes of `@AutoConfigureRestDocs`, you can use a `RestDocsMockMvcConfigurationCustomizer` bean, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@TestConfiguration @TestConfiguration
static class CustomizationConfiguration static class CustomizationConfiguration
...@@ -7899,7 +7898,7 @@ If you want to make use of Spring REST Docs support for a parameterized output d ...@@ -7899,7 +7898,7 @@ If you want to make use of Spring REST Docs support for a parameterized output d
The auto-configuration calls `alwaysDo` with this result handler, thereby causing each `MockMvc` call to automatically generate the default snippets. The auto-configuration calls `alwaysDo` with this result handler, thereby causing each `MockMvc` call to automatically generate the default snippets.
The following example shows a `RestDocumentationResultHandler` being defined: The following example shows a `RestDocumentationResultHandler` being defined:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@TestConfiguration(proxyBeanMethods = false) @TestConfiguration(proxyBeanMethods = false)
static class ResultHandlerConfiguration { static class ResultHandlerConfiguration {
...@@ -7963,7 +7962,7 @@ TIP: A list of the auto-configuration settings that are enabled by `@WebServiceC ...@@ -7963,7 +7962,7 @@ TIP: A list of the auto-configuration settings that are enabled by `@WebServiceC
The following example shows the `@WebServiceClientTest` annotation in use: The following example shows the `@WebServiceClientTest` annotation in use:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@WebServiceClientTest(ExampleWebServiceClient.class) @WebServiceClientTest(ExampleWebServiceClient.class)
class WebServiceClientIntegrationTests { class WebServiceClientIntegrationTests {
...@@ -7991,7 +7990,7 @@ The following example shows the `@WebServiceClientTest` annotation in use: ...@@ -7991,7 +7990,7 @@ The following example shows the `@WebServiceClientTest` annotation in use:
Each slice provides one or more `@AutoConfigure...` annotations that namely defines the auto-configurations that should be included as part of a slice. Each slice provides one or more `@AutoConfigure...` annotations that namely defines the auto-configurations that should be included as part of a slice.
Additional auto-configurations can be added on a test-by-test basis by creating a custom `@AutoConfigure...` annotation or by adding `@ImportAutoConfiguration` to the test as shown in the following example: Additional auto-configurations can be added on a test-by-test basis by creating a custom `@AutoConfigure...` annotation or by adding `@ImportAutoConfiguration` to the test as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@JdbcTest @JdbcTest
@ImportAutoConfiguration(IntegrationAutoConfiguration.class) @ImportAutoConfiguration(IntegrationAutoConfiguration.class)
...@@ -8022,7 +8021,7 @@ It then becomes important not to litter the application's main class with config ...@@ -8022,7 +8021,7 @@ It then becomes important not to litter the application's main class with config
Assume that you are using Spring Batch and you rely on the auto-configuration for it. Assume that you are using Spring Batch and you rely on the auto-configuration for it.
You could define your `@SpringBootApplication` as follows: You could define your `@SpringBootApplication` as follows:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@SpringBootApplication @SpringBootApplication
@EnableBatchProcessing @EnableBatchProcessing
...@@ -8032,7 +8031,7 @@ You could define your `@SpringBootApplication` as follows: ...@@ -8032,7 +8031,7 @@ You could define your `@SpringBootApplication` as follows:
Because this class is the source configuration for the test, any slice test actually tries to start Spring Batch, which is definitely not what you want to do. Because this class is the source configuration for the test, any slice test actually tries to start Spring Batch, which is definitely not what you want to do.
A recommended approach is to move that area-specific configuration to a separate `@Configuration` class at the same level as your application, as shown in the following example: A recommended approach is to move that area-specific configuration to a separate `@Configuration` class at the same level as your application, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Configuration(proxyBeanMethods = false) @Configuration(proxyBeanMethods = false)
@EnableBatchProcessing @EnableBatchProcessing
...@@ -8045,7 +8044,7 @@ The latter approach lets you enable it in one of your tests, if necessary, with ...@@ -8045,7 +8044,7 @@ The latter approach lets you enable it in one of your tests, if necessary, with
Test slices exclude `@Configuration` classes from scanning. Test slices exclude `@Configuration` classes from scanning.
For example, for a `@WebMvcTest`, the following configuration will not include the given `WebMvcConfigurer` bean in the application context loaded by the test slice: For example, for a `@WebMvcTest`, the following configuration will not include the given `WebMvcConfigurer` bean in the application context loaded by the test slice:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Configuration @Configuration
public class WebConfiguration { public class WebConfiguration {
...@@ -8060,7 +8059,7 @@ For example, for a `@WebMvcTest`, the following configuration will not include t ...@@ -8060,7 +8059,7 @@ For example, for a `@WebMvcTest`, the following configuration will not include t
The configuration below will, however, cause the custom `WebMvcConfigurer` to be loaded by the test slice. The configuration below will, however, cause the custom `WebMvcConfigurer` to be loaded by the test slice.
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Component @Component
public class TestWebMvcConfigurer implements WebMvcConfigurer { public class TestWebMvcConfigurer implements WebMvcConfigurer {
...@@ -8072,7 +8071,7 @@ Another source of confusion is classpath scanning. ...@@ -8072,7 +8071,7 @@ Another source of confusion is classpath scanning.
Assume that, while you structured your code in a sensible way, you need to scan an additional package. Assume that, while you structured your code in a sensible way, you need to scan an additional package.
Your application may resemble the following code: Your application may resemble the following code:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@SpringBootApplication @SpringBootApplication
@ComponentScan({ "com.example.app", "org.acme.another" }) @ComponentScan({ "com.example.app", "org.acme.another" })
...@@ -8110,7 +8109,7 @@ A few test utility classes that are generally useful when testing your applicati ...@@ -8110,7 +8109,7 @@ A few test utility classes that are generally useful when testing your applicati
`ConfigFileApplicationContextInitializer` is an `ApplicationContextInitializer` that you can apply to your tests to load Spring Boot `application.properties` files. `ConfigFileApplicationContextInitializer` is an `ApplicationContextInitializer` that you can apply to your tests to load Spring Boot `application.properties` files.
You can use it when you do not need the full set of features provided by `@SpringBootTest`, as shown in the following example: You can use it when you do not need the full set of features provided by `@SpringBootTest`, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@ContextConfiguration(classes = Config.class, @ContextConfiguration(classes = Config.class,
initializers = ConfigFileApplicationContextInitializer.class) initializers = ConfigFileApplicationContextInitializer.class)
...@@ -8127,7 +8126,7 @@ For `@Value` support, you need to either additionally configure a `PropertySourc ...@@ -8127,7 +8126,7 @@ For `@Value` support, you need to either additionally configure a `PropertySourc
`TestPropertyValues` lets you quickly add properties to a `ConfigurableEnvironment` or `ConfigurableApplicationContext`. `TestPropertyValues` lets you quickly add properties to a `ConfigurableEnvironment` or `ConfigurableApplicationContext`.
You can call it with `key=value` strings, as follows: You can call it with `key=value` strings, as follows:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
TestPropertyValues.of("org=Spring", "name=Boot").applyTo(env); TestPropertyValues.of("org=Spring", "name=Boot").applyTo(env);
---- ----
...@@ -8164,7 +8163,7 @@ If you do use Apache's HTTP client, some additional test-friendly features are e ...@@ -8164,7 +8163,7 @@ If you do use Apache's HTTP client, some additional test-friendly features are e
`TestRestTemplate` can be instantiated directly in your integration tests, as shown in the following example: `TestRestTemplate` can be instantiated directly in your integration tests, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
public class MyTest { public class MyTest {
...@@ -8237,7 +8236,7 @@ It does, however, auto-configure a `WebServiceTemplateBuilder`, which can be use ...@@ -8237,7 +8236,7 @@ It does, however, auto-configure a `WebServiceTemplateBuilder`, which can be use
The following code shows a typical example: The following code shows a typical example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Service @Service
public class MyService { public class MyService {
...@@ -8258,7 +8257,7 @@ The following code shows a typical example: ...@@ -8258,7 +8257,7 @@ The following code shows a typical example:
By default, `WebServiceTemplateBuilder` detects a suitable HTTP-based `WebServiceMessageSender` using the available HTTP client libraries on the classpath. By default, `WebServiceTemplateBuilder` detects a suitable HTTP-based `WebServiceMessageSender` using the available HTTP client libraries on the classpath.
You can also customize read and connection timeouts as follows: You can also customize read and connection timeouts as follows:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Bean @Bean
public WebServiceTemplate webServiceTemplate(WebServiceTemplateBuilder builder) { public WebServiceTemplate webServiceTemplate(WebServiceTemplateBuilder builder) {
...@@ -8347,7 +8346,7 @@ This mechanism does not apply the same way to `@Bean` methods where typically th ...@@ -8347,7 +8346,7 @@ This mechanism does not apply the same way to `@Bean` methods where typically th
To handle this scenario, a separate `@Configuration` class can be used to isolate the condition, as shown in the following example: To handle this scenario, a separate `@Configuration` class can be used to isolate the condition, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Configuration(proxyBeanMethods = false) @Configuration(proxyBeanMethods = false)
// Some conditions // Some conditions
...@@ -8380,7 +8379,7 @@ The `search` attribute lets you limit the `ApplicationContext` hierarchy that sh ...@@ -8380,7 +8379,7 @@ The `search` attribute lets you limit the `ApplicationContext` hierarchy that sh
When placed on a `@Bean` method, the target type defaults to the return type of the method, as shown in the following example: When placed on a `@Bean` method, the target type defaults to the return type of the method, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Configuration(proxyBeanMethods = false) @Configuration(proxyBeanMethods = false)
public class MyAutoConfiguration { public class MyAutoConfiguration {
...@@ -8475,7 +8474,7 @@ The runner can also be used to display the `ConditionEvaluationReport`. ...@@ -8475,7 +8474,7 @@ The runner can also be used to display the `ConditionEvaluationReport`.
The report can be printed at `INFO` or `DEBUG` level. The report can be printed at `INFO` or `DEBUG` level.
The following example shows how to use the `ConditionEvaluationReportLoggingListener` to print the report in auto-configuration tests. The following example shows how to use the `ConditionEvaluationReportLoggingListener` to print the report in auto-configuration tests.
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Test @Test
void autoConfigTest() { void autoConfigTest() {
...@@ -8549,7 +8548,7 @@ As a rule of thumb, prefix all your keys with a namespace that you own (e.g. `ac ...@@ -8549,7 +8548,7 @@ As a rule of thumb, prefix all your keys with a namespace that you own (e.g. `ac
Make sure that configuration keys are documented by adding field javadoc for each property, as shown in the following example: Make sure that configuration keys are documented by adding field javadoc for each property, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@ConfigurationProperties("acme") @ConfigurationProperties("acme")
public class AcmeProperties { public class AcmeProperties {
......
spring-boot-project/spring-boot-docs/src/docs/asciidoc/using-spring-boot.adoc
View file @ ae1be76c
...@@ -209,7 +209,7 @@ The following listing shows a typical layout: ...@@ -209,7 +209,7 @@ The following listing shows a typical layout:
The `Application.java` file would declare the `main` method, along with the basic `@SpringBootApplication`, as follows: The `Application.java` file would declare the `main` method, along with the basic `@SpringBootApplication`, as follows:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
package com.example.myapplication; package com.example.myapplication;
...@@ -282,7 +282,7 @@ Doing so enables debug logs for a selection of core loggers and logs a condition ...@@ -282,7 +282,7 @@ Doing so enables debug logs for a selection of core loggers and logs a condition
=== Disabling Specific Auto-configuration Classes === Disabling Specific Auto-configuration Classes
If you find that specific auto-configuration classes that you do not want are being applied, you can use the exclude attribute of `@SpringBootApplication` to disable them, as shown in the following example: If you find that specific auto-configuration classes that you do not want are being applied, you can use the exclude attribute of `@SpringBootApplication` to disable them, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
import org.springframework.boot.autoconfigure.*; import org.springframework.boot.autoconfigure.*;
import org.springframework.boot.autoconfigure.jdbc.*; import org.springframework.boot.autoconfigure.jdbc.*;
...@@ -313,7 +313,7 @@ All of your application components (`@Component`, `@Service`, `@Repository`, `@C ...@@ -313,7 +313,7 @@ All of your application components (`@Component`, `@Service`, `@Repository`, `@C
The following example shows a `@Service` Bean that uses constructor injection to obtain a required `RiskAssessor` bean: The following example shows a `@Service` Bean that uses constructor injection to obtain a required `RiskAssessor` bean:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
package com.example.service; package com.example.service;
...@@ -337,7 +337,7 @@ The following example shows a `@Service` Bean that uses constructor injection to ...@@ -337,7 +337,7 @@ The following example shows a `@Service` Bean that uses constructor injection to
If a bean has one constructor, you can omit the `@Autowired`, as shown in the following example: If a bean has one constructor, you can omit the `@Autowired`, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
@Service @Service
public class DatabaseAccountService implements AccountService { public class DatabaseAccountService implements AccountService {
...@@ -366,7 +366,7 @@ A single `@SpringBootApplication` annotation can be used to enable those three f ...@@ -366,7 +366,7 @@ A single `@SpringBootApplication` annotation can be used to enable those three f
* `@ComponentScan`: enable `@Component` scan on the package where the application is located (see <<using-boot-structuring-your-code,the best practices>>) * `@ComponentScan`: enable `@Component` scan on the package where the application is located (see <<using-boot-structuring-your-code,the best practices>>)
* `@Configuration`: allow to register extra beans in the context or import additional configuration classes * `@Configuration`: allow to register extra beans in the context or import additional configuration classes
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
package com.example.myapplication; package com.example.myapplication;
...@@ -390,7 +390,7 @@ NOTE: `@SpringBootApplication` also provides aliases to customize the attributes ...@@ -390,7 +390,7 @@ NOTE: `@SpringBootApplication` also provides aliases to customize the attributes
None of these features are mandatory and you may choose to replace this single annotation by any of the features that it enables. None of these features are mandatory and you may choose to replace this single annotation by any of the features that it enables.
For instance, you may not want to use component scan or configuration properties scan in your application: For instance, you may not want to use component scan or configuration properties scan in your application:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
package com.example.myapplication; package com.example.myapplication;
...@@ -593,7 +593,7 @@ The way in which you cause the classpath to be updated depends on the IDE that y ...@@ -593,7 +593,7 @@ The way in which you cause the classpath to be updated depends on the IDE that y
* In Eclipse, saving a modified file causes the classpath to be updated and triggers a restart. * In Eclipse, saving a modified file causes the classpath to be updated and triggers a restart.
* In IntelliJ IDEA, building the project (`Build +->+ Build Project`) has the same effect. * In IntelliJ IDEA, building the project (`Build +->+ Build Project`) has the same effect.
* If using a build plugin, running `mvn compile` for Maven or `gradle build` for Gradle will trigger a restart. * If using a build plugin, running `mvn compile` for Maven or `gradle build` for Gradle will trigger a restart.
**** ****
NOTE: If you are restarting with Maven or Gradle using the build plugin you must leave the `forking` set to `enabled`. NOTE: If you are restarting with Maven or Gradle using the build plugin you must leave the `forking` set to `enabled`.
...@@ -677,7 +677,7 @@ In most cases, you can set this property in your `application.properties` (doing ...@@ -677,7 +677,7 @@ In most cases, you can set this property in your `application.properties` (doing
If you need to _completely_ disable restart support (for example, because it does not work with a specific library), you need to set the configprop:spring.devtools.restart.enabled[] `System` property to `false` before calling `SpringApplication.run(...)`, as shown in the following example: If you need to _completely_ disable restart support (for example, because it does not work with a specific library), you need to set the configprop:spring.devtools.restart.enabled[] `System` property to `false` before calling `SpringApplication.run(...)`, as shown in the following example:
[source,java,indent=0] [source,java,pending-extract=true,indent=0]
---- ----
public static void main(String[] args) { public static void main(String[] args) {
System.setProperty("spring.devtools.restart.enabled", "false"); System.setProperty("spring.devtools.restart.enabled", "false");
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment