com.sap.client.odata.v4

Class DataServiceException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.sap.client.odata.v4.core.ExceptionBase

com.sap.client.odata.v4.DataException

com.sap.client.odata.v4.DataServiceException

All Implemented Interfaces:

java.io.Serializable

public class DataServiceException
extends DataException

Exception thrown when a DataService request fails due to a data service issue.

See Also:

Serialized Form

Constructor Summary

Constructors

Modifier	Constructor and Description
	DataServiceException() Default constructor.
protected	DataServiceException(java.lang.String message, java.lang.Throwable cause)

Method Summary

Modifier and Type	Method and Description
ErrorResponse	getResponse() (nullable) If the data service request returned on OData error response, then this holds the parsed error response.
int	getStatus() If the data service request failed with an HTTP error code, then status holds the error code.
java.lang.String	getStatusText() Text describing status code.
void	setResponse(ErrorResponse value) If the data service request returned on OData error response, then this holds the parsed error response.
void	setStatus(int value) If the data service request failed with an HTTP error code, then status holds the error code.
static DataServiceException	withCause(java.lang.RuntimeException cause) Return a new exception with the specified root cause.
static DataServiceException	withCauseAndMessage(java.lang.RuntimeException cause, java.lang.String message) Return a new exception with the specified root cause and message text.
static DataServiceException	withMessage(java.lang.String message) Return a new exception with the specified message text.
static DataServiceException	withResponse(int status, java.lang.String message, ErrorResponse response) Return a new exception with the specified error code, message text and error response.
static DataServiceException	withStatus(int status) See withStatus(int, String).
static DataServiceException	withStatus(int status, java.lang.String message) Return a new exception with the specified error code and message text.

Methods inherited from class com.sap.client.odata.v4.core.ExceptionBase

getCause, getMessage, setCause, setMessage, toString

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, 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

DataServiceException

protected DataServiceException(java.lang.String message,
                               java.lang.Throwable cause)

DataServiceException

public DataServiceException()

Default constructor.

Method Detail

getResponse

public ErrorResponse getResponse()

(nullable) If the data service request returned on OData error response, then this holds the parsed error response. Otherwise null.

getStatus

public int getStatus()

If the data service request failed with an HTTP error code, then status holds the error code. Otherwise zero.

getStatusText

public java.lang.String getStatusText()

Text describing status code.

See Also:

http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html.

setResponse

public void setResponse(ErrorResponse value)

If the data service request returned on OData error response, then this holds the parsed error response. Otherwise null.

setStatus

public void setStatus(int value)

If the data service request failed with an HTTP error code, then status holds the error code. Otherwise zero.

withCause

public static DataServiceException withCause(java.lang.RuntimeException cause)

Return a new exception with the specified root cause.

Parameters:

cause - (nullable) Root cause.

Returns:

A new exception with the specified root cause.

withCauseAndMessage

public static DataServiceException withCauseAndMessage(java.lang.RuntimeException cause,
                                                       java.lang.String message)

Return a new exception with the specified root cause and message text.

Parameters:

cause - (nullable) Root cause.

message - (nullable) Message text.

Returns:

A new exception with the specified root cause and message text.

withMessage

public static DataServiceException withMessage(java.lang.String message)

Return a new exception with the specified message text.

Parameters:

message - (nullable) Message text.

Returns:

A new exception with the specified message text.

withResponse

public static DataServiceException withResponse(int status,
                                                java.lang.String message,
                                                ErrorResponse response)

Return a new exception with the specified error code, message text and error response.

Parameters:

status - Error code.

message - (nullable) Message text.

response - (nullable) Error response.

Returns:

A new exception with the specified error code, message text and error response.

withStatus

public static DataServiceException withStatus(int status)

See withStatus(int, String).

withStatus

public static DataServiceException withStatus(int status,
                                              java.lang.String message)

Return a new exception with the specified error code and message text.

Parameters:

status - Error code.

message - (nullable) Message text.

Returns:

A new exception with the specified error code and message text.