Document how to register runtime hints for convention-based conversion

[sbrannen]

Overview

As a followup to #35156, we decided that it would benefit users if we document how to register runtime hints for convention-based conversion performed by the ObjectToObjectConverter.

An example can be seen in ObjectToObjectConverterRuntimeHints.

spring-framework/spring-core/src/main/java/org/springframework/aot/hint/support/ObjectToObjectConverterRuntimeHints.java

Lines 54 to 57 in 47d9182

	TypeReference sqlTimestampTypeReference = TypeReference.of("java.sql.Timestamp");
	reflectionHints.registerTypeIfPresent(classLoader, sqlTimestampTypeReference.getName(), hint -> hint
	.withMethod("from", List.of(TypeReference.of(Instant.class)), ExecutableMode.INVOKE)
	.onReachableType(sqlTimestampTypeReference));

The documentation should reside in the Runtime Hints section of the reference manual.

Related Issues

• Register runtime hints for Instant-to-Timestamp conversion #35156

[sbrannen]

The new documentation is now online.

@SanderKnauff, do you think this new documentation would have covered all of your questions before you opened #35156?

[SanderKnauff]

Hi @sbrannen,
I just read the updated documentation and I think it gives a clear explanation about these specific cases.
It covers all the questions I had about this topic.
It's good that there is an indication now that the ObjectToObjectConverter is being used and that there are some caveats about using it inside a native image.

[sbrannen]

Thanks for taking the time to review the documentation and provide feedback, @SanderKnauff.

Much appreciated! 👍