Skip to content
Original file line number Diff line number Diff line change
Expand Up @@ -336,7 +336,7 @@ This section contains three examples of using `findmainclass`.
If you want to use a build tool other than Maven, Gradle, or Ant, you likely need to
develop your own plugin. Executable jars need to follow a specific format and certain
entries need to be written in an uncompressed form (see the
"`<<appendix-executable-jar-format.adoc#executable-jar, executable jar format>>`" section
"`<<appendix.adoc#executable-jar, executable jar format>>`" section
in the appendix for details).

The Spring Boot Maven and Gradle plugins both make use of `spring-boot-loader-tools` to
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -142,9 +142,9 @@ Finally, we have a few topics for more advanced users:
<<build-tool-plugins.adoc#build-tool-plugins-maven-plugin, Maven>> |
<<build-tool-plugins.adoc#build-tool-plugins-gradle-plugin, Gradle>>
* *Appendix:*
<<appendix-application-properties.adoc#common-application-properties, Application
<<appendix.adoc#common-application-properties, Application
Properties>> |
<<appendix-auto-configuration-classes.adoc#auto-configuration-classes, Auto-configuration
<<appendix.adoc#auto-configuration-classes, Auto-configuration
classes>> |
<<appendix-executable-jar-format.adoc#executable-jar, Executable Jars>>
<<appendix.adoc#executable-jar, Executable Jars>>

Original file line number Diff line number Diff line change
Expand Up @@ -728,7 +728,7 @@ this approach is that it becomes hard to see which libraries are in your applica
can also be problematic if the same filename is used (but with different content) in
multiple jars.

Spring Boot takes a <<appendix-executable-jar-format.adoc#executable-jar, different
Spring Boot takes a <<appendix.adoc#executable-jar, different
approach>> and lets you actually nest jars directly.
****

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -489,7 +489,7 @@ can come from additional jar files on your classpath.
A running application with the Actuator features has a `configprops` endpoint that shows
all the bound and bindable properties available through `@ConfigurationProperties`.

The appendix includes an <<appendix-application-properties#common-application-properties,
The appendix includes an <<appendix.adoc#common-application-properties,
`application.properties`>> example with a list of the most common properties supported by
Spring Boot. The definitive list comes from searching the source code for
`@ConfigurationProperties` and `@Value` annotations as well as the occasional use of
Expand Down Expand Up @@ -2866,7 +2866,7 @@ then be depended upon by your application and other projects.
If you cannot rearrange your code as recommended above, Spring Boot's Maven and Gradle
plugins must be configured to produce a separate artifact that is suitable for use as a
dependency. The executable archive cannot be used as a dependency as the
<<appendix-executable-jar-format.adoc#executable-jar-jar-file-structure,executable jar
<<appendix.adoc#executable-jar-jar-file-structure,executable jar
format>> packages application classes in `BOOT-INF/classes`. This means
that they cannot be found when the executable jar is used as a dependency.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -189,8 +189,8 @@ Boot's default dependency metadata to deduce the artifact's group and version.
NOTE: The default metadata is tied to the version of the CLI that you use. it changes only
when you move to a new version of the CLI, putting you in control of when the versions of
your dependencies may change. A table showing the dependencies and their versions that are
included in the default metadata can be found in the <<appendix-dependency-versions,
appendix>>.
included in the default metadata can be found in the <<appendix.adoc#appendix-dependency-versions,
Dependency versions>>.



Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -1472,7 +1472,7 @@ features that are supported by `@ConfigurationProperties` and `@Value`:
| Yes
| No

| <<appendix-configuration-metadata.adoc#configuration-metadata,Meta-data support>>
| <<appendix.adoc#configuration-metadata,Meta-data support>>
| Yes
| No

Expand Down Expand Up @@ -6941,7 +6941,7 @@ mapper, which can be one of the following libraries:
* `Jsonb`

TIP: A list of the auto-configurations that are enabled by `@JsonTest` can be
<<appendix-test-auto-configuration#test-auto-configuration,found in the appendix>>.
<<appendix.adoc#test-auto-configuration,found in the appendix>>.

