com.microsoft.azure.cosmosdb

Class DocumentClientException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.microsoft.azure.cosmosdb.DocumentClientException

All Implemented Interfaces:

Serializable

public class DocumentClientException
extends Exception

This class defines a custom exception type for all operations on DocumentClient in the Azure Cosmos DB database service. Applications are expected to catch DocumentClientException and handle errors as appropriate when calling methods on DocumentClient.

Errors coming from the service during normal execution are converted to DocumentClientException before returning to the application with the following exception:

When a BE error is encountered during a QueryIterable<T> iteration, an IllegalStateException is thrown instead of DocumentClientException.

When a transport level error happens that request is not able to reach the service, an IllegalStateException is thrown instead of DocumentClientException.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
DocumentClientException(int statusCode) Creates a new instance of the DocumentClientException class.
DocumentClientException(int statusCode, Error errorResource, Map<String,String> responseHeaders) Creates a new instance of the DocumentClientException class.
DocumentClientException(int statusCode, Exception innerException) Creates a new instance of the DocumentClientException class.
DocumentClientException(int statusCode, String errorMessage) Creates a new instance of the DocumentClientException class.
DocumentClientException(String message, Exception exception, Map<String,String> responseHeaders, int statusCode, String resourceAddress) Creates a new instance of the DocumentClientException class.
DocumentClientException(String resourceAddress, int statusCode, Error errorResource, Map<String,String> responseHeaders) Creates a new instance of the DocumentClientException class.

Method Summary

Modifier and Type	Method and Description
String	getActivityId() Gets the activity ID associated with the request.
ClientSideRequestStatistics	getClientSideRequestStatistics() Gets the Client side request statistics associated with this exception.
Error	getError() Gets the error code associated with the exception.
long	getLsn() Gets the LSN associated with this exception.
String	getMessage()
String	getPartitionKeyRangeId()
Map<String,String>	getRequestHeaders()
com.microsoft.azure.cosmosdb.internal.directconnectivity.Uri	getRequestUri()
Map<String,String>	getResponseHeaders() Gets the response headers as key-value pairs
long	getRetryAfterInMilliseconds() Gets the recommended time interval after which the client can retry failed requests
int	getStatusCode() Gets the http status code.
int	getSubStatusCode() Gets the sub status code.
void	setClientSideRequestStatistics(ClientSideRequestStatistics clientSideRequestStatistics) Sets the Client side request statistics associated with this exception.
void	setRequestUri(com.microsoft.azure.cosmosdb.internal.directconnectivity.Uri requestUri)
String	toString()

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

DocumentClientException

public DocumentClientException(int statusCode)

Creates a new instance of the DocumentClientException class.

Parameters:

statusCode - the http status code of the response.

DocumentClientException

public DocumentClientException(int statusCode,
                               String errorMessage)

Creates a new instance of the DocumentClientException class.

Parameters:

statusCode - the http status code of the response.

errorMessage - the error message.

DocumentClientException

public DocumentClientException(int statusCode,
                               Exception innerException)

Creates a new instance of the DocumentClientException class.

Parameters:

statusCode - the http status code of the response.

innerException - the original exception.

DocumentClientException

public DocumentClientException(int statusCode,
                               Error errorResource,
                               Map<String,String> responseHeaders)

Creates a new instance of the DocumentClientException class.

Parameters:

statusCode - the http status code of the response.

errorResource - the error resource object.

responseHeaders - the response headers.

DocumentClientException

public DocumentClientException(String resourceAddress,
                               int statusCode,
                               Error errorResource,
                               Map<String,String> responseHeaders)

Creates a new instance of the DocumentClientException class.

Parameters:

resourceAddress - the address of the resource the request is associated with.

statusCode - the http status code of the response.

errorResource - the error resource object.

responseHeaders - the response headers.

DocumentClientException

public DocumentClientException(String message,
                               Exception exception,
                               Map<String,String> responseHeaders,
                               int statusCode,
                               String resourceAddress)

Creates a new instance of the DocumentClientException class.

Parameters:

message - the string message.

statusCode - the http status code of the response.

exception - the exception object.

responseHeaders - the response headers.

resourceAddress - the address of the resource the request is associated with.

Method Detail

getActivityId

public String getActivityId()

Gets the activity ID associated with the request.

Returns:

the activity ID.

getClientSideRequestStatistics

public ClientSideRequestStatistics getClientSideRequestStatistics()

Gets the Client side request statistics associated with this exception.

Returns:

Client side request statistics associated with this exception.

setClientSideRequestStatistics

public void setClientSideRequestStatistics(ClientSideRequestStatistics clientSideRequestStatistics)

Sets the Client side request statistics associated with this exception.

getError

public Error getError()

Gets the error code associated with the exception.

Returns:

the error.

getLsn

public long getLsn()

Gets the LSN associated with this exception.

Returns:

the LSN associated with this exception.

getMessage

public String getMessage()

Overrides:

getMessage in class Throwable

getPartitionKeyRangeId

public String getPartitionKeyRangeId()

getRequestHeaders

public Map<String,String> getRequestHeaders()

getRequestUri

public com.microsoft.azure.cosmosdb.internal.directconnectivity.Uri getRequestUri()

setRequestUri

public void setRequestUri(com.microsoft.azure.cosmosdb.internal.directconnectivity.Uri requestUri)

getResponseHeaders

public Map<String,String> getResponseHeaders()

Gets the response headers as key-value pairs

Returns:

the response headers

getRetryAfterInMilliseconds

public long getRetryAfterInMilliseconds()

Gets the recommended time interval after which the client can retry failed requests

Returns:

the recommended time interval after which the client can retry failed requests.

getStatusCode

public int getStatusCode()

Gets the http status code.

Returns:

the status code.

getSubStatusCode

public int getSubStatusCode()

Gets the sub status code.

Returns:

the status code.

toString

public String toString()

Overrides:

toString in class Throwable