Interface MediaType
- All Superinterfaces:
Constructible
,Extensible
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.Sets encoding property of a MediaType instance to the given map object.Sets the example property of a MediaType instance to the given value.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.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, getExtensions, 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- Returns:
- the current MediaType instance
-
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.- Returns:
- the current MediaType instance
-