If you need to configure elements of the auto-configuration, you can use the
`@AutoConfigureJsonTesters` annotation.
Expand Down Expand Up @@ -7008,7 +7008,7 @@ scanned beans to `@Controller`, `@ControllerAdvice`, `@JsonComponent`, `Converte
Regular `@Component` beans are not scanned when using this annotation.

TIP: A list of the auto-configuration settings that are enabled by `@WebMvcTest` can be
<<appendix-test-auto-configuration#test-auto-configuration,found in the appendix>>.
<<appendix.adoc#test-auto-configuration,found in the appendix>>.

TIP: If you need to register extra components, such as the Jackson `Module`, you can
import additional configuration classes by using `@Import` on your test.
Expand Down Expand Up @@ -7128,7 +7128,7 @@ auto-configures the Spring WebFlux infrastructure and limits scanned beans to
annotation is used.

TIP: A list of the auto-configurations that are enabled by `@WebFluxTest` can be
<<appendix-test-auto-configuration#test-auto-configuration,found in the appendix>>.
<<appendix.adoc#test-auto-configuration,found in the appendix>>.

TIP: If you need to register extra components, such as Jackson `Module`, you can import
additional configuration classes using `@Import` on your test.
Expand Down Expand Up @@ -7200,7 +7200,7 @@ Spring Data JPA repositories. Regular `@Component` beans are not loaded into the
`ApplicationContext`.

TIP: A list of the auto-configuration settings that are enabled by `@DataJpaTest` can be
<<appendix-test-auto-configuration#test-auto-configuration,found in the appendix>>.
<<appendix.adoc#test-auto-configuration,found in the appendix>>.

By default, data JPA tests are transactional and roll back at the end of each test. See
the {spring-reference}testing.html#testcontext-tx-enabling-transactions[relevant section]
Expand Down Expand Up @@ -7289,7 +7289,7 @@ embedded database and a `JdbcTemplate`. Regular `@Component` beans are not loade
the `ApplicationContext`.

TIP: A list of the auto-configurations that are enabled by `@JdbcTest` can be
<<appendix-test-auto-configuration#test-auto-configuration,found in the appendix>>.
<<appendix.adoc#test-auto-configuration,found in the appendix>>.

By default, JDBC tests are transactional and roll back at the end of each test. See the
{spring-reference}testing.html#testcontext-tx-enabling-transactions[relevant section] in
Expand Down Expand Up @@ -7328,7 +7328,7 @@ and Spring Data JDBC repositories. Regular `@Component` beans are not loaded int
the `ApplicationContext`.

TIP: A list of the auto-configurations that are enabled by `@DataJdbcTest` can be
<<appendix-test-auto-configuration#test-auto-configuration,found in the appendix>>.
<<appendix.adoc#test-auto-configuration,found in the appendix>>.

By default, Data JDBC tests are transactional and roll back at the end of each test. See
the {spring-reference}testing.html#testcontext-tx-enabling-transactions[relevant section]
Expand All @@ -7353,7 +7353,7 @@ jOOQ with Spring Boot, see "<<boot-features-jooq>>", earlier in this chapter.) R
`@Component` beans are not loaded into the `ApplicationContext`.

TIP: A list of the auto-configurations that are enabled by `@JooqTest` can be
<<appendix-test-auto-configuration#test-auto-configuration,found in the appendix>>.
<<appendix.adoc#test-auto-configuration,found in the appendix>>.

`@JooqTest` configures a `DSLContext`. Regular `@Component` beans are not loaded into the
`ApplicationContext`. The following example shows the `@JooqTest` annotation in use:
Expand Down Expand Up @@ -7393,7 +7393,7 @@ in-memory embedded MongoDB (if available), configures a `MongoTemplate`, scans f
MongoDB with Spring Boot, see "<<boot-features-mongodb>>", earlier in this chapter.)

TIP: A list of the auto-configuration settings that are enabled by `@DataMongoTest` can be
<<appendix-test-auto-configuration#test-auto-configuration,found in the appendix>>.
<<appendix.adoc#test-auto-configuration,found in the appendix>>.

The following class shows the `@DataMongoTest` annotation in use:

Expand Down Expand Up @@ -7447,7 +7447,7 @@ the `ApplicationContext`. (For more about using Neo4J with Spring Boot, see
"<<boot-features-neo4j>>", earlier in this chapter.)

TIP: A list of the auto-configuration settings that are enabled by `@DataNeo4jTest` can be
<<appendix-test-auto-configuration#test-auto-configuration,found in the appendix>>.
<<appendix.adoc#test-auto-configuration,found in the appendix>>.

The following example shows a typical setup for using Neo4J tests in Spring Boot:

Expand Down Expand Up @@ -7503,7 +7503,7 @@ beans are not loaded into the `ApplicationContext`. (For more about using Redis
Spring Boot, see "<<boot-features-redis>>", earlier in this chapter.)

TIP: A list of the auto-configuration settings that are enabled by `@DataRedisTest` can be
<<appendix-test-auto-configuration#test-auto-configuration,found in the appendix>>.
<<appendix.adoc#test-auto-configuration,found in the appendix>>.

The following example shows the `@DataRedisTest` annotation in use:

Expand Down Expand Up @@ -7536,7 +7536,7 @@ loaded into the `ApplicationContext`. (For more about using LDAP with
Spring Boot, see "<<boot-features-ldap>>", earlier in this chapter.)

TIP: A list of the auto-configuration settings that are enabled by `@DataLdapTest` can be
<<appendix-test-auto-configuration#test-auto-configuration,found in the appendix>>.
<<appendix.adoc#test-auto-configuration,found in the appendix>>.

The following example shows the `@DataLdapTest` annotation in use:

Expand Down Expand Up @@ -7588,7 +7588,7 @@ adds support for `MockRestServiceServer`. Regular `@Component` beans are not loa
the `ApplicationContext`.

TIP: A list of the auto-configuration settings that are enabled by `@RestClientTest` can
be <<appendix-test-auto-configuration#test-auto-configuration,found in the appendix>>.
be <<appendix.adoc#test-auto-configuration,found in the appendix>>.

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:
Expand Down Expand Up @@ -8357,7 +8357,7 @@ particular, do not include your keys in the namespaces that Spring Boot uses (su
these namespaces in the future in ways that break your modules.

Make sure to
<<appendix-configuration-metadata#configuration-metadata-annotation-processor,trigger
<<appendix.adoc#configuration-metadata-annotation-processor,trigger
meta-data generation>> so that IDE assistance is available for your keys as well. You may
want to review the generated meta-data (`META-INF/spring-configuration-metadata.json`) to
make sure your keys are properly documented.
Expand Down Expand Up @@ -8605,7 +8605,7 @@ class KotlinExampleProperties {
----

TIP: To generate
<<appendix-configuration-metadata#configuration-metadata-annotation-processor,your own
<<appendix.adoc#configuration-metadata-annotation-processor,your own
metadata>> using the annotation processor, {kotlin-documentation}kapt.html[`kapt` should
be configured] with the `spring-boot-configuration-processor` dependency.

Expand Down