Skip to content

Commit ae0d9f6

Browse files
committed
Improve JavaDoc
1 parent 7a86901 commit ae0d9f6

File tree

1 file changed

+12
-11
lines changed

1 file changed

+12
-11
lines changed

src/main/java/com/fasterxml/jackson/annotation/JsonTypeInfo.java

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -313,7 +313,7 @@ public enum As {
313313
*
314314
* @since 2.5
315315
public boolean skipWritingDefault() default false;
316-
/*
316+
*/
317317

318318
/*
319319
/**********************************************************
@@ -333,18 +333,19 @@ public enum As {
333333
public abstract static class None {}
334334

335335
/**
336-
* Determines whether strict type ID handling should be used for this type or not. This is per-type configuration of
337-
* {@code MapperFeature#REQUIRE_TYPE_ID_FOR_SUBTYPES} and will <strong>always</strong>
338-
* override the global configuration.
336+
* Specifies whether the type ID should be strictly required during polymorphic deserialization of its subtypes.
337+
* <p>
338+
* If set to {@link OptBoolean#TRUE}, an {@code InvalidTypeIdException} will be thrown if no type
339+
* information is provided.
340+
* If set to {@link OptBoolean#FALSE}, deserialization may proceed without type information if the
341+
* subtype is a legitimate target (non-abstract).
342+
* If set to {@link OptBoolean#DEFAULT}, the global configuration of
343+
* {@code MapperFeature#REQUIRE_TYPE_ID_FOR_SUBTYPES} is used for type ID handling.
339344
* <p>
340-
* If set to {@link OptBoolean#TRUE}, then {@code InvalidTypeIdException} will be thrown if no type information
341-
* is provided during polymorphic deserialization for this type;
342-
* if set to {@link OptBoolean#FALSE}, then the deserialization may proceed without the type information assuming
343-
* sub-type is a legitimate target (non-abstract);
344-
* if set to {@link OptBoolean#DEFAULT}, then global configuration of
345-
* {@code MapperFeature.REQUIRE_TYPE_ID_FOR_SUBTYPES} is used for type id handling.
345+
* NOTE: This setting is specific to this type and will <strong>always override</strong> the global
346+
* configuration of {@code MapperFeature#REQUIRE_TYPE_ID_FOR_SUBTYPES}.
346347
*
347348
* @since 2.16
348349
*/
349-
OptBoolean requireTypeIdForSubtypes() default OptBoolean.DEFAULT;
350+
public OptBoolean requireTypeIdForSubtypes() default OptBoolean.DEFAULT;
350351
}

0 commit comments

Comments
 (0)