Skip to content

Commit d90d157

Browse files
committed
Javadoc improvements wrt #5211
1 parent 8242174 commit d90d157

File tree

1 file changed

+13
-7
lines changed

1 file changed

+13
-7
lines changed

src/main/java/com/fasterxml/jackson/databind/ObjectMapper.java

Lines changed: 13 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1502,19 +1502,25 @@ public ObjectMapper setSerializerProvider(DefaultSerializerProvider p) {
15021502
}
15031503

15041504
/**
1505-
* Accessor for the "blueprint" (or, factory) instance, from which instances
1506-
* are created by calling {@link DefaultSerializerProvider#createInstance}.
1507-
* Note that returned instance cannot be directly used as it is not properly
1508-
* configured: to get a properly configured instance to call, use
1509-
* {@link #getSerializerProviderInstance()} instead.
1505+
* Internal {@link SerializerProvider} accessor used by databind package to get the "blueprint"
1506+
* (or, factory) instance, from which actual instances are created by calling {@link DefaultSerializerProvider#createInstance}.
1507+
* <b>NOT TO BE USED BY APPLICATION CODE</b> directly: only databind-managed {@code SerializerProvider}
1508+
* instances should be used.
1509+
*<p>
1510+
* Implementation note: returned instance cannot be directly used as it is not properly
1511+
* configured or initialized.
15101512
*/
15111513
public SerializerProvider getSerializerProvider() {
15121514
return _serializerProvider;
15131515
}
15141516

15151517
/**
1516-
* Accessor for constructing and returning a {@link SerializerProvider}
1517-
* instance that may be used for accessing serializers. This is same as
1518+
* Internal {@link SerializerProvider} accessor used by databind package to get a
1519+
* properly initialized instance to pass to various handlers.
1520+
* <b>NOT TO BE USED BY APPLICATION CODE</b> directly: only databind-managed {@code SerializerProvider}
1521+
* instances should be used.
1522+
*<p>
1523+
* Implementation note: this is same as
15181524
* calling {@link #getSerializerProvider}, and calling {@code createInstance()}
15191525
* on it.
15201526
*

0 commit comments

Comments
 (0)