org.odpi.openmetadata.adapters.connectors.structuredfile.ffdc

Enum StructuredFileConnectorErrorCode

java.lang.Object

java.lang.Enum<StructuredFileConnectorErrorCode>

org.odpi.openmetadata.adapters.connectors.structuredfile.ffdc.StructuredFileConnectorErrorCode

All Implemented Interfaces:

Serializable, Comparable<StructuredFileConnectorErrorCode>

public enum StructuredFileConnectorErrorCode
extends Enum<StructuredFileConnectorErrorCode>

The StructuredFileConnectorErrorCode is used to define first failure data capture (FFDC) for errors that occur when working with the Structured File Connector. 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
DIRECTORY_SPECIFIED
FILE_NOT_FOUND
FILE_NOT_READABLE
FILE_NOT_SPECIFIED
FILE_TOO_SHORT
UNEXPECTED_IO_EXCEPTION

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

FILE_NOT_SPECIFIED

public static final StructuredFileConnectorErrorCode FILE_NOT_SPECIFIED

DIRECTORY_SPECIFIED

public static final StructuredFileConnectorErrorCode DIRECTORY_SPECIFIED

FILE_NOT_READABLE

public static final StructuredFileConnectorErrorCode FILE_NOT_READABLE

FILE_TOO_SHORT

public static final StructuredFileConnectorErrorCode FILE_TOO_SHORT

FILE_NOT_FOUND

public static final StructuredFileConnectorErrorCode FILE_NOT_FOUND

UNEXPECTED_IO_EXCEPTION

public static final StructuredFileConnectorErrorCode UNEXPECTED_IO_EXCEPTION

Method Detail

values

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

Returns:

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

valueOf

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

Returns:

string of property names and values for this enum