Interface Components
-
- All Superinterfaces:
Constructible
,Extensible<Components>
public interface Components extends Constructible, Extensible<Components>
ComponentsHolds a set of reusable objects for different aspects of the API specification. All objects defined within this object will have no effect on the API unless they are explicitly referenced from properties outside the components object.
All the fields are indexed by keys that must match the regular expression:
^[a-zA-Z0-9\.\-_]+$
.Key Examples:
- User
- User_1
- User_Name
- user-name
- my.org.User
- See Also:
- OpenAPI Specification Components Object
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description Components
addCallback(java.lang.String key, Callback callback)
Adds the given callback to this Components' map of callbacks with the given string as its key.Components
addExample(java.lang.String key, Example example)
Adds the given example to this Components' map of examples with the given string as its key.Components
addHeader(java.lang.String key, Header header)
Adds the given header to this Components' map of headers with the given string as its key.Components
addLink(java.lang.String key, Link link)
Adds the given link to this Components' map of links with the given string as its key.Components
addParameter(java.lang.String key, Parameter parameter)
Adds the given parameter to this Components' map of parameters with the given string as its key.Components
addRequestBody(java.lang.String key, RequestBody requestBody)
Adds the given request body to this Components' map of request bodies with the given string as its key.Components
addResponse(java.lang.String key, APIResponse response)
Adds the given response to this Components' map of responses with the given string as its key.Components
addSchema(java.lang.String key, Schema schema)
Adds the given schema to this Components' list of schemas with the given string as its key.Components
addSecurityScheme(java.lang.String key, SecurityScheme securityScheme)
Adds the given security scheme to this Components' map of security schemes with the given string as its key.default Components
callbacks(java.util.Map<java.lang.String,Callback> callbacks)
Sets this Components' callbacks property to the given Map containing keys and reusable callback objects.default Components
examples(java.util.Map<java.lang.String,Example> examples)
Sets this Components' examples property to the given Map containing keys and reusable example objects.java.util.Map<java.lang.String,Callback>
getCallbacks()
Returns the callbacks property from a Components instance.java.util.Map<java.lang.String,Example>
getExamples()
Returns the examples property from a Components instance.java.util.Map<java.lang.String,Header>
getHeaders()
Returns the headers property from a Components instance.java.util.Map<java.lang.String,Link>
getLinks()
Returns the links property from a Components instance.java.util.Map<java.lang.String,Parameter>
getParameters()
Returns the parameters property from a Components instance.java.util.Map<java.lang.String,RequestBody>
getRequestBodies()
Returns the requestBodies property from a Components instance.java.util.Map<java.lang.String,APIResponse>
getResponses()
Returns the responses property from a Components instance.java.util.Map<java.lang.String,Schema>
getSchemas()
Returns the schemas property from a Components instance.java.util.Map<java.lang.String,SecurityScheme>
getSecuritySchemes()
Returns the securitySchemes property from a Components instance.default Components
headers(java.util.Map<java.lang.String,Header> headers)
Sets this Components' headers property to the given Map containing keys and reusable header objects.default Components
links(java.util.Map<java.lang.String,Link> links)
Sets this Components' links property to the given Map containing keys and reusable link objects.default Components
parameters(java.util.Map<java.lang.String,Parameter> parameters)
Sets this Components' parameters property to the given Map containing keys and reusable parameter objects.void
removeCallback(java.lang.String key)
Removes the given callback to this Components' map of callbacks with the given string as its key.void
removeExample(java.lang.String key)
Removes the given example to this Components' map of examples with the given string as its key.void
removeHeader(java.lang.String key)
Removes the given header to this Components' map of headers with the given string as its key.void
removeLink(java.lang.String key)
Removes the given link to this Components' map of links with the given string as its key.void
removeParameter(java.lang.String key)
Removes the given parameter to this Components' map of parameters with the given string as its key.void
removeRequestBody(java.lang.String key)
Removes the given request body to this Components' map of request bodies with the given string as its key.void
removeResponse(java.lang.String key)
Removes the given response to this Components' map of responses with the given string as its key.void
removeSchema(java.lang.String key)
Removes the given schema to this Components' list of schemas with the given string as its key.void
removeSecurityScheme(java.lang.String key)
Removes the given security scheme to this Components' map of security schemes with the given string as its key.default Components
requestBodies(java.util.Map<java.lang.String,RequestBody> requestBodies)
Sets this Components' requestBodies property to the given Map containing keys and reusable request body objects.default Components
responses(java.util.Map<java.lang.String,APIResponse> responses)
Sets this Components' responses property to the given Map containing keys and reusable response objects.default Components
schemas(java.util.Map<java.lang.String,Schema> schemas)
Sets this Components' schemas property to the given Map containing keys and reusable schemas.default Components
securitySchemes(java.util.Map<java.lang.String,SecurityScheme> securitySchemes)
Sets this Components' securitySchemes property to the given Map containing keys and reusable security scheme objects.void
setCallbacks(java.util.Map<java.lang.String,Callback> callbacks)
Sets this Components' callbacks property to the given Map containing keys and reusable callback objects.void
setExamples(java.util.Map<java.lang.String,Example> examples)
Sets this Components' examples property to the given Map containing keys and reusable example objects.void
setHeaders(java.util.Map<java.lang.String,Header> headers)
Sets this Components' headers property to the given Map containing keys and reusable header objects.void
setLinks(java.util.Map<java.lang.String,Link> links)
Sets this Components' links property to the given Map containing keys and reusable link objects.void
setParameters(java.util.Map<java.lang.String,Parameter> parameters)
Sets this Components' parameters property to the given Map containing keys and reusable parameter objects.void
setRequestBodies(java.util.Map<java.lang.String,RequestBody> requestBodies)
Sets this Components' requestBodies property to the given Map containing keys and reusable request body objects.void
setResponses(java.util.Map<java.lang.String,APIResponse> responses)
Sets this Components' responses property to the given Map containing keys and reusable response objects.void
setSchemas(java.util.Map<java.lang.String,Schema> schemas)
Sets this Components' schemas property to the given Map containing keys and reusable schema objects.void
setSecuritySchemes(java.util.Map<java.lang.String,SecurityScheme> securitySchemes)
Sets this Components' securitySchemes property to the given Map containing keys and reusable security scheme objects.-
Methods inherited from interface org.eclipse.microprofile.openapi.models.Extensible
addExtension, extensions, getExtensions, removeExtension, setExtensions
-
-
-
-
Method Detail
-
getSchemas
java.util.Map<java.lang.String,Schema> getSchemas()
Returns the schemas property from a Components instance.- Returns:
- a Map containing the keys and the reusable schemas for this OpenAPI document
-
setSchemas
void setSchemas(java.util.Map<java.lang.String,Schema> schemas)
Sets this Components' schemas property to the given Map containing keys and reusable schema objects.- Parameters:
schemas
- a Map containing keys and reusable schema objects
-
schemas
default Components schemas(java.util.Map<java.lang.String,Schema> schemas)
Sets this Components' schemas property to the given Map containing keys and reusable schemas.- Parameters:
schemas
- a Map containing keys and reusable schemas- Returns:
- the current Components object
-
addSchema
Components addSchema(java.lang.String key, Schema schema)
Adds the given schema to this Components' list of schemas with the given string as its key.- Parameters:
key
- a key conforming to the format required for this objectschema
- a reusable schema object. null values will be rejected (implementation will throw an exception) or ignored.- Returns:
- the current Components object
-
removeSchema
void removeSchema(java.lang.String key)
Removes the given schema to this Components' list of schemas with the given string as its key.- Parameters:
key
- a key conforming to the format required for this object
-
getResponses
java.util.Map<java.lang.String,APIResponse> getResponses()
Returns the responses property from a Components instance.- Returns:
- a Map containing the keys and the reusable responses from API operations for this OpenAPI document
-
setResponses
void setResponses(java.util.Map<java.lang.String,APIResponse> responses)
Sets this Components' responses property to the given Map containing keys and reusable response objects.- Parameters:
responses
- a Map containing keys and reusable response objects
-
responses
default Components responses(java.util.Map<java.lang.String,APIResponse> responses)
Sets this Components' responses property to the given Map containing keys and reusable response objects.- Parameters:
responses
- a Map containing keys and reusable response objects- Returns:
- the current Components object
-
addResponse
Components addResponse(java.lang.String key, APIResponse response)
Adds the given response to this Components' map of responses with the given string as its key.- Parameters:
key
- a key conforming to the format required for this objectresponse
- a reusable response object. null values will be rejected (implementation will throw an exception) or ignored.- Returns:
- the current Components object
-
removeResponse
void removeResponse(java.lang.String key)
Removes the given response to this Components' map of responses with the given string as its key.- Parameters:
key
- a key conforming to the format required for this object
-
getParameters
java.util.Map<java.lang.String,Parameter> getParameters()
Returns the parameters property from a Components instance.- Returns:
- a Map containing the keys and the reusable parameters of API operations for this OpenAPI document
-
setParameters
void setParameters(java.util.Map<java.lang.String,Parameter> parameters)
Sets this Components' parameters property to the given Map containing keys and reusable parameter objects.- Parameters:
parameters
- a Map containing keys and reusable parameter objects
-
parameters
default Components parameters(java.util.Map<java.lang.String,Parameter> parameters)
Sets this Components' parameters property to the given Map containing keys and reusable parameter objects.- Parameters:
parameters
- a Map containing keys and reusable parameter objects- Returns:
- the current Components object
-
addParameter
Components addParameter(java.lang.String key, Parameter parameter)
Adds the given parameter to this Components' map of parameters with the given string as its key.- Parameters:
key
- a key conforming to the format required for this objectparameter
- a reusable parameter object. null values will be rejected (implementation will throw an exception) or ignored.- Returns:
- the current Components object
-
removeParameter
void removeParameter(java.lang.String key)
Removes the given parameter to this Components' map of parameters with the given string as its key.- Parameters:
key
- a key conforming to the format required for this object
-
getExamples
java.util.Map<java.lang.String,Example> getExamples()
Returns the examples property from a Components instance.- Returns:
- a Map containing the keys and the reusable examples for this OpenAPI document
-
setExamples
void setExamples(java.util.Map<java.lang.String,Example> examples)
Sets this Components' examples property to the given Map containing keys and reusable example objects.- Parameters:
examples
- a Map containing keys and reusable example objects
-
examples
default Components examples(java.util.Map<java.lang.String,Example> examples)
Sets this Components' examples property to the given Map containing keys and reusable example objects.- Parameters:
examples
- a Map containing keys and reusable example objects- Returns:
- the current Components object
-
addExample
Components addExample(java.lang.String key, Example example)
Adds the given example to this Components' map of examples with the given string as its key.- Parameters:
key
- a key conforming to the format required for this objectexample
- a reusable example object. null values will be rejected (implementation will throw an exception) or ignored.- Returns:
- the current Components object
-
removeExample
void removeExample(java.lang.String key)
Removes the given example to this Components' map of examples with the given string as its key.- Parameters:
key
- a key conforming to the format required for this object
-
getRequestBodies
java.util.Map<java.lang.String,RequestBody> getRequestBodies()
Returns the requestBodies property from a Components instance.- Returns:
- a Map containing the keys and the reusable request bodies for this OpenAPI document
-
setRequestBodies
void setRequestBodies(java.util.Map<java.lang.String,RequestBody> requestBodies)
Sets this Components' requestBodies property to the given Map containing keys and reusable request body objects.- Parameters:
requestBodies
- a Map containing the keys and reusable request body objects
-
requestBodies
default Components requestBodies(java.util.Map<java.lang.String,RequestBody> requestBodies)
Sets this Components' requestBodies property to the given Map containing keys and reusable request body objects.- Parameters:
requestBodies
- a Map containing the keys and reusable request body objects- Returns:
- the current Components object
-
addRequestBody
Components addRequestBody(java.lang.String key, RequestBody requestBody)
Adds the given request body to this Components' map of request bodies with the given string as its key.- Parameters:
key
- a key conforming to the format required for this objectrequestBody
- a reusable request body object. null values will be rejected (implementation will throw an exception) or ignored.- Returns:
- the current Components object
-
removeRequestBody
void removeRequestBody(java.lang.String key)
Removes the given request body to this Components' map of request bodies with the given string as its key.- Parameters:
key
- a key conforming to the format required for this object
-
getHeaders
java.util.Map<java.lang.String,Header> getHeaders()
Returns the headers property from a Components instance.- Returns:
- a Map containing the keys and the reusable headers for this OpenAPI document
-
setHeaders
void setHeaders(java.util.Map<java.lang.String,Header> headers)
Sets this Components' headers property to the given Map containing keys and reusable header objects.- Parameters:
headers
- a Map containing the keys and reusable header objects
-
headers
default Components headers(java.util.Map<java.lang.String,Header> headers)
Sets this Components' headers property to the given Map containing keys and reusable header objects.- Parameters:
headers
- a Map containing the keys and reusable header objects- Returns:
- the current Components object
-
addHeader
Components addHeader(java.lang.String key, Header header)
Adds the given header to this Components' map of headers with the given string as its key.- Parameters:
key
- a key conforming to the format required for this objectheader
- a reusable header object. null values will be rejected (implementation will throw an exception) or ignored.- Returns:
- the current Components object
-
removeHeader
void removeHeader(java.lang.String key)
Removes the given header to this Components' map of headers with the given string as its key.- Parameters:
key
- a key conforming to the format required for this object
-
getSecuritySchemes
java.util.Map<java.lang.String,SecurityScheme> getSecuritySchemes()
Returns the securitySchemes property from a Components instance.- Returns:
- a Map containing the keys and the reusable security schemes for this OpenAPI document
-
setSecuritySchemes
void setSecuritySchemes(java.util.Map<java.lang.String,SecurityScheme> securitySchemes)
Sets this Components' securitySchemes property to the given Map containing keys and reusable security scheme objects.- Parameters:
securitySchemes
- a Map containing the keys and reusable security scheme objects
-
securitySchemes
default Components securitySchemes(java.util.Map<java.lang.String,SecurityScheme> securitySchemes)
Sets this Components' securitySchemes property to the given Map containing keys and reusable security scheme objects.- Parameters:
securitySchemes
- a Map containing the keys and reusable security scheme objects- Returns:
- the current Components object
-
addSecurityScheme
Components addSecurityScheme(java.lang.String key, SecurityScheme securityScheme)
Adds the given security scheme to this Components' map of security schemes with the given string as its key.- Parameters:
key
- a key conforming to the format required for this objectsecurityScheme
- a reusable security scheme object. null values will be rejected (implementation will throw an exception) or ignored.- Returns:
- the current Components object
-
removeSecurityScheme
void removeSecurityScheme(java.lang.String key)
Removes the given security scheme to this Components' map of security schemes with the given string as its key.- Parameters:
key
- a key conforming to the format required for this object
-
getLinks
java.util.Map<java.lang.String,Link> getLinks()
Returns the links property from a Components instance.- Returns:
- a Map containing the keys and the reusable links for this OpenAPI document
-
setLinks
void setLinks(java.util.Map<java.lang.String,Link> links)
Sets this Components' links property to the given Map containing keys and reusable link objects.- Parameters:
links
- a Map containing the keys and reusable link objects
-
links
default Components links(java.util.Map<java.lang.String,Link> links)
Sets this Components' links property to the given Map containing keys and reusable link objects.- Parameters:
links
- a Map containing the keys and reusable link objects- Returns:
- the current Components object
-
addLink
Components addLink(java.lang.String key, Link link)
Adds the given link to this Components' map of links with the given string as its key.- Parameters:
key
- a key conforming to the format required for this objectlink
- a reusable link object. null values will be rejected (implementation will throw an exception) or ignored.- Returns:
- the current Components object
-
removeLink
void removeLink(java.lang.String key)
Removes the given link to this Components' map of links with the given string as its key.- Parameters:
key
- a key conforming to the format required for this object
-
getCallbacks
java.util.Map<java.lang.String,Callback> getCallbacks()
Returns the callbacks property from a Components instance.- Returns:
- a Map containing the keys and the reusable callbacks for this OpenAPI document
-
setCallbacks
void setCallbacks(java.util.Map<java.lang.String,Callback> callbacks)
Sets this Components' callbacks property to the given Map containing keys and reusable callback objects.- Parameters:
callbacks
- a Map containing the keys and reusable callback objects
-
callbacks
default Components callbacks(java.util.Map<java.lang.String,Callback> callbacks)
Sets this Components' callbacks property to the given Map containing keys and reusable callback objects.- Parameters:
callbacks
- a Map containing the keys and reusable callback objects- Returns:
- the current Components object
-
addCallback
Components addCallback(java.lang.String key, Callback callback)
Adds the given callback to this Components' map of callbacks with the given string as its key.- Parameters:
key
- a key conforming to the format required for this objectcallback
- a reusable callback object. null values will be rejected (implementation will throw an exception) or ignored.- Returns:
- the current Components object
-
removeCallback
void removeCallback(java.lang.String key)
Removes the given callback to this Components' map of callbacks with the given string as its key.- Parameters:
key
- a key conforming to the format required for this object
-
-