org.systinet.uddi.client
Class UDDIErrorCodes

java.lang.Object
  extended byorg.systinet.uddi.client.UDDIErrorCodes

public class UDDIErrorCodes
extends java.lang.Object

UDDI Error Codes
"The following list of error codes can be returned in the errno values within a dispositionReport response to the API calls defined in this programmer's reference. The descriptions in this section are general and when used with the specific return information defined in the individual API call descriptions are useful for determining the reason for failures."

Since:
3.0

Field Summary
static int E_ACCOUNT_LIMIT_EXCEEDED
          Signifies that a save request exceeded the quantity limits for a given structure type.
static int E_ASSERTION_NOT_FOUND
          Signifies that a particular publisher assertion (consisting of two businessKey values, and a keyed reference with three components) cannot be identified in a save or delete operation
static int E_AUTH_TOKEN_EXPIRED
          Signifies that the authentication token information has timed out.
static int E_AUTH_TOKEN_REQUIRED
          Signifies that an invalid authentication token was passed to an API call that requires authentication.
static int E_BUSY
          Signifies that the request cannot be processed at the current time.
static int E_CATEGORIZATION_NOT_ALLOWED
          Restrictions have been placed by the on the types of information that can be categorized within a specific taxonomy.
static int E_FATAL_ERROR
          Signifies that a serious technical error has occurred while processing the request.
static int E_HISTORY_DATA_NOT_AVAILABLE
          Signifies that the requested history data is not available for the time period requested.
static int E_INTERCEPTOR_ERROR
          Indicates that the error occurs during processing of interceptors.
static int E_INVALID_CATEGORY
          Signifies that the given keyValue did not correspond to a category within the taxonomy identified by the tModelKey.
static int E_INVALID_COMBINATION
          Signifies conflicting findQualifiers have been specified.
static int E_INVALID_COMPLETION_STATUS
          Signifies that one of the assertion status values passed is unrecognized.
static int E_INVALID_KEY_PASSED
          Signifies that the uuid_key value passed did not match any known key values.
static int E_INVALID_PARAMETER
          Signifies that the input parameter is invalid.
static int E_INVALID_PROJECTION
          Signifies that an attempt was made to save a businessEntity containing a service projection that does not match the businessService being projected.
static int E_INVALID_URL_PASSED
          Signifies that an error occurred during processing of a save function involving accessing data from a remote URL.
static int E_INVALID_VALUE
          A value that was passed in a keyValue attribute did not pass validation.
static int E_KEY_RETIRED
          Signifies that a uuid_key value passed has been removed from the registry.
static int E_KEY_UNAVAILABLE
          Signifies that the proposed key is in a partition that has already been assigned to some other publisher.
static int E_LANGUAGE_ERROR
          Signifies that an error was detected while processing elements that were annotated with xml:lang qualifiers.
static int E_MESSAGE_TOO_LARGE
          Signifies that the message is too large.
static int E_NAME_TOO_LONG
          Signifies that the partial name value passed exceeds the maximum name length designated by the policy of an implementation or Operator Site.
static int E_NO_VALUES_AVAILABLE
          Signifies that an attempt to retrieve valid values yielded no (additional) values.
static int E_OPERATOR_MISMATCH
          Signifies that an attempt was made to use the publishing API to change data that is mastered at another Operator Site.
static int E_PUBLISHER_CANCELLED
          The target publisher cancelled the custody transfer operation.
static int E_REQUEST_DENIED
          A custody transfer request has been refused.
static int E_REQUEST_TIMEOUT
          Signifies that the request could not be carried out because a needed web service, such as validate_values, did not respond in a reasonable amount of time.
static int E_RESULT_SET_TOO_LARGE
          Signifies that the UDDI node deems that a result set from an inquiry is too large, and requests to obtain the results are not honored, even using subsets.
static int E_SECRET_UNKNOWN
          The target publisher was unable to match the shared secret and the five (5) attempt limit was exhausted.
static int E_SUCCESS
          Signifies no failure occurred.
static int E_TOKEN_ALREADY_EXISTS
          Signifies that one or more of the uddiKey elements that identify entities to be transferred are associated with a transferToken that is still valid and has not been discarded, used or expired.
static int E_TOO_MANY_OPTIONS
          Signifies that incompatible arguments were passed.
static int E_TRANSFER_ABORTED
          Signifies that a custody transfer request will not succeed.
static int E_TRANSFER_NOT_ALLOWED
          Signifies that the transfer of one or more entities has been by either the custodial node or the target node because the transfer token has expired or an attempt was made to transfer an unauthorized entity.
static int E_UNACCEPTABLE_SIGNATURE
          Indicates that the digital signature in the entity is missing or does not meet the requirements of the registry.
static int E_UNKNOWN_USER
          Signifies that the user ID and password pair passed in a get_authToken message is not known to the Operator Site or is not valid.
static int E_UNRECOGNIZED_VERSION
          Signifies that the value of the generic attribute passed is unsupported by the Operator Instance being queried.
static int E_UNSUPPORTED
          Signifies that the implementor does not support a feature or API.
static int E_UNVALIDATABLE
          Signifies that an attempt was made to reference a taxonomy or identifier system in a keyedReference whose tModel is categorized with the unvalidatable categorization.
static int E_USER_MISMATCH
          Signifies that an attempt was made to use the publishing API to change data that is controlled by another party.
static int E_VALUE_NOT_ALLOWED
          Signifies that a value did not pass validation because of contextual issues.
 
Constructor Summary
UDDIErrorCodes()
           
 
Method Summary
static java.lang.String getCode(int errno)
          Returns a text message code for the error number passed in.
static java.lang.String getMessage(int errorCode)
          Returns a text message describing the error code passed in.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

E_ASSERTION_NOT_FOUND

public static final int E_ASSERTION_NOT_FOUND
Signifies that a particular publisher assertion (consisting of two businessKey values, and a keyed reference with three components) cannot be identified in a save or delete operation

See Also:
Constant Field Values

E_AUTH_TOKEN_EXPIRED

public static final int E_AUTH_TOKEN_EXPIRED
Signifies that the authentication token information has timed out.

See Also:
Constant Field Values

E_AUTH_TOKEN_REQUIRED

public static final int E_AUTH_TOKEN_REQUIRED
Signifies that an invalid authentication token was passed to an API call that requires authentication.

See Also:
Constant Field Values

E_ACCOUNT_LIMIT_EXCEEDED

public static final int E_ACCOUNT_LIMIT_EXCEEDED
Signifies that a save request exceeded the quantity limits for a given structure type. See "Structure Limits" in Appendix D for details.

See Also:
Constant Field Values

E_BUSY

public static final int E_BUSY
Signifies that the request cannot be processed at the current time.

See Also:
Constant Field Values

E_CATEGORIZATION_NOT_ALLOWED

public static final int E_CATEGORIZATION_NOT_ALLOWED
Restrictions have been placed by the on the types of information that can be categorized within a specific taxonomy. The data provided does not conform to the restrictions placed on the category used. Used with categorization only.

See Also:
Constant Field Values

E_FATAL_ERROR

public static final int E_FATAL_ERROR
Signifies that a serious technical error has occurred while processing the request.

See Also:
Constant Field Values

E_INVALID_KEY_PASSED

public static final int E_INVALID_KEY_PASSED
Signifies that the uuid_key value passed did not match any known key values. The details on the invalid key will be included in the dispositionReport structure.

See Also:
Constant Field Values

E_INVALID_PROJECTION

public static final int E_INVALID_PROJECTION
Signifies that an attempt was made to save a businessEntity containing a service projection that does not match the businessService being projected. The serviceKey of at least one such businessService will be included in the dispositionReport.

See Also:
Constant Field Values

E_INVALID_CATEGORY

public static final int E_INVALID_CATEGORY
Signifies that the given keyValue did not correspond to a category within the taxonomy identified by the tModelKey. Used with categorization only.

See Also:
Constant Field Values

E_INVALID_COMPLETION_STATUS

public static final int E_INVALID_COMPLETION_STATUS
Signifies that one of the assertion status values passed is unrecognized. The completion status that caused the problem will be clearly indicated in the error text.

See Also:
Constant Field Values

E_INVALID_URL_PASSED

public static final int E_INVALID_URL_PASSED
Signifies that an error occurred during processing of a save function involving accessing data from a remote URL. The details of the HTTP Get report will be included in the dispositionReport structure.

See Also:
Constant Field Values

E_INVALID_VALUE

public static final int E_INVALID_VALUE
A value that was passed in a keyValue attribute did not pass validation. This applies to checked categorizations, identifiers and other validated code lists. The error text will clearly indicate the key and value combination that failed validation.

See Also:
Constant Field Values

E_KEY_RETIRED

public static final int E_KEY_RETIRED
Signifies that a uuid_key value passed has been removed from the registry. While the key was once valid as an accessor, and is still possibly valid, the publisher has removed the information referenced by the passed uuid_key.

See Also:
Constant Field Values

E_LANGUAGE_ERROR

public static final int E_LANGUAGE_ERROR
Signifies that an error was detected while processing elements that were annotated with xml:lang qualifiers. Presently, only the description element supports xml:lang qualifications.

See Also:
Constant Field Values

E_MESSAGE_TOO_LARGE

public static final int E_MESSAGE_TOO_LARGE
Signifies that the message is too large. The upper limit will be clearly indicated in the error text.

See Also:
Constant Field Values

E_NAME_TOO_LONG

public static final int E_NAME_TOO_LONG
Signifies that the partial name value passed exceeds the maximum name length designated by the policy of an implementation or Operator Site.

See Also:
Constant Field Values

E_OPERATOR_MISMATCH

public static final int E_OPERATOR_MISMATCH
Signifies that an attempt was made to use the publishing API to change data that is mastered at another Operator Site. This error is only relevant to the public Operator Sites and does not apply to other UDDI compatible registries.

See Also:
Constant Field Values

E_PUBLISHER_CANCELLED

public static final int E_PUBLISHER_CANCELLED
The target publisher cancelled the custody transfer operation.

See Also:
Constant Field Values

E_REQUEST_DENIED

public static final int E_REQUEST_DENIED
A custody transfer request has been refused.

See Also:
Constant Field Values

E_REQUEST_TIMEOUT

public static final int E_REQUEST_TIMEOUT
Signifies that the request could not be carried out because a needed web service, such as validate_values, did not respond in a reasonable amount of time. Details identifying the failing service will be included in the dispositionReport element.

See Also:
Constant Field Values

E_SECRET_UNKNOWN

public static final int E_SECRET_UNKNOWN
The target publisher was unable to match the shared secret and the five (5) attempt limit was exhausted. The target operator automatically cancelled the transfer operation.

See Also:
Constant Field Values

E_SUCCESS

public static final int E_SUCCESS
Signifies no failure occurred. This return code is used with the dispositionReport for reporting results from requests with no natural response document.

See Also:
Constant Field Values

E_TOKEN_ALREADY_EXISTS

public static final int E_TOKEN_ALREADY_EXISTS
Signifies that one or more of the uddiKey elements that identify entities to be transferred are associated with a transferToken that is still valid and has not been discarded, used or expired. The error text SHOULD clearly indicate which entity keys caused the error.

See Also:
Constant Field Values

E_TOO_MANY_OPTIONS

public static final int E_TOO_MANY_OPTIONS
Signifies that incompatible arguments were passed.

See Also:
Constant Field Values

E_TRANSFER_ABORTED

public static final int E_TRANSFER_ABORTED
Signifies that a custody transfer request will not succeed.

See Also:
Constant Field Values

E_UNRECOGNIZED_VERSION

public static final int E_UNRECOGNIZED_VERSION
Signifies that the value of the generic attribute passed is unsupported by the Operator Instance being queried.

See Also:
Constant Field Values

E_UNKNOWN_USER

public static final int E_UNKNOWN_USER
Signifies that the user ID and password pair passed in a get_authToken message is not known to the Operator Site or is not valid.

See Also:
Constant Field Values

E_UNSUPPORTED

public static final int E_UNSUPPORTED
Signifies that the implementor does not support a feature or API.

See Also:
Constant Field Values

E_UNVALIDATABLE

public static final int E_UNVALIDATABLE
Signifies that an attempt was made to reference a taxonomy or identifier system in a keyedReference whose tModel is categorized with the unvalidatable categorization.

See Also:
Constant Field Values

E_USER_MISMATCH

public static final int E_USER_MISMATCH
Signifies that an attempt was made to use the publishing API to change data that is controlled by another party. In certain cases, E_operatorMismatch takes precedence in reporting an error.

See Also:
Constant Field Values

E_VALUE_NOT_ALLOWED

public static final int E_VALUE_NOT_ALLOWED
Signifies that a value did not pass validation because of contextual issues. The value may be valid in some contexts, but not in the context used. The error text may contain information about the contextual problem.

See Also:
Constant Field Values

E_INVALID_PARAMETER

public static final int E_INVALID_PARAMETER
Signifies that the input parameter is invalid. The required field is empty.

See Also:
Constant Field Values

E_HISTORY_DATA_NOT_AVAILABLE

public static final int E_HISTORY_DATA_NOT_AVAILABLE
Signifies that the requested history data is not available for the time period requested.

See Also:
Constant Field Values

E_INVALID_COMBINATION

public static final int E_INVALID_COMBINATION
Signifies conflicting findQualifiers have been specified. The findQualifiers that caused the problem SHOULD be clearly indicated in the error text.

See Also:
Constant Field Values

E_KEY_UNAVAILABLE

public static final int E_KEY_UNAVAILABLE
Signifies that the proposed key is in a partition that has already been assigned to some other publisher.

See Also:
Constant Field Values

E_NO_VALUES_AVAILABLE

public static final int E_NO_VALUES_AVAILABLE
Signifies that an attempt to retrieve valid values yielded no (additional) values.

See Also:
Constant Field Values

E_RESULT_SET_TOO_LARGE

public static final int E_RESULT_SET_TOO_LARGE
Signifies that the UDDI node deems that a result set from an inquiry is too large, and requests to obtain the results are not honored, even using subsets. The inquiry that triggered this error should be refined and re-issued.

See Also:
Constant Field Values

E_TRANSFER_NOT_ALLOWED

public static final int E_TRANSFER_NOT_ALLOWED
Signifies that the transfer of one or more entities has been by either the custodial node or the target node because the transfer token has expired or an attempt was made to transfer an unauthorized entity.

See Also:
Constant Field Values

E_UNACCEPTABLE_SIGNATURE

public static final int E_UNACCEPTABLE_SIGNATURE
Indicates that the digital signature in the entity is missing or does not meet the requirements of the registry. The errInfo element provides additional details.

See Also:
Constant Field Values

E_INTERCEPTOR_ERROR

public static final int E_INTERCEPTOR_ERROR
Indicates that the error occurs during processing of interceptors.

See Also:
Constant Field Values
Constructor Detail

UDDIErrorCodes

public UDDIErrorCodes()
Method Detail

getCode

public static java.lang.String getCode(int errno)
Returns a text message code for the error number passed in.


getMessage

public static java.lang.String getMessage(int errorCode)
Returns a text message describing the error code passed in.