Skip to content

Commit e2b209e

Browse files
committed
Polish "Clarify and re-organize docs on caching"
Closes spring-projectsgh-9065
1 parent 11feb75 commit e2b209e

File tree

1 file changed

+8
-9
lines changed

1 file changed

+8
-9
lines changed

spring-boot-docs/src/main/asciidoc/spring-boot-features.adoc

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3861,8 +3861,8 @@ will replace the default.
38613861
The Spring Framework provides support for transparently adding caching to an application.
38623862
At its core, the abstraction applies caching to methods, reducing thus the number of
38633863
executions based on the information available in the cache. The caching logic is applied
3864-
transparently, without any interference to the invoker. Spring Boot auto-configures a
3865-
suitable `CacheManager` as long as the caching support is enabled via the `@EnableCaching`
3864+
transparently, without any interference to the invoker. Spring Boot auto-configures the
3865+
cache infrastructure as long as the caching support is enabled via the `@EnableCaching`
38663866
annotation.
38673867

38683868
NOTE: Check the {spring-reference}/#cache[relevant section] of the Spring Framework
@@ -3904,9 +3904,8 @@ production usage, but it's great for getting started and making sure that you un
39043904
the features. When you have made up your mind about the cache provider to use, please make
39053905
sure to read its documentation to figure out how to configure the caches that your
39063906
application uses. Practically all providers require you to explicitly configure every
3907-
cache that you use in the application. In most cases Spring Boot allows you to eagerly
3908-
instantiate all the caches on startup (with `spring.cache.cache-names`), or lazily as
3909-
they are needed (without `spring.cache.cache-names`).
3907+
cache that you use in the application. Some offers a way to build default caches that you
3908+
need to specify with the `spring.cache.cache-names` property.
39103909

39113910
TIP: It is also possible to {spring-reference}/#cache-annotations-put[update] or
39123911
{spring-reference}/#cache-annotations-evict[evict] data from the cache transparently.
@@ -3965,10 +3964,10 @@ values should be passed down to the underlying map.
39653964

39663965
[NOTE]
39673966
====
3968-
In the example above, a `ConcurrentMapCacheManager` is expected to be configured (either
3969-
explicitly or through autoconfiguration). If that is not the case, the customizer won't be
3970-
invoked at all. You can have as many customizers as you want and you can also order them
3971-
as usual using `@Order` or `Ordered`.
3967+
In the example above, an auto-configured `ConcurrentMapCacheManager` is expected. If that
3968+
is not the case (either you provided your own config or a different cache provider was
3969+
auto-configured), the customizer won't be invoked at all. You can have as many customizers
3970+
as you want and you can also order them as usual using `@Order` or `Ordered`.
39723971
====
39733972

39743973

0 commit comments

Comments
 (0)