update Schema resolution and casting - add explicit-object-schema
and use-arbitrary-schema
sys/env props
#4868
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR addresses the following tickets:
Changes include:
Schema
hierarchy for 3.0 and 3.1object
type resolutionexplicit-object-schema
anduse-arbitrary-schema
sys/env propsThese 2 properties allow to tweak the processing of Schema
type
. By defaultfor OAS 3.0 a
type: object
is added whenever any class (evenjava.lang.Object
) is resolved into a schema and no type is defined in annotations or elsewhere. This behavior is unchanged (see below to customize) for compatibility reasonsfor OAS 3.1
type: object
is NOT added when type is not defined and there are not Object Schema-specific properties resolved for that schema.this behavior can be customized by explicitly setting System/Env property
explicit-object-schema
totrue
(always addtype:object
in this scenario orfalse
(don't addtype: object
)Additionally, setting
use-arbitrary-schema
totrue
allows to customize deserialization behavior (see #4014) to deserialize schemas with no type defined into aArbitrarySchema
withtype
not defined instead ofObjectSchema
withtype: object