CosmosStoredProcedureRequestOptions Class

Package:

com.azure.cosmos.models

Maven Artifact:

com.azure:azure-cosmos:4.79.1

• java.lang.Object
• • com.azure.cosmos.models.CosmosStoredProcedureRequestOptions

public final class CosmosStoredProcedureRequestOptions

Encapsulates options that can be specified for a request issued to cosmos stored procedure.

Constructor Summary

Constructor	Description
CosmosStoredProcedureRequestOptions()

Method Summary

Modifier and Type	Method and Description
String	getIfMatchETag() Gets the If-Match (ETag) associated with the request in the Azure Cosmos DB service.
String	getIfNoneMatchETag() Gets the If-None-Match (ETag) associated with the request in the Azure Cosmos DB service.
PartitionKey	getPartitionKey() Gets the partition key used to identify the current request's target partition.
String	getSessionToken() Gets the token for use with session consistency.
boolean	isScriptLoggingEnabled() Gets whether Javascript stored procedure logging is enabled for the current request in the Azure Cosmos DB database service or not.
CosmosStoredProcedureRequestOptions	setIfMatchETag(String ifMatchETag) Sets the If-Match (ETag) associated with the request in the Azure Cosmos DB service.
CosmosStoredProcedureRequestOptions	setIfNoneMatchETag(String ifNoneMatchETag) Sets the If-None-Match (ETag) associated with the request in the Azure Cosmos DB service.
CosmosStoredProcedureRequestOptions	setPartitionKey(PartitionKey partitionKey) Sets the partition key used to identify the current request's target partition.
CosmosStoredProcedureRequestOptions	setScriptLoggingEnabled(boolean scriptLoggingEnabled) Sets whether Javascript stored procedure logging is enabled for the current request in the Azure Cosmos DB database service or not.
CosmosStoredProcedureRequestOptions	setSessionToken(String sessionToken) Sets the token for use with session consistency.

Methods inherited from java.lang.Object

clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Constructor Details

CosmosStoredProcedureRequestOptions

public CosmosStoredProcedureRequestOptions()

Method Details

getIfMatchETag

public String getIfMatchETag()

Gets the If-Match (ETag) associated with the request in the Azure Cosmos DB service. Most commonly used with replace and delete requests. This will be ignored if specified for create requests. For more details, refer to optimistic concurrency control documentation

Returns:

the ifMatchETag associated with the request.

getIfNoneMatchETag

public String getIfNoneMatchETag()

Gets the If-None-Match (ETag) associated with the request in the Azure Cosmos DB service. Most commonly used to detect changes to the resource via read requests. When Item Etag matches the specified ifNoneMatchETag then 304 status code will be returned, otherwise existing Item will be returned with 200. To match any Etag use "*" This will be ignored if specified for write requests (ex: Create, Replace, Delete). For more details, refer to optimistic concurrency control documentation

Returns:

the ifNoneMatchETag associated with the request.

getPartitionKey

public PartitionKey getPartitionKey()

Gets the partition key used to identify the current request's target partition.

Returns:

the partition key value.

getSessionToken

public String getSessionToken()

Gets the token for use with session consistency.

Returns:

the session token.

isScriptLoggingEnabled

public boolean isScriptLoggingEnabled()

Gets whether Javascript stored procedure logging is enabled for the current request in the Azure Cosmos DB database service or not. Default value is false

Returns:

true if Javascript stored procedure logging is enabled

setIfMatchETag

public CosmosStoredProcedureRequestOptions setIfMatchETag(String ifMatchETag)

Sets the If-Match (ETag) associated with the request in the Azure Cosmos DB service. Most commonly used with replace and delete requests. This will be ignored if specified for create requests. For more details, refer to optimistic concurrency control documentation

Parameters:

ifMatchETag - the ifMatchETag associated with the request.

Returns:

the current request options

setIfNoneMatchETag

public CosmosStoredProcedureRequestOptions setIfNoneMatchETag(String ifNoneMatchETag)

Sets the If-None-Match (ETag) associated with the request in the Azure Cosmos DB service. Most commonly used to detect changes to the resource via read requests. When Item Etag matches the specified ifNoneMatchETag then 304 status code will be returned, otherwise existing Item will be returned with 200. To match any Etag use "*" This will be ignored if specified for write requests (ex: Create, Replace, Delete). For more details, refer to optimistic concurrency control documentation

Parameters:

ifNoneMatchETag - the ifNoneMatchETag associated with the request.

Returns:

the current request options

setPartitionKey

public CosmosStoredProcedureRequestOptions setPartitionKey(PartitionKey partitionKey)

Sets the partition key used to identify the current request's target partition.

Parameters:

partitionKey - the partition key value.

Returns:

the CosmosStoredProcedureRequestOptions.

setScriptLoggingEnabled

public CosmosStoredProcedureRequestOptions setScriptLoggingEnabled(boolean scriptLoggingEnabled)

Sets whether Javascript stored procedure logging is enabled for the current request in the Azure Cosmos DB database service or not. Default value is false

Parameters:

scriptLoggingEnabled - true if stored procedure Javascript logging is enabled

Returns:

the CosmosStoredProcedureRequestOptions.

setSessionToken

public CosmosStoredProcedureRequestOptions setSessionToken(String sessionToken)

Sets the token for use with session consistency.

Parameters:

sessionToken - the session token.

Returns:

the CosmosStoredProcedureRequestOptions.