Clarify Javadoc of Customizer interfaces about overriding behavior

[doljae]

Motivation

To prevent misunderstandings and make the behavior of Jackson2ObjectMapperBuilder more transparent when used through Jackson2ObjectMapperBuilderCustomizer.

Description

The existing Javadoc of Jackson2ObjectMapperBuilderCustomizer suggests that customizations retain the default auto-configuration while extending it. However, depending on which methods of Jackson2ObjectMapperBuilder are invoked, the default configuration may actually be overridden or replaced instead of merely extended.

This PR updates the Javadoc to explicitly note this possibility, so that developers are aware that certain builder methods (e.g., modules, dateFormat, propertyNamingStrategy) may discard or replace auto-configured settings.

Changes

Added a clarification line in the Javadoc of Jackson2ObjectMapperBuilderCustomizer to indicate that some customizations may override or replace default auto-configuration.

[wilkinsona]

Thanks for the proposal, but I don't think this is a change that we should make. Not in isolation any way.

There are many other customizers whose javadoc describes them similarly. If Jackson2ObjectMapperBuilderCustomizer requires clarification, then the others should be changed in the same way otherwise the difference in the descriptions could imply a difference in behavior.

The various customizers are, generally speaking, documented something like this:

Callback interface that can be implemented by beans wishing to customize the […] while retaining its default auto-configuration.

Perhaps we can just say something like this instead:

Callback interface that can be implemented by beans wishing to customize the […] to fine-tune its auto-configuration.

Are you interested in updating your PR along these lines for each …Customizer callback interface?

[doljae]

Hello @wilkinsona 🙂

To agree with your opinion and maintain consistency, I think it would be best to reflect every ...Customizer callback interface's javadoc.

Would you like to do that in this PR please?

[wilkinsona]

Great. An update to this PR that makes that change to all …Customizer interfaces would be much appreciated.

[doljae]

I committed changes on ff43c5e to modify all ...Customizer callback interface's javadoc.

Also I changed PR title too 🙂

[wilkinsona]

Thanks very much for making your first contribution to Spring Boot, @doljae.