public interface Operation extends Constructible, Extensible
Describes a single API operation on a path.
Modifier and Type | Method and Description |
---|---|
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.
|
Operation |
callbacks(java.util.Map<java.lang.String,Callback> callbacks)
Sets this Operation's callbacks property to the given map.
|
Operation |
deprecated(java.lang.Boolean deprecated)
Sets this Operation's deprecated property to the given value.
|
Operation |
description(java.lang.String description)
Sets this Operation's description property to the given string.
|
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.
|
Operation |
operationId(java.lang.String operationId)
Sets this Operation's operationId property to the given string.
|
Operation |
parameters(java.util.List<Parameter> parameters)
Sets this Operation's parameters property to the given parameter list.
|
Operation |
requestBody(RequestBody requestBody)
Sets this Operation's requestBody property to the given object.
|
Operation |
responses(APIResponses responses)
Sets this Operation's responses property to the given responses.
|
Operation |
security(java.util.List<SecurityRequirement> security)
Sets this Operation's security property to the given list.
|
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.
|
Operation |
summary(java.lang.String summary)
Sets this Operation's summary property to the given string.
|
Operation |
tags(java.util.List<java.lang.String> tags)
Sets this Operation's tags property to the given tags.
|
addExtension, getExtensions, 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 controlOperation 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 controljava.lang.String getSummary()
void setSummary(java.lang.String summary)
summary
- a short summary of what the operation doesOperation 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 behaviorOperation description(java.lang.String description)
description
- a verbose explanation of the operation behaviorExternalDocumentation getExternalDocs()
void setExternalDocs(ExternalDocumentation externalDocs)
externalDocs
- additional external documentation for this operationOperation 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 operationOperation 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 operationOperation 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 operationRequestBody getRequestBody()
void setRequestBody(RequestBody requestBody)
requestBody
- the request body applicable for this operationOperation requestBody(RequestBody requestBody)
requestBody
- the request body applicable for this operationAPIResponses getResponses()
void setResponses(APIResponses responses)
responses
- collection of possible responses from executing this operationOperation 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.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.java.lang.Boolean getDeprecated()
void setDeprecated(java.lang.Boolean deprecated)
deprecated
- declaration whether this operation is deprecatedOperation 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 operationOperation 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 operationjava.util.List<Server> getServers()
void setServers(java.util.List<Server> servers)
servers
- list of servers to service this operationOperation servers(java.util.List<Server> servers)
servers
- list of servers to service this operation