docs: clarify Javadoc of Customizer interfaces about overriding behavior

Seokjae Lee · Seokjae Lee · commit 1c0fa5bcecd4 · 2025-08-22T17:30:18.000+09:00
The previous wording suggested that customizations always retain default auto-configuration.
Rephrased to indicate that configuration can be fine-tuned, which more accurately reflects
that some builder methods may override or replace defaults.

Signed-off-by: Seokjae Lee &lt;seok9211@naver.com&gt;
diff --git a/module/spring-boot-activemq/src/main/java/org/springframework/boot/activemq/autoconfigure/ActiveMQConnectionFactoryCustomizer.java b/module/spring-boot-activemq/src/main/java/org/springframework/boot/activemq/autoconfigure/ActiveMQConnectionFactoryCustomizer.java
@@ -20,7 +20,7 @@
 
 /**
  * Callback interface that can be implemented by beans wishing to customize the
- * {@link ActiveMQConnectionFactory} whilst retaining default auto-configuration.
+ * {@link ActiveMQConnectionFactory} to fine-tune its auto-configuration.
  *
  * @author Stephane Nicoll
  * @since 4.0.0
diff --git a/module/spring-boot-batch/src/main/java/org/springframework/boot/batch/autoconfigure/BatchConversionServiceCustomizer.java b/module/spring-boot-batch/src/main/java/org/springframework/boot/batch/autoconfigure/BatchConversionServiceCustomizer.java
@@ -20,8 +20,8 @@
 
 /**
  * Callback interface that can be implemented by beans wishing to customize the
- * {@link ConfigurableConversionService} that is used by the batch infrastructure while
- * retaining its default auto-configuration.
+ * {@link ConfigurableConversionService} that is used by the batch infrastructure
+ * to fine-tune its auto-configuration.
  *
  * @author Claudio Nave
  * @since 4.0.0
diff --git a/module/spring-boot-cassandra/src/main/java/org/springframework/boot/cassandra/autoconfigure/CqlSessionBuilderCustomizer.java b/module/spring-boot-cassandra/src/main/java/org/springframework/boot/cassandra/autoconfigure/CqlSessionBuilderCustomizer.java
@@ -21,8 +21,8 @@
 
 /**
  * Callback interface that can be implemented by beans wishing to customize the
- * {@link CqlSession} through a {@link CqlSessionBuilder} whilst retaining default
- * auto-configuration.
+ * {@link CqlSession} through a {@link CqlSessionBuilder} to fine-tune
+ * its auto-configuration.
  *
  * @author Stephane Nicoll
  * @since 4.0.0
diff --git a/module/spring-boot-cassandra/src/main/java/org/springframework/boot/cassandra/autoconfigure/DriverConfigLoaderBuilderCustomizer.java b/module/spring-boot-cassandra/src/main/java/org/springframework/boot/cassandra/autoconfigure/DriverConfigLoaderBuilderCustomizer.java
@@ -21,8 +21,8 @@
 
 /**
  * Callback interface that can be implemented by beans wishing to customize the
- * {@link DriverConfigLoader} through a {@link DriverConfigLoaderBuilderCustomizer} whilst
- * retaining default auto-configuration.
+ * {@link DriverConfigLoader} through a {@link DriverConfigLoaderBuilderCustomizer}
+ * to fine-tune its auto-configuration.
  *
  * @author Stephane Nicoll
  * @since 4.0.0
diff --git a/module/spring-boot-couchbase/src/main/java/org/springframework/boot/couchbase/autoconfigure/ClusterEnvironmentBuilderCustomizer.java b/module/spring-boot-couchbase/src/main/java/org/springframework/boot/couchbase/autoconfigure/ClusterEnvironmentBuilderCustomizer.java
@@ -21,8 +21,8 @@
 
 /**
  * Callback interface that can be implemented by beans wishing to customize the
- * {@link ClusterEnvironment} through a {@link Builder ClusterEnvironment.Builder} whilst
- * retaining default auto-configuration.
+ * {@link ClusterEnvironment} through a {@link Builder ClusterEnvironment.Builder}
+ * to fine-tune its auto-configuration.
  *
  * @author Stephane Nicoll
  * @since 4.0.0
diff --git a/module/spring-boot-data-redis/src/main/java/org/springframework/boot/data/redis/autoconfigure/ClientResourcesBuilderCustomizer.java b/module/spring-boot-data-redis/src/main/java/org/springframework/boot/data/redis/autoconfigure/ClientResourcesBuilderCustomizer.java
@@ -21,8 +21,7 @@
 
 /**
  * Callback interface that can be implemented by beans wishing to customize the
- * {@link ClientResources} through a {@link Builder} whilst retaining default
- * auto-configuration.
+ * {@link ClientResources} through a {@link Builder} to fine-tune its auto-configuration.
  *
  * @author Stephane Nicoll
  * @since 4.0.0
diff --git a/module/spring-boot-data-redis/src/main/java/org/springframework/boot/data/redis/autoconfigure/JedisClientConfigurationBuilderCustomizer.java b/module/spring-boot-data-redis/src/main/java/org/springframework/boot/data/redis/autoconfigure/JedisClientConfigurationBuilderCustomizer.java
@@ -22,8 +22,8 @@
 /**
  * Callback interface that can be implemented by beans wishing to customize the
  * {@link JedisClientConfiguration} through a {@link JedisClientConfigurationBuilder
- * JedisClientConfiguration.JedisClientConfigurationBuilder} whilst retaining default
- * auto-configuration.
+ * JedisClientConfiguration.JedisClientConfigurationBuilder} to fine-tune
+ * its auto-configuration.
  *
  * @author Mark Paluch
  * @since 4.0.0
diff --git a/module/spring-boot-data-redis/src/main/java/org/springframework/boot/data/redis/autoconfigure/LettuceClientConfigurationBuilderCustomizer.java b/module/spring-boot-data-redis/src/main/java/org/springframework/boot/data/redis/autoconfigure/LettuceClientConfigurationBuilderCustomizer.java
@@ -22,8 +22,8 @@
 /**
  * Callback interface that can be implemented by beans wishing to customize the
  * {@link LettuceClientConfiguration} through a {@link LettuceClientConfigurationBuilder
- * LettuceClientConfiguration.LettuceClientConfigurationBuilder} whilst retaining default
- * auto-configuration. To customize only the
+ * LettuceClientConfiguration.LettuceClientConfigurationBuilder} to fine-tune
+ * its auto-configuration. To customize only the
  * {@link LettuceClientConfiguration#getClientOptions() client options} of the
  * configuration, use {@link LettuceClientOptionsBuilderCustomizer} instead.
  *
diff --git a/module/spring-boot-data-redis/src/main/java/org/springframework/boot/data/redis/autoconfigure/LettuceClientOptionsBuilderCustomizer.java b/module/spring-boot-data-redis/src/main/java/org/springframework/boot/data/redis/autoconfigure/LettuceClientOptionsBuilderCustomizer.java
@@ -24,7 +24,7 @@
 /**
  * Callback interface that can be implemented by beans wishing to customize the
  * {@link ClientOptions} of the {@link LettuceClientConfiguration} through a
- * {@link Builder} whilst retaining default auto-configuration. To customize the entire
+ * {@link Builder} to fine-tune its auto-configuration. To customize the entire
  * configuration, use {@link LettuceClientConfigurationBuilderCustomizer} instead.
  *
  * @author Soohyun Lim
diff --git a/module/spring-boot-elasticsearch/src/main/java/org/springframework/boot/elasticsearch/autoconfigure/Rest5ClientBuilderCustomizer.java b/module/spring-boot-elasticsearch/src/main/java/org/springframework/boot/elasticsearch/autoconfigure/Rest5ClientBuilderCustomizer.java
@@ -27,8 +27,8 @@
 
 /**
  * Callback interface that can be implemented by beans wishing to further customize the
- * {@link Rest5Client} through a {@link Rest5ClientBuilder} whilst retaining default
- * auto-configuration.
+ * {@link Rest5Client} through a {@link Rest5ClientBuilder} to fine-tune
+ * its auto-configuration.
  *
  * @author Brian Clozel
  * @author Vedran Pavic
diff --git a/module/spring-boot-graphql/src/main/java/org/springframework/boot/graphql/autoconfigure/GraphQlSourceBuilderCustomizer.java b/module/spring-boot-graphql/src/main/java/org/springframework/boot/graphql/autoconfigure/GraphQlSourceBuilderCustomizer.java
@@ -21,7 +21,7 @@
 /**
  * Callback interface that can be implemented by beans wishing to customize properties of
  * {@link org.springframework.graphql.execution.GraphQlSource.SchemaResourceBuilder
- * Builder} whilst retaining default auto-configuration.
+ * Builder} to fine-tune its auto-configuration.
  *
  * @author Rossen Stoyanchev
  * @since 4.0.0
diff --git a/module/spring-boot-gson/src/main/java/org/springframework/boot/gson/autoconfigure/GsonBuilderCustomizer.java b/module/spring-boot-gson/src/main/java/org/springframework/boot/gson/autoconfigure/GsonBuilderCustomizer.java
@@ -21,7 +21,7 @@
 
 /**
  * Callback interface that can be implemented by beans wishing to further customize the
- * {@link Gson} through {@link GsonBuilder} retaining its default auto-configuration.
+ * {@link Gson} through {@link GsonBuilder} to fine-tune its auto-configuration.
  *
  * @author Ivan Golovko
  * @since 4.0.0
diff --git a/module/spring-boot-integration/src/main/java/org/springframework/boot/integration/autoconfigure/PollerMetadataCustomizer.java b/module/spring-boot-integration/src/main/java/org/springframework/boot/integration/autoconfigure/PollerMetadataCustomizer.java
@@ -20,7 +20,7 @@
 
 /**
  * Callback interface that can be implemented by beans wishing to customize the
- * {@link PollerMetadata} whilst retaining default auto-configuration.
+ * {@link PollerMetadata} to fine-tune its auto-configuration.
  *
  * @author Yanming Zhou
  * @since 4.0.0
diff --git a/module/spring-boot-jackson/src/main/java/org/springframework/boot/jackson/autoconfigure/Jackson2ObjectMapperBuilderCustomizer.java b/module/spring-boot-jackson/src/main/java/org/springframework/boot/jackson/autoconfigure/Jackson2ObjectMapperBuilderCustomizer.java
@@ -22,11 +22,8 @@
 
 /**
  * Callback interface that can be implemented by beans wishing to further customize the
- * {@link ObjectMapper} through {@link Jackson2ObjectMapperBuilder} retaining its default
- * auto-configuration.
- * Note: Depending on which methods of {@link Jackson2ObjectMapperBuilder} are used,
- * customizations may override or replace parts of the default auto-configuration
- * instead of merely adding to it.
+ * {@link ObjectMapper} through {@link Jackson2ObjectMapperBuilder} to fine-tune
+ * its auto-configuration.
  *
  * @author Grzegorz Poznachowski
  * @since 4.0.0
diff --git a/module/spring-boot-jooq/src/main/java/org/springframework/boot/jooq/autoconfigure/DefaultConfigurationCustomizer.java b/module/spring-boot-jooq/src/main/java/org/springframework/boot/jooq/autoconfigure/DefaultConfigurationCustomizer.java
@@ -20,7 +20,7 @@
 
 /**
  * Callback interface that can be implemented by beans wishing to customize the
- * {@link DefaultConfiguration} whilst retaining default auto-configuration.
+ * {@link DefaultConfiguration} to fine-tune its auto-configuration.
  *
  * @author Stephane Nicoll
  * @since 4.0.0
diff --git a/module/spring-boot-micrometer-tracing/src/main/java/org/springframework/boot/micrometer/tracing/autoconfigure/otlp/OtlpGrpcSpanExporterBuilderCustomizer.java b/module/spring-boot-micrometer-tracing/src/main/java/org/springframework/boot/micrometer/tracing/autoconfigure/otlp/OtlpGrpcSpanExporterBuilderCustomizer.java
@@ -20,7 +20,7 @@
 
 /**
  * Callback interface that can be implemented by beans wishing to customize the
- * {@link OtlpGrpcSpanExporterBuilder} whilst retaining default auto-configuration.
+ * {@link OtlpGrpcSpanExporterBuilder} to fine-tune its auto-configuration.
  *
  * @author Dmytro Nosan
  * @since 4.0.0
diff --git a/module/spring-boot-micrometer-tracing/src/main/java/org/springframework/boot/micrometer/tracing/autoconfigure/otlp/OtlpHttpSpanExporterBuilderCustomizer.java b/module/spring-boot-micrometer-tracing/src/main/java/org/springframework/boot/micrometer/tracing/autoconfigure/otlp/OtlpHttpSpanExporterBuilderCustomizer.java
@@ -20,7 +20,7 @@
 
 /**
  * Callback interface that can be implemented by beans wishing to customize the
- * {@link OtlpHttpSpanExporterBuilder} whilst retaining default auto-configuration.
+ * {@link OtlpHttpSpanExporterBuilder} to fine-tune its auto-configuration.
  *
  * @author Dmytro Nosan
  * @since 4.0.0
diff --git a/module/spring-boot-mongodb/src/main/java/org/springframework/boot/mongodb/autoconfigure/MongoClientSettingsBuilderCustomizer.java b/module/spring-boot-mongodb/src/main/java/org/springframework/boot/mongodb/autoconfigure/MongoClientSettingsBuilderCustomizer.java
@@ -21,7 +21,7 @@
 /**
  * Callback interface that can be implemented by beans wishing to customize the
  * {@link com.mongodb.MongoClientSettings} through a {@link Builder
- * MongoClientSettings.Builder} whilst retaining default auto-configuration.
+ * MongoClientSettings.Builder} to fine-tune its auto-configuration.
  *
  * @author Mark Paluch
  * @since 4.0.0
diff --git a/module/spring-boot-neo4j/src/main/java/org/springframework/boot/neo4j/autoconfigure/ConfigBuilderCustomizer.java b/module/spring-boot-neo4j/src/main/java/org/springframework/boot/neo4j/autoconfigure/ConfigBuilderCustomizer.java
@@ -21,8 +21,7 @@
 
 /**
  * Callback interface that can be implemented by beans wishing to customize the
- * {@link Config} through a {@link ConfigBuilder} whilst retaining default
- * auto-configuration.
+ * {@link Config} through a {@link ConfigBuilder} to fine-tune its auto-configuration.
  *
  * @author Stephane Nicoll
  * @since 4.0.0
diff --git a/module/spring-boot-r2dbc/src/main/java/org/springframework/boot/r2dbc/autoconfigure/ConnectionFactoryOptionsBuilderCustomizer.java b/module/spring-boot-r2dbc/src/main/java/org/springframework/boot/r2dbc/autoconfigure/ConnectionFactoryOptionsBuilderCustomizer.java
@@ -21,8 +21,8 @@
 
 /**
  * Callback interface that can be implemented by beans wishing to customize the
- * {@link ConnectionFactoryOptions} through a {@link Builder} whilst retaining default
- * auto-configuration.
+ * {@link ConnectionFactoryOptions} through a {@link Builder} to fine-tune
+ * its auto-configuration.
  *
  * @author Mark Paluch
  * @since 4.0.0
diff --git a/module/spring-boot-tx/src/main/java/org/springframework/boot/transaction/autoconfigure/TransactionManagerCustomizer.java b/module/spring-boot-tx/src/main/java/org/springframework/boot/transaction/autoconfigure/TransactionManagerCustomizer.java
@@ -20,8 +20,7 @@
 
 /**
  * Callback interface that can be implemented by beans wishing to customize
- * {@link TransactionManager TransactionManagers} while retaining default
- * auto-configuration.
+ * {@link TransactionManager TransactionManagers} to fine-tune its auto-configuration.
  *
  * @param <T> the transaction manager type
  * @author Andy Wilkinson

Original file line number	Diff line number	Diff line change
`@@ -20,7 +20,7 @@`
`20`	`20`
`21`	`21`	`/**`
`22`	`22`	`* Callback interface that can be implemented by beans wishing to customize the`
`23`		`- * {@link ActiveMQConnectionFactory} whilst retaining default auto-configuration.`
	`23`	`+ * {@link ActiveMQConnectionFactory} to fine-tune its auto-configuration.`
`24`	`24`	`*`
`25`	`25`	`* @author Stephane Nicoll`
`26`	`26`	`* @since 4.0.0`
Original file line number	Diff line number	Diff line change
`@@ -21,8 +21,7 @@`
`21`	`21`
`22`	`22`	`/**`
`23`	`23`	`* Callback interface that can be implemented by beans wishing to customize the`
`24`		`- * {@link ClientResources} through a {@link Builder} whilst retaining default`
`25`		`- * auto-configuration.`
	`24`	`+ * {@link ClientResources} through a {@link Builder} to fine-tune its auto-configuration.`
`26`	`25`	`*`
`27`	`26`	`* @author Stephane Nicoll`
`28`	`27`	`* @since 4.0.0`
Original file line number	Diff line number	Diff line change
`@@ -24,7 +24,7 @@`
`24`	`24`	`/**`
`25`	`25`	`* Callback interface that can be implemented by beans wishing to customize the`
`26`	`26`	`* {@link ClientOptions} of the {@link LettuceClientConfiguration} through a`
`27`		`- * {@link Builder} whilst retaining default auto-configuration. To customize the entire`
	`27`	`+ * {@link Builder} to fine-tune its auto-configuration. To customize the entire`
`28`	`28`	`* configuration, use {@link LettuceClientConfigurationBuilderCustomizer} instead.`
`29`	`29`	`*`
`30`	`30`	`* @author Soohyun Lim`