Holds 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:
| Modifier and Type | Method and Description |
|---|---|
| public Components | Returns: the current Components objecta key conforming to the format required for this object key, Callback a reusable callback object. null values will be rejected (implementation will throw an exception) or
ignored. callback)Adds the given callback to this Components' map of callbacks with the given string as its key. |
| public Components | Returns: the current Components objecta key conforming to the format required for this object key, Example a reusable example object. null values will be rejected (implementation will throw an exception) or
ignored. example)Adds the given example to this Components' map of examples with the given string as its key. |
| public Components | Returns: the current Components objecta key conforming to the format required for this object key, Header a reusable header object. null values will be rejected (implementation will throw an exception) or
ignored. header)Adds the given header to this Components' map of headers with the given string as its key. |
| public Components | Returns: the current Components objecta key conforming to the format required for this object key, Link a reusable link object. null values will be rejected (implementation will throw an exception) or
ignored. link)Adds the given link to this Components' map of links with the given string as its key. |
| public Components | Returns: the current Components objecta key conforming to the format required for this object key, Parameter a reusable parameter object. null values will be rejected (implementation will throw an exception) or
ignored. parameter)Adds the given parameter to this Components' map of parameters with the given string as its key. |
| public Components | Returns: the current Schema instancename of the path item to add name, PathItem the path item to add pathItem)Adds a path item. |
| public Components | Returns: the current Components objecta key conforming to the format required for this object key, RequestBody a reusable request body object. null values will be rejected (implementation will throw an exception)
or ignored. requestBody)Adds the given request body to this Components' map of request bodies with the given string as its key. |
| public Components | Returns: the current Components objecta key conforming to the format required for this object key, APIResponse a reusable response object. null values will be rejected (implementation will throw an exception) or
ignored. response)Adds the given response to this Components' map of responses with the given string as its key. |
| public Components | Returns: the current Components objecta key conforming to the format required for this object key, Schema a reusable schema object. null values will be rejected (implementation will throw an exception) or
ignored. schema)Adds the given schema to this Components' list of schemas with the given string as its key. |
| public Components | Returns: the current Components objecta key conforming to the format required for this object key, SecurityScheme a reusable security scheme object. null values will be rejected (implementation will throw an
exception) or ignored. securityScheme)Adds the given security scheme to this Components' map of security schemes with the given string as its key. |
| public default Components | |
| public default Components | |
| public Map | Returns: a copy Map (potentially immutable) containing the keys and the reusable callbacks for this OpenAPI documentReturns the callbacks property from a Components instance. |
| public Map | Returns: a copy Map (potentially immutable) containing the keys and the reusable examples for this OpenAPI documentReturns the examples property from a Components instance. |
| public Map | Returns: a copy Map (potentially immutable) containing the keys and the reusable headers for this OpenAPI documentReturns the headers property from a Components instance. |
| public Map | Returns: a copy Map (potentially immutable) containing the keys and the reusable links for this OpenAPI documentReturns the links property from a Components instance. |
| public Map | Returns: a copy Map (potentially immutable) containing the keys and the reusable parameters of API operations for this OpenAPI documentReturns the parameters property from a Components instance. |
| public Map | Returns: a copy Map (potentially immutable) of path itemsReturns the pathItems property of this Components instance. |
| public Map | Returns: a copy Map (potentially immutable) containing the keys and the reusable request bodies for this OpenAPI documentReturns the requestBodies property from a Components instance. |
| public Map | Returns: a copy Map (potentially immutable) containing the keys and the reusable responses from API operations for this OpenAPI documentReturns the responses property from a Components instance. |
| public Map | Returns: a copy Map (potentially immutable) containing the keys and the reusable schemas for this OpenAPI documentReturns the schemas property from a Components instance. |
| public Map | Returns: a copy Map (potentially immutable) containing the keys and the reusable security schemes for this OpenAPI documentReturns the securitySchemes property from a Components instance. |
| public default Components | |
| public default Components | |
| public default Components | Returns: the current Components objecta Map containing keys and reusable parameter objects parameters)Sets this Components' parameters property to the given Map containing keys and reusable parameter objects. |
| public default Components | |
| public void | removeCallback(String
a key conforming to the format required for this object key)Removes the given callback to this Components' map of callbacks with the given string as its key. |
| public void | removeExample(String
a key conforming to the format required for this object key)Removes the given example to this Components' map of examples with the given string as its key. |
| public void | removeHeader(String
a key conforming to the format required for this object key)Removes the given header to this Components' map of headers with the given string as its key. |
| public void | removeLink(String
a key conforming to the format required for this object key)Removes the given link to this Components' map of links with the given string as its key. |
| public void | removeParameter(String
a key conforming to the format required for this object key)Removes the given parameter to this Components' map of parameters with the given string as its key. |
| public void | |
| public void | removeRequestBody(String
a key conforming to the format required for this object key)Removes the given request body to this Components' map of request bodies with the given string as its key. |
| public void | removeResponse(String
a key conforming to the format required for this object key)Removes the given response to this Components' map of responses with the given string as its key. |
| public void | removeSchema(String
a key conforming to the format required for this object key)Removes the given schema to this Components' list of schemas with the given string as its key. |
| public void | removeSecurityScheme(String
a key conforming to the format required for this object key)Removes the given security scheme to this Components' map of security schemes with the given string as its key. |
| public default Components | Returns: the current Components objecta Map containing the keys and reusable request body objects requestBodies)Sets this Components' requestBodies property to the given Map containing keys and reusable request body objects. |
| public default Components | Returns: the current Components objecta Map containing keys and reusable response objects responses)Sets this Components' responses property to the given Map containing keys and reusable response objects. |
| public default Components | |
| public default Components | Returns: the current Components objecta Map containing the keys and reusable security scheme objects securitySchemes)Sets this Components' securitySchemes property to the given Map containing keys and reusable security scheme objects. |
| public void | setCallbacks(Map<String, Callback>
a Map containing the keys and reusable callback objects callbacks)Sets this Components' callbacks property to the given Map containing keys and reusable callback objects. |
| public void | setExamples(Map<String, Example>
a Map containing keys and reusable example objects examples)Sets this Components' examples property to the given Map containing keys and reusable example objects. |
| public void | setHeaders(Map<String, Header>
a Map containing the keys and reusable header objects headers)Sets this Components' headers property to the given Map containing keys and reusable header objects. |
| public void | |
| public void | setParameters(Map<String, Parameter>
a Map containing keys and reusable parameter objects parameters)Sets this Components' parameters property to the given Map containing keys and reusable parameter objects. |
| public void | setPathItems(Map<String, PathItem>
a map of path items pathItems)Sets the pathItems property of this Components instance. |
| public void | setRequestBodies(Map<String, RequestBody>
a Map containing the keys and reusable request body objects requestBodies)Sets this Components' requestBodies property to the given Map containing keys and reusable request body objects. |
| public void | setResponses(Map<String, APIResponse>
a Map containing keys and reusable response objects responses)Sets this Components' responses property to the given Map containing keys and reusable response objects. |
| public void | setSchemas(Map<String, Schema>
a Map containing keys and reusable schema objects schemas)Sets this Components' schemas property to the given Map containing keys and reusable schema objects. |
| public void | setSecuritySchemes(Map<String, SecurityScheme>
a Map containing the keys and reusable security scheme objects securitySchemes)Sets this Components' securitySchemes property to the given Map containing keys and reusable security scheme objects. |
| addCallback | back to summary |
|---|---|
| public Components addCallback(String key, Callback callback) Adds the given callback to this Components' map of callbacks with the given string as its key.
| |
| addExample | back to summary |
|---|---|
| public Components addExample(String key, Example example) Adds the given example to this Components' map of examples with the given string as its key.
| |
| addHeader | back to summary |
|---|---|
| public Components addHeader(String key, Header header) Adds the given header to this Components' map of headers with the given string as its key.
| |
| addLink | back to summary |
|---|---|
| public Components addLink(String key, Link link) Adds the given link to this Components' map of links with the given string as its key.
| |
| addParameter | back to summary |
|---|---|
| public Components addParameter(String key, Parameter parameter) Adds the given parameter to this Components' map of parameters with the given string as its key.
| |
| addPathItem | back to summary |
|---|---|
| public Components addPathItem(String name, PathItem pathItem) Adds a path item.
| |
| addRequestBody | back to summary |
|---|---|
| public Components addRequestBody(String key, RequestBody requestBody) Adds the given request body to this Components' map of request bodies with the given string as its key.
| |
| addResponse | back to summary |
|---|---|
| public Components addResponse(String key, APIResponse response) Adds the given response to this Components' map of responses with the given string as its key.
| |
| addSchema | back to summary |
|---|---|
| public Components addSchema(String key, Schema schema) Adds the given schema to this Components' list of schemas with the given string as its key.
| |
| addSecurityScheme | back to summary |
|---|---|
| public Components addSecurityScheme(String key, SecurityScheme securityScheme) Adds the given security scheme to this Components' map of security schemes with the given string as its key.
| |
| callbacks | back to summary |
|---|---|
| public default Components callbacks(Map<String, Callback> callbacks) Sets this Components' callbacks property to the given Map containing keys and reusable callback objects.
| |
| examples | back to summary |
|---|---|
| public default Components examples(Map<String, Example> examples) Sets this Components' examples property to the given Map containing keys and reusable example objects.
| |
| getCallbacks | back to summary |
|---|---|
| public Map Returns the callbacks property from a Components instance. | |
| getExamples | back to summary |
|---|---|
| public Map Returns the examples property from a Components instance. | |
| getHeaders | back to summary |
|---|---|
| public Map Returns the headers property from a Components instance. | |
| getLinks | back to summary |
|---|---|
| public Map Returns the links property from a Components instance. | |
| getParameters | back to summary |
|---|---|
| public Map Returns the parameters property from a Components instance. | |
| getPathItems | back to summary |
|---|---|
| public Map Returns the pathItems property of this Components instance. Path items listed here can be referenced from elsewhere in the OpenAPI document. | |
| getRequestBodies | back to summary |
|---|---|
| public Map Returns the requestBodies property from a Components instance.
| |
| getResponses | back to summary |
|---|---|
| public Map Returns the responses property from a Components instance.
| |
| getSchemas | back to summary |
|---|---|
| public Map Returns the schemas property from a Components instance. | |
| getSecuritySchemes | back to summary |
|---|---|
| public Map Returns the securitySchemes property from a Components instance.
| |
| headers | back to summary |
|---|---|
| public default Components headers(Map<String, Header> headers) Sets this Components' headers property to the given Map containing keys and reusable header objects.
| |
| links | back to summary |
|---|---|
| public default Components links(Map<String, Link> links) Sets this Components' links property to the given Map containing keys and reusable link objects.
| |
| parameters | back to summary |
|---|---|
| public default Components parameters(Map<String, Parameter> parameters) Sets this Components' parameters property to the given Map containing keys and reusable parameter objects.
| |
| pathItems | back to summary |
|---|---|
| public default Components pathItems(Map<String, PathItem> pathItems) Sets the pathItems property of this Components instance. Path items listed here can be referenced from elsewhere in the OpenAPI document.
| |
| removeCallback | back to summary |
|---|---|
| public void removeCallback(String key) Removes the given callback to this Components' map of callbacks with the given string as its key.
| |
| removeExample | back to summary |
|---|---|
| public void removeExample(String key) Removes the given example to this Components' map of examples with the given string as its key.
| |
| removeHeader | back to summary |
|---|---|
| public void removeHeader(String key) Removes the given header to this Components' map of headers with the given string as its key.
| |
| removeLink | back to summary |
|---|---|
| public void removeLink(String key) Removes the given link to this Components' map of links with the given string as its key.
| |
| removeParameter | back to summary |
|---|---|
| public void removeParameter(String key) Removes the given parameter to this Components' map of parameters with the given string as its key.
| |
| removePathItem | back to summary |
|---|---|
| public void removePathItem(String name) Removes a path item.
| |
| removeRequestBody | back to summary |
|---|---|
| public void removeRequestBody(String key) Removes the given request body to this Components' map of request bodies with the given string as its key.
| |
| removeResponse | back to summary |
|---|---|
| public void removeResponse(String key) Removes the given response to this Components' map of responses with the given string as its key.
| |
| removeSchema | back to summary |
|---|---|
| public void removeSchema(String key) Removes the given schema to this Components' list of schemas with the given string as its key.
| |
| removeSecurityScheme | back to summary |
|---|---|
| public void removeSecurityScheme(String key) Removes the given security scheme to this Components' map of security schemes with the given string as its key.
| |
| requestBodies | back to summary |
|---|---|
| public default Components requestBodies(Map<String, RequestBody> requestBodies) Sets this Components' requestBodies property to the given Map containing keys and reusable request body objects.
| |
| responses | back to summary |
|---|---|
| public default Components responses(Map<String, APIResponse> responses) Sets this Components' responses property to the given Map containing keys and reusable response objects.
| |
| schemas | back to summary |
|---|---|
| public default Components schemas(Map<String, Schema> schemas) Sets this Components' schemas property to the given Map containing keys and reusable schemas.
| |
| securitySchemes | back to summary |
|---|---|
| public default Components securitySchemes(Map<String, SecurityScheme> securitySchemes) Sets this Components' securitySchemes property to the given Map containing keys and reusable security scheme objects.
| |
| setCallbacks | back to summary |
|---|---|
| public void setCallbacks(Map<String, Callback> callbacks) Sets this Components' callbacks property to the given Map containing keys and reusable callback objects. | |
| setExamples | back to summary |
|---|---|
| public void setExamples(Map<String, Example> examples) Sets this Components' examples property to the given Map containing keys and reusable example objects. | |
| setHeaders | back to summary |
|---|---|
| public void setHeaders(Map<String, Header> headers) Sets this Components' headers property to the given Map containing keys and reusable header objects. | |
| setLinks | back to summary |
|---|---|
| public void setLinks(Map<String, Link> links) Sets this Components' links property to the given Map containing keys and reusable link objects. | |
| setParameters | back to summary |
|---|---|
| public void setParameters(Map<String, Parameter> parameters) Sets this Components' parameters property to the given Map containing keys and reusable parameter objects. | |
| setPathItems | back to summary |
|---|---|
| public void setPathItems(Map<String, PathItem> pathItems) Sets the pathItems property of this Components instance. Path items listed here can be referenced from elsewhere in the OpenAPI document. | |
| setRequestBodies | back to summary |
|---|---|
| public void setRequestBodies(Map<String, RequestBody> requestBodies) Sets this Components' requestBodies property to the given Map containing keys and reusable request body objects.
| |
| setResponses | back to summary |
|---|---|
| public void setResponses(Map<String, APIResponse> responses) Sets this Components' responses property to the given Map containing keys and reusable response objects.
| |
| setSchemas | back to summary |
|---|---|
| public void setSchemas(Map<String, Schema> schemas) Sets this Components' schemas property to the given Map containing keys and reusable schema objects. | |
| setSecuritySchemes | back to summary |
|---|---|
| public void setSecuritySchemes(Map<String, SecurityScheme> securitySchemes) Sets this Components' securitySchemes property to the given Map containing keys and reusable security scheme objects.
| |