com.qcloud.cos.exception

类 CosServiceException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.qcloud.cos.exception.CosClientException

com.qcloud.cos.exception.CosServiceException

所有已实现的接口:

Serializable

直接已知子类:

MultiObjectDeleteException

public class CosServiceException
extends CosClientException

Extension of CosClientException that represents an error response returned by an Tencent Qcloud Cos. Receiving an exception of this type indicates that the caller's request was correctly transmitted to the service, but for some reason, the service was not able to process it, and returned an error response instead.

CosServiceException provides callers several pieces of information that can be used to obtain more information about the error and why it occurred. In particular, the errorType field can be used to determine if the caller's request was invalid, or the service encountered an error on the server side while processing it.

另请参阅:

序列化表格

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	CosServiceException.ErrorType Indicates who is responsible (if known) for a failed request.

构造器概要

构造器

构造器和说明
CosServiceException(String errorMessage) Constructs a new CosServiceException with the specified message.
CosServiceException(String errorMessage, Exception cause) Constructs a new CosServiceException with the specified message and exception indicating the root cause.
CosServiceException(String message, String errorResponseXml) Constructs a new CosServiceException with the specified message and error response xml from Qcloud COS.

方法概要

方法

限定符和类型	方法和说明
Map<String,String>	getAdditionalDetails()
String	getErrorCode() Returns the COS error code represented by this exception.
String	getErrorMessage()
String	getErrorResponseXml()
CosServiceException.ErrorType	getErrorType() Indicates who is responsible for this exception (caller, service, or unknown).
String	getMessage()
String	getRawResponseContent() Typically only useful for debugging purpose if for some reason the SDK cannot parse the HTTP response from a service
String	getRequestId() Returns the COS request ID that uniquely identifies the service request the caller made.
int	getStatusCode() Returns the HTTP status code that was returned with this service exception.
String	getTraceId()
void	setAdditionalDetails(Map<String,String> additionalDetails)
void	setErrorCode(String errorCode) Sets the COS error code represented by this exception.
void	setErrorMessage(String value) Sets the human-readable error message provided by the service.
void	setErrorType(CosServiceException.ErrorType errorType) Sets the type of error represented by this exception (sender, receiver, or unknown), indicating if this exception was the caller's fault, or the service's fault.
void	setRawResponseContent(String rawResponseContent)
void	setRequestId(String requestId) Sets the COS requestId for this exception.
void	setStatusCode(int statusCode) Sets the HTTP status code that was returned with this service exception.
void	setTraceId(String tranceId)

从类继承的方法 com.qcloud.cos.exception.CosClientException

isRetryable

从类继承的方法 java.lang.Throwable

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

从类继承的方法 java.lang.Object

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

构造器详细资料

CosServiceException

public CosServiceException(String errorMessage)

Constructs a new CosServiceException with the specified message.

参数:

errorMessage - An error message describing what went wrong.

CosServiceException

public CosServiceException(String errorMessage,
                   Exception cause)

Constructs a new CosServiceException with the specified message and exception indicating the root cause.

参数:

errorMessage - An error message describing what went wrong.

cause - The root exception that caused this exception to be thrown.

CosServiceException

public CosServiceException(String message,
                   String errorResponseXml)

Constructs a new CosServiceException with the specified message and error response xml from Qcloud COS.

参数:

message - The error message describing why this exception was thrown.

errorResponseXml - The original error response XML received from Qcloud COS

另请参阅:

CosServiceException(String)

方法详细资料

setRequestId

public void setRequestId(String requestId)

Sets the COS requestId for this exception.

参数:

requestId - The unique identifier for the service request the caller made.

getRequestId

public String getRequestId()

Returns the COS request ID that uniquely identifies the service request the caller made.

返回:

The COS request ID that uniquely identifies the service request the caller made.

setErrorCode

public void setErrorCode(String errorCode)

Sets the COS error code represented by this exception.

参数:

errorCode - The COS error code represented by this exception.

getErrorCode

public String getErrorCode()

Returns the COS error code represented by this exception.

返回:

The COS error code represented by this exception.

setErrorType

public void setErrorType(CosServiceException.ErrorType errorType)

Sets the type of error represented by this exception (sender, receiver, or unknown), indicating if this exception was the caller's fault, or the service's fault.

参数:

errorType - The type of error represented by this exception (sender or receiver), indicating if this exception was the caller's fault or the service's fault.

getErrorType

public CosServiceException.ErrorType getErrorType()

Indicates who is responsible for this exception (caller, service, or unknown).

返回:

A value indicating who is responsible for this exception (caller, service, or unknown).

getErrorMessage

public String getErrorMessage()

返回:

the human-readable error message provided by the service

setErrorMessage

public void setErrorMessage(String value)

Sets the human-readable error message provided by the service. NOTE: errorMessage by default is set to the same as the message value passed to the constructor of CosServiceException.

另请参阅:

CosServiceException(String), CosServiceException#CosServiceException(String, Exception))

setStatusCode

public void setStatusCode(int statusCode)

Sets the HTTP status code that was returned with this service exception.

参数:

statusCode - The HTTP status code that was returned with this service exception.

getStatusCode

public int getStatusCode()

Returns the HTTP status code that was returned with this service exception.

返回:

The HTTP status code that was returned with this service exception.

getTraceId

public String getTraceId()

setTraceId

public void setTraceId(String tranceId)

getAdditionalDetails

public Map<String,String> getAdditionalDetails()

setAdditionalDetails

public void setAdditionalDetails(Map<String,String> additionalDetails)

getErrorResponseXml

public String getErrorResponseXml()

getMessage

public String getMessage()

覆盖:

getMessage 在类中 Throwable

getRawResponseContent

public String getRawResponseContent()

Typically only useful for debugging purpose if for some reason the SDK cannot parse the HTTP response from a service

返回:

The raw content of the HTTP response

setRawResponseContent

public void setRawResponseContent(String rawResponseContent)

参数:

rawResponseContent - The raw content of the HTTP response