public interface Operation extends Constructible, Extensible<Operation>
Describes a single API operation on a path.
Modifier and Type | Method and Description |
---|---|
Operation |
addCallback(java.lang.String key,
Callback callback)
Adds the given callback item to this Operation's map of callbacks.
|
Operation |
addParameter(Parameter parameter)
Adds the given parameter item to this Operation's list of parameters.
|
Operation |
addSecurityRequirement(SecurityRequirement securityRequirement)
Adds the given security requirement item to this Operation's list of security mechanisms.
|
Operation |
addServer(Server server)
Adds the given server to this Operation's list of servers.
|
Operation |
addTag(java.lang.String tag)
Adds the given tag to this Operation's list of tags.
|
default Operation |
callbacks(java.util.Map<java.lang.String,Callback> callbacks)
Sets this Operation's callbacks property to the given map.
|
default Operation |
deprecated(java.lang.Boolean deprecated)
Sets this Operation's deprecated property to the given value.
|
default Operation |
description(java.lang.String description)
Sets this Operation's description property to the given string.
|
default Operation |
externalDocs(ExternalDocumentation externalDocs)
Sets this Operation's externalDocs property to the given object.
|
java.util.Map<java.lang.String,Callback> |
getCallbacks()
Returns the callbacks property from an Operation instance.
|
java.lang.Boolean |
getDeprecated()
Returns the deprecated property from an Operation instance.
|
java.lang.String |
getDescription()
Returns the description property from an Operation instance.
|
ExternalDocumentation |
getExternalDocs()
Returns the externalDocs property from an Operation instance.
|
java.lang.String |
getOperationId()
Returns the operationId property from an Operation instance.
|
java.util.List<Parameter> |
getParameters()
Returns the parameters property from an Operation instance.
|
RequestBody |
getRequestBody()
Returns the requestBody property from an Operation instance.
|
APIResponses |
getResponses()
Returns the responses property from an Operation instance.
|
java.util.List<SecurityRequirement> |
getSecurity()
Returns the security property from an Operation instance.
|
java.util.List<Server> |
getServers()
Returns the servers property from an Operation instance.
|
java.lang.String |
getSummary()
Returns the summary property from an Operation instance.
|
java.util.List<java.lang.String> |
getTags()
Returns the tags property from an Operation instance.
|
default Operation |
operationId(java.lang.String operationId)
Sets this Operation's operationId property to the given string.
|
default Operation |
parameters(java.util.List<Parameter> parameters)
Sets this Operation's parameters property to the given parameter list.
|
void |
removeCallback(java.lang.String key)
Removes the given callback item to this Operation's map of callbacks.
|
void |
removeParameter(Parameter parameter)
Removes the given parameter item to this Operation's list of parameters.
|
void |
removeSecurityRequirement(SecurityRequirement securityRequirement)
Removes the given security requirement item to this Operation's list of security mechanisms.
|
void |
removeServer(Server server)
Removes the given server to this Operation's list of servers.
|
void |
removeTag(java.lang.String tag)
Removes the given tag to this Operation's list of tags.
|
default Operation |
requestBody(RequestBody requestBody)
Sets this Operation's requestBody property to the given object.
|
default Operation |
responses(APIResponses responses)
Sets this Operation's responses property to the given responses.
|
default Operation |
security(java.util.List<SecurityRequirement> security)
Sets this Operation's security property to the given list.
|
default Operation |
servers(java.util.List<Server> servers)
Sets this Operation's servers property to the given list.
|
void |
setCallbacks(java.util.Map<java.lang.String,Callback> callbacks)
Sets this Operation's callbacks property to the given map.
|
void |
setDeprecated(java.lang.Boolean deprecated)
Sets this Operation's deprecated property to the given value.
|
void |
setDescription(java.lang.String description)
Sets this Operation's description property to the given string.
|
void |
setExternalDocs(ExternalDocumentation externalDocs)
Sets this Operation's externalDocs property to the given object.
|
void |
setOperationId(java.lang.String operationId)
Sets this Operation's operationId property to the given string.
|
void |
setParameters(java.util.List<Parameter> parameters)
Sets this Operation's parameters property to the given parameter list.
|
void |
setRequestBody(RequestBody requestBody)
Sets this Operation's requestBody property to the given object.
|
void |
setResponses(APIResponses responses)
Sets this Operation's responses property to the given responses.
|
void |
setSecurity(java.util.List<SecurityRequirement> security)
Sets this Operation's security property to the given list.
|
void |
setServers(java.util.List<Server> servers)
Sets this Operation's servers property to the given list.
|
void |
setSummary(java.lang.String summary)
Sets this Operation's summary property to the given string.
|
void |
setTags(java.util.List<java.lang.String> tags)
Sets this Operation's tags property to the given tags.
|
default Operation |
summary(java.lang.String summary)
Sets this Operation's summary property to the given string.
|
default Operation |
tags(java.util.List<java.lang.String> tags)
Sets this Operation's tags property to the given tags.
|
addExtension, extensions, getExtensions, removeExtension, setExtensions
java.util.List<java.lang.String> getTags()
void setTags(java.util.List<java.lang.String> tags)
tags
- a list of tags for API documentation controldefault Operation tags(java.util.List<java.lang.String> tags)
tags
- a list of tags for API documentation controlOperation addTag(java.lang.String tag)
tag
- a tag for API documentation controlvoid removeTag(java.lang.String tag)
tag
- a tag for API documentation controljava.lang.String getSummary()
void setSummary(java.lang.String summary)
summary
- a short summary of what the operation doesdefault Operation summary(java.lang.String summary)
summary
- a short summary of what the operation doesjava.lang.String getDescription()
void setDescription(java.lang.String description)
description
- a verbose explanation of the operation behaviordefault Operation description(java.lang.String description)
description
- a verbose explanation of the operation behaviorExternalDocumentation getExternalDocs()
void setExternalDocs(ExternalDocumentation externalDocs)
externalDocs
- additional external documentation for this operationdefault Operation externalDocs(ExternalDocumentation externalDocs)
externalDocs
- additional external documentation for this operationjava.lang.String getOperationId()
void setOperationId(java.lang.String operationId)
operationId
- unique string used to identify the operationdefault Operation operationId(java.lang.String operationId)
operationId
- unique string used to identify the operationjava.util.List<Parameter> getParameters()
void setParameters(java.util.List<Parameter> parameters)
parameters
- a list of parameters that are applicable for this operationdefault Operation parameters(java.util.List<Parameter> parameters)
parameters
- a list of parameters that are applicable for this operationOperation addParameter(Parameter parameter)
parameter
- a parameter that is applicable for this operationvoid removeParameter(Parameter parameter)
parameter
- a parameter that is applicable for this operationRequestBody getRequestBody()
void setRequestBody(RequestBody requestBody)
requestBody
- the request body applicable for this operationdefault Operation requestBody(RequestBody requestBody)
requestBody
- the request body applicable for this operationAPIResponses getResponses()
void setResponses(APIResponses responses)
responses
- collection of possible responses from executing this operationdefault Operation responses(APIResponses responses)
responses
- collection of possible responses from executing this operationjava.util.Map<java.lang.String,Callback> getCallbacks()
void setCallbacks(java.util.Map<java.lang.String,Callback> callbacks)
callbacks
- map of possible out-of-band callbacks related to the operation. The key value must be the correct format for this field.default Operation callbacks(java.util.Map<java.lang.String,Callback> callbacks)
callbacks
- map of possible out-of-band callbacks related to the operation. The key value must be the correct format for this field.Operation addCallback(java.lang.String key, Callback callback)
key
- a key conforming to the format required for this objectcallback
- a callback that is applicable for this operation. null values will be rejected (implementation will throw an exception) or
ignored.void removeCallback(java.lang.String key)
key
- a key conforming to the format required for this objectjava.lang.Boolean getDeprecated()
void setDeprecated(java.lang.Boolean deprecated)
deprecated
- declaration whether this operation is deprecateddefault Operation deprecated(java.lang.Boolean deprecated)
deprecated
- declaration whether this operation is deprecatedjava.util.List<SecurityRequirement> getSecurity()
void setSecurity(java.util.List<SecurityRequirement> security)
security
- list of which security mechanisms can be used for this operationdefault Operation security(java.util.List<SecurityRequirement> security)
security
- list of which security mechanisms can be used for this operationOperation addSecurityRequirement(SecurityRequirement securityRequirement)
securityRequirement
- security mechanism which can be used for this operationvoid removeSecurityRequirement(SecurityRequirement securityRequirement)
securityRequirement
- security mechanism which can be used for this operationjava.util.List<Server> getServers()
void setServers(java.util.List<Server> servers)
servers
- list of servers to service this operationdefault Operation servers(java.util.List<Server> servers)
servers
- list of servers to service this operationOperation addServer(Server server)
server
- server which can service this operationvoid removeServer(Server server)
server
- server which can service this operation