org.odpi.openmetadata.adapters.connectors.database.ffdc

Enum OCFDatabaseConnectorErrorCode

java.lang.Object

java.lang.Enum<OCFDatabaseConnectorErrorCode>

org.odpi.openmetadata.adapters.connectors.database.ffdc.OCFDatabaseConnectorErrorCode

All Implemented Interfaces:

Serializable, Comparable<OCFDatabaseConnectorErrorCode>

public enum OCFDatabaseConnectorErrorCode
extends Enum<OCFDatabaseConnectorErrorCode>

The OCFDatabaseConnectorErrorCode is used to define first failure data capture (FFDC) for errors that occur within the JDBC Connector It is used in conjunction with all OCF Database Connector Exceptions, both Checked and Runtime (unchecked). The 3 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
  • 401 - unauthorized or unauthenticated
• 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 user should correct the error

Enum Constant Summary

Enum Constants

Enum Constant and Description
CONNECT_FAIL
DISCONNECT_FAIL
ILLEGAL_ACCESS
ILLEGAL_INSTANCE_CREATION
NOT_VALID_QUERY
QUERY_EXECUTION_FAIL
UNKNOWN_JDBC_DRIVER

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 OCFDatabaseConnectorErrorCode	valueOf(String name) Returns the enum constant of this type with the specified name.
static OCFDatabaseConnectorErrorCode[]	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

NOT_VALID_QUERY

public static final OCFDatabaseConnectorErrorCode NOT_VALID_QUERY

ILLEGAL_ACCESS

public static final OCFDatabaseConnectorErrorCode ILLEGAL_ACCESS

ILLEGAL_INSTANCE_CREATION

public static final OCFDatabaseConnectorErrorCode ILLEGAL_INSTANCE_CREATION

CONNECT_FAIL

public static final OCFDatabaseConnectorErrorCode CONNECT_FAIL

QUERY_EXECUTION_FAIL

public static final OCFDatabaseConnectorErrorCode QUERY_EXECUTION_FAIL

DISCONNECT_FAIL

public static final OCFDatabaseConnectorErrorCode DISCONNECT_FAIL

UNKNOWN_JDBC_DRIVER

public static final OCFDatabaseConnectorErrorCode UNKNOWN_JDBC_DRIVER

Method Detail

values

public static OCFDatabaseConnectorErrorCode[] 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 (OCFDatabaseConnectorErrorCode c : OCFDatabaseConnectorErrorCode.values())
    System.out.println(c);

Returns:

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

valueOf

public static OCFDatabaseConnectorErrorCode 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<OCFDatabaseConnectorErrorCode>

Returns:

string of property names and values for this enum