org.odpi.openmetadata.adapters.connectors.restclients.ffdc

Enum RESTClientConnectorErrorCode

java.lang.Object

java.lang.Enum<RESTClientConnectorErrorCode>

org.odpi.openmetadata.adapters.connectors.restclients.ffdc.RESTClientConnectorErrorCode

All Implemented Interfaces:

Serializable, Comparable<RESTClientConnectorErrorCode>

public enum RESTClientConnectorErrorCode
extends Enum<RESTClientConnectorErrorCode>

The RESTClientConnectorErrorCode is used to define first failure data capture (FFDC) for errors that occur when working with the REST Client. It is used in conjunction with both Checked and Runtime (unchecked) exceptions. The 5 fields in the enum are:

• HTTP Error Code - for translating between REST and JAVA - Typically the numbers used are:
• • 500 - internal error
  • 400 - invalid parameters
  • 404 - not found
  • 409 - data conflict errors - eg item already defined
• Error Message Id - to uniquely identify the message
• Error Message Text - includes placeholder to allow additional values to be captured
• SystemAction - describes the result of the error
• UserAction - describes how a consumer should correct the error

Enum Constant Summary

Enum Constants

Enum Constant and Description
CLIENT_SIDE_REST_API_ERROR
EXCEPTION_RESPONSE_FROM_API
NULL_RESPONSE_FROM_API

Method Summary

Modifier and Type	Method and Description
String	getErrorMessageId() Returns the unique identifier for the error message.
String	getFormattedErrorMessage(String... params) Returns the error message with the placeholders filled out with the supplied parameters.
int	getHTTPErrorCode()
String	getSystemAction() Returns a description of the action taken by the system when the condition that caused this exception was detected.
String	getUnformattedErrorMessage() Returns the error message with placeholders for specific details.
String	getUserAction() Returns instructions of how to resolve the issue reported in this exception.
String	toString() JSON-style toString
static RESTClientConnectorErrorCode	valueOf(String name) Returns the enum constant of this type with the specified name.
static RESTClientConnectorErrorCode[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

NULL_RESPONSE_FROM_API

public static final RESTClientConnectorErrorCode NULL_RESPONSE_FROM_API

CLIENT_SIDE_REST_API_ERROR

public static final RESTClientConnectorErrorCode CLIENT_SIDE_REST_API_ERROR

EXCEPTION_RESPONSE_FROM_API

public static final RESTClientConnectorErrorCode EXCEPTION_RESPONSE_FROM_API

Method Detail

values

public static RESTClientConnectorErrorCode[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (RESTClientConnectorErrorCode c : RESTClientConnectorErrorCode.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static RESTClientConnectorErrorCode valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

getHTTPErrorCode

public int getHTTPErrorCode()

getErrorMessageId

public String getErrorMessageId()

Returns the unique identifier for the error message.

Returns:

errorMessageId

getUnformattedErrorMessage

public String getUnformattedErrorMessage()

Returns the error message with placeholders for specific details.

Returns:

errorMessage (unformatted)

getFormattedErrorMessage

public String getFormattedErrorMessage(String... params)

Returns the error message with the placeholders filled out with the supplied parameters.

Parameters:

params - - strings that plug into the placeholders in the errorMessage

Returns:

errorMessage (formatted with supplied parameters)

getSystemAction

public String getSystemAction()

Returns a description of the action taken by the system when the condition that caused this exception was detected.

Returns:

systemAction

getUserAction

public String getUserAction()

Returns instructions of how to resolve the issue reported in this exception.

Returns:

userAction

toString

public String toString()

JSON-style toString

Overrides:

toString in class Enum<RESTClientConnectorErrorCode>

Returns:

string of property names and values for this enum