Interface MediaType
- All Superinterfaces:
Constructible
,Extensible<MediaType>
MediaType
Each Media Type Object provides a schema and examples for the media type identified by its key.
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionaddEncoding
(String key, Encoding encodingItem) Adds an Encoding item to the encoding property of a MediaType instance.addExample
(String key, Example example) Adds an example item to the examples map of a MediaType instance.default MediaType
Sets encoding property of a MediaType instance to the given map object.default MediaType
Sets the example property of a MediaType instance to the given value.default MediaType
Sets the examples field of a MediaType instance to the given map object.Returns the encoding property from a MediaType instance.Returns the example property from a MediaType instance.Returns the collection of examples from a MediaType instance.Returns the schema property from a MediaType instance.void
removeEncoding
(String key) Removes an Encoding item to the encoding property of a MediaType instance.void
removeExample
(String key) Removes an example item to the examples map of a MediaType instance.default MediaType
Sets the schema field of a MediaType instance to the given schema object.void
setEncoding
(Map<String, Encoding> encoding) Sets encoding property of a MediaType instance to the given map object.void
setExample
(Object example) Sets the example property of a MediaType instance to the given value.void
setExamples
(Map<String, Example> examples) Sets the examples field of a MediaType instance to the given map object.void
Sets the schema field of a MediaType instance to the given schema object.Methods inherited from interface org.eclipse.microprofile.openapi.models.Extensible
addExtension, extensions, getExtensions, removeExtension, setExtensions
-
Method Details
-
getSchema
Schema getSchema()Returns the schema property from a MediaType instance.- Returns:
- the schema defining the type used for the request body
-
setSchema
Sets the schema field of a MediaType instance to the given schema object.- Parameters:
schema
- the schema defining the type used for the request body
-
schema
Sets the schema field of a MediaType instance to the given schema object.- Parameters:
schema
- the schema defining the type used for the request body- Returns:
- the current MediaType instance
-
getExamples
Returns the collection of examples from a MediaType instance.- Returns:
- examples of the media type
-
setExamples
Sets the examples field of a MediaType instance to the given map object. Each example object should match the media type and specified schema if present. The example object is mutually exclusive of the examples object.- Parameters:
examples
- examples of the media type
-
examples
Sets the examples field of a MediaType instance to the given map object. Each example object should match the media type and specified schema if present. The example object is mutually exclusive of the examples object.- Parameters:
examples
- examples of the media type- Returns:
- the current MediaType instance
-
addExample
Adds an example item to the examples map of a MediaType instance. The example object should match the media type and specified schema if present.- Parameters:
key
- any unique name to identify the example objectexample
- an example of a media type. null values will be rejected (implementation will throw an exception) or ignored.- Returns:
- the current MediaType instance
-
removeExample
Removes an example item to the examples map of a MediaType instance. The example object should match the media type and specified schema if present.- Parameters:
key
- any unique name to identify the example object
-
getExample
Object getExample()Returns the example property from a MediaType instance.- Returns:
- an example of the media type
-
setExample
Sets the example property of a MediaType instance to the given value. The example object should be in the correct format as specified by the media type. The example object is mutually exclusive of the examples object.- Parameters:
example
- an example of the media type
-
example
Sets the example property of a MediaType instance to the given value. The example object should be in the correct format as specified by the media type. The example object is mutually exclusive of the examples object.- Parameters:
example
- an example of the media type- Returns:
- the current MediaType instance
-
getEncoding
Returns the encoding property from a MediaType instance.- Returns:
- a map between a property name and its encoding information
-
setEncoding
Sets encoding property of a MediaType instance to the given map object.- Parameters:
encoding
- a map between property names and their encoding information
-
encoding
Sets encoding property of a MediaType instance to the given map object.- Parameters:
encoding
- a map between property names and their encoding information- Returns:
- the current MediaType instance
-
addEncoding
Adds an Encoding item to the encoding property of a MediaType instance.- Parameters:
key
- a property name in the schemaencodingItem
- an encoding definition to apply to the schema property. null values will be rejected (implementation will throw an exception) or ignored.- Returns:
- the current MediaType instance
-
removeEncoding
Removes an Encoding item to the encoding property of a MediaType instance.- Parameters:
key
- a property name in the schema
-