Package org.odpi.openmetadata.integrationservices.api.ffdc

Enum Class APIIntegratorErrorCode

java.lang.Object
java.lang.Enum<APIIntegratorErrorCode>
org.odpi.openmetadata.integrationservices.api.ffdc.APIIntegratorErrorCode
All Implemented Interfaces:
Serializable, Comparable<APIIntegratorErrorCode>, Constable, ExceptionMessageSet
public enum APIIntegratorErrorCode extends Enum<APIIntegratorErrorCode> implements ExceptionMessageSet
The APIIntegratorErrorCode error code is used to define first failure data capture (FFDC) for errors that occur when working with the Integration Services. It is used in conjunction with all exceptions, both Checked and Runtime (unchecked). 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 Identifier - 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 Details

    • INVALID_CONNECTOR

      public static final APIIntegratorErrorCode INVALID_CONNECTOR
      OMIS-API-INTEGRATOR-400-001 - Integration connector {0} is not of the correct type to run in the {1} integration service. It must inherit from {2}

    • NULL_CONTEXT

      public static final APIIntegratorErrorCode NULL_CONTEXT
      OMIS-API-INTEGRATOR-500-001 - Integration connector {0} has a null context

  • Method Details

    • values

      public static APIIntegratorErrorCode[] values()
      Returns an array containing the constants of this enum class, in the order they are declared.
      Returns:
      an array containing the constants of this enum class, in the order they are declared

    • valueOf

      public static APIIntegratorErrorCode valueOf(String name)
      Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (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 class has no constant with the specified name
      NullPointerException - if the argument is null

    • getMessageDefinition

      public ExceptionMessageDefinition getMessageDefinition()
      Retrieve a message definition object for an exception. This method is used when there are no message inserts.
      Specified by:
      getMessageDefinition in interface ExceptionMessageSet
      Returns:
      message definition object.

    • getMessageDefinition

      public ExceptionMessageDefinition getMessageDefinition(String... params)
      Retrieve a message definition object for an exception. This method is used when there are values to be inserted into the message.
      Specified by:
      getMessageDefinition in interface ExceptionMessageSet
      Parameters:
      params - array of parameters (all strings). They are inserted into the message according to the numbering in the message text.
      Returns:
      message definition object.

    • toString

      public String toString()
      JSON-style toString
      Overrides:
      toString in class Enum<APIIntegratorErrorCode>
      Returns:
      string of property names and values for this enum