oracle.uddi.client
Class UddiClientException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--oracle.uddi.UddiException
                    |
                    +--oracle.uddi.client.UddiClientException

All Implemented Interfaces:

java.io.Serializable, SOAPMessageConstants

public class UddiClientException

extends UddiException

implements SOAPMessageConstants

Superclass for all UDDI client-side exceptions, including exceptions returned by the UDDI registry via a SOAP Fault message.

The Disposition report has detailed information about the UDDI error as defined by the UDDI specification. If the response is a SOAP fault, but does not contain a disposition report, this exception may still be thrown.

The DispositionReport class contains constants for the various error values that can be returned.

See Also:

Serialized Form

Field Summary

Fields inherited from interface oracle.uddi.client.SOAPMessageConstants

ATTR_ARRAY_TYPE, ATTR_ENCODING_STYLE, ATTR_ID, ATTR_MUST_UNDERSTAND, ATTR_NULL, ATTR_REFERENCE, ATTR_TYPE, ELEM_BODY, ELEM_DETAIL, ELEM_ENVELOPE, ELEM_FAULT, ELEM_FAULT_ACTOR, ELEM_FAULT_CODE, ELEM_FAULT_STRING, ELEM_HEADER, FAULT_CODE_CLIENT, FAULT_CODE_MUST_UNDERSTAND, FAULT_CODE_SERVER, FAULT_CODE_VERSION_MISMATCH, NS_PRE_SOAP, NS_PRE_SOAP_ENC, NS_PRE_SOAP_ENV, NS_PRE_XMLNS, NS_URI_SOAP_ENC, NS_URI_SOAP_ENV, NS_URI_XMLNS

Constructor Summary

UddiClientException(org.w3c.dom.Element el, UddiElementFactory ueFactory)
Constructor that parses the XML dom tree of a SOAP Fault element representing UDDI Error (DispositionReport).

UddiClientException(java.lang.String errorCode)
Constructor for error code and non-parameterized message.

UddiClientException(java.lang.String errorCode, java.lang.Object parameter)
Constructor for error code and one-parameter message.

UddiClientException(java.lang.String errorCode, java.lang.Object[] parameterArray)
Constructor for error code and many-parameter message.

UddiClientException(java.lang.String errorCode, java.lang.Object[] parameterArray, java.lang.Throwable wrappedThrowable)
Constructor for error code and many-parameter message and wrapped throwable.

UddiClientException(java.lang.String errorCode, java.lang.Object parameter1, java.lang.Object parameter2)
Constructor for error code and two-parameter message.

UddiClientException(java.lang.String errorCode, java.lang.Object parameter1, java.lang.Object parameter2, java.lang.Object parameter3)
Constructor for error code and three-parameter message.

UddiClientException(java.lang.String errorCode, java.lang.Object parameter1, java.lang.Object parameter2, java.lang.Object parameter3, java.lang.Throwable wrappedThrowable)
Constructor for error code and three-parameter message and wrapped throwable.

UddiClientException(java.lang.String errorCode, java.lang.Object parameter1, java.lang.Object parameter2, java.lang.Throwable wrappedThrowable)
Constructor for error code and two-parameter message and wrapped throwable.

UddiClientException(java.lang.String errorCode, java.lang.Object parameter, java.lang.Throwable wrappedThrowable)
Constructor for error code and one-parameter message and wrapped throwable.

UddiClientException(java.lang.String errorCode, java.lang.Throwable wrappedThrowable)
Constructor for error code and non-parameterized message and wrapped throwable.

UddiClientException(UddiClientMessage localizableMessage)
Constructor with localizable message.

UddiClientException(UddiClientMessage localizableMessage, java.lang.Throwable wrappedThrowable)
Constructor with localizable message and wrapped throwable.

Method Summary

org.w3c.dom.Element	getDetail() Returns the DOM "detail" element which is embedded in the SOAP fault and contains the disposition report if a UDDI server-side error occurred.
DispositionReport	getDispositionReport() Gets the DispositionReport which describes UDDI-specific error information.
java.lang.String	getFaultActor() Returns the SOAP fault actor.
java.lang.String	getFaultCode() Returns the SOAP fault code.
java.lang.String	getFaultString() Returns the SOAP fault string.
java.lang.String	getLocalizedMessage() Gets the error message in the language of the appropriate Locale.
java.lang.String	getMessage() Gets the error message in the language of the Locale.US Locale.
static boolean	isSoapFault(org.w3c.dom.Element el) Tests the passed in element to determine if the element represents a SOAP Fault object.
boolean	isUddiFault() Returns true if the exception represents an error raised by the UDDI Registry via a SOAP Fault message.

Methods inherited from class oracle.uddi.UddiException

getErrorCode, getWrappedThrowable, printStackTrace, printStackTrace, printStackTrace

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getStackTrace, initCause, setStackTrace, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

UddiClientException

public UddiClientException(java.lang.String errorCode)

Constructor for error code and non-parameterized message. Note that the error code is not necessarily a UDDI-defined code.

UddiClientException

public UddiClientException(java.lang.String errorCode,
                           java.lang.Object parameter)

Constructor for error code and one-parameter message. Note that the error code is not necessarily a UDDI-defined code.

UddiClientException

public UddiClientException(java.lang.String errorCode,
                           java.lang.Object parameter1,
                           java.lang.Object parameter2)

Constructor for error code and two-parameter message. Note that the error code is not necessarily a UDDI-defined code.

UddiClientException

public UddiClientException(java.lang.String errorCode,
                           java.lang.Object parameter1,
                           java.lang.Object parameter2,
                           java.lang.Object parameter3)

Constructor for error code and three-parameter message. Note that the error code is not necessarily a UDDI-defined code.

UddiClientException

public UddiClientException(java.lang.String errorCode,
                           java.lang.Object[] parameterArray)

Constructor for error code and many-parameter message. Note that the error code is not necessarily a UDDI-defined code.

UddiClientException

public UddiClientException(java.lang.String errorCode,
                           java.lang.Throwable wrappedThrowable)

Constructor for error code and non-parameterized message and wrapped throwable. Note that the error code is not necessarily a UDDI-defined code.

UddiClientException

public UddiClientException(java.lang.String errorCode,
                           java.lang.Object parameter,
                           java.lang.Throwable wrappedThrowable)

Constructor for error code and one-parameter message and wrapped throwable. Note that the error code is not necessarily a UDDI-defined code.

UddiClientException

public UddiClientException(java.lang.String errorCode,
                           java.lang.Object parameter1,
                           java.lang.Object parameter2,
                           java.lang.Throwable wrappedThrowable)

Constructor for error code and two-parameter message and wrapped throwable. Note that the error code is not necessarily a UDDI-defined code.

UddiClientException

public UddiClientException(java.lang.String errorCode,
                           java.lang.Object parameter1,
                           java.lang.Object parameter2,
                           java.lang.Object parameter3,
                           java.lang.Throwable wrappedThrowable)

Constructor for error code and three-parameter message and wrapped throwable. Note that the error code is not necessarily a UDDI-defined code.

UddiClientException

public UddiClientException(java.lang.String errorCode,
                           java.lang.Object[] parameterArray,
                           java.lang.Throwable wrappedThrowable)

Constructor for error code and many-parameter message and wrapped throwable. Note that the error code is not necessarily a UDDI-defined code.

UddiClientException

public UddiClientException(UddiClientMessage localizableMessage)

Constructor with localizable message. Use of this constructor implies an exception originating from the client side which is not the result of a SOAP fault or UDDI Distribution Report.

UddiClientException

public UddiClientException(UddiClientMessage localizableMessage,
                           java.lang.Throwable wrappedThrowable)

Constructor with localizable message and wrapped throwable. Use of this constructor implies an exception originating from the client side which is not the result of a SOAP fault or UDDI Distribution Report.

UddiClientException

public UddiClientException(org.w3c.dom.Element el,
UddiElementFactory ueFactory)

Constructor that parses the XML dom tree of a SOAP Fault element representing UDDI Error (DispositionReport).

Parameters:

el - SOAP Fault element which may contain DispositionReport

Method Detail

getMessage

public java.lang.String getMessage()

Gets the error message in the language of the Locale.US Locale. For a server-side error message (DistributionReport), always returns a US-English error report.

Overrides:

getMessage in class UddiException

getLocalizedMessage

public java.lang.String getLocalizedMessage()

Gets the error message in the language of the appropriate Locale. For a server-side error message (DistributionReport), always returns a US-English error report.

Overrides:

getLocalizedMessage in class UddiException

getFaultCode

public java.lang.String getFaultCode()

Returns the SOAP fault code.

getFaultString

public java.lang.String getFaultString()

Returns the SOAP fault string.

getFaultActor

public java.lang.String getFaultActor()

Returns the SOAP fault actor.

getDetail

public org.w3c.dom.Element getDetail()

Returns the DOM "detail" element which is embedded in the SOAP fault and contains the disposition report if a UDDI server-side error occurred.

getDispositionReport

public DispositionReport getDispositionReport()

Gets the DispositionReport which describes UDDI-specific error information. Note that this may be null.

isUddiFault

public boolean isUddiFault()

Returns true if the exception represents an error raised by the UDDI Registry via a SOAP Fault message. Exceptions can also be raised locally in the client library, for example in the case of a message marshalling error.

isSoapFault

public static boolean isSoapFault(org.w3c.dom.Element el)

Tests the passed in element to determine if the element represents a SOAP Fault object.

Parameters:

el - root element for this object