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, setExtensionsjava.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