|
Oracle Fusion Middleware Java API Reference for Oracle Service Bus 11g Release 1 (11.1.1.6.3) E15033-08 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object
java.lang.Throwable
java.lang.Exception
com.bea.wli.sb.transports.TransportException
public class TransportException
Represents an exception within the OSB Transport subsystem (either in a specific transport provider or in the transport framework itself). A transport exception can be optionally initialized with a combination of error message, code and cause.
If set, the error code is usually one of:
TransportManager.TRANSPORT_ERROR_GENERIC
TransportManager.TRANSPORT_ERROR_CONNECTION
TransportManager.TRANSPORT_ERROR_APPLICATION
errorPayload
is deprecated. In case of error in the outbound transport call, a transport provider may throw a TransportException and propagate the error back to the pipeline instead of scheduling the callback TransportSendListener.onError(OutboundTransportMessageContext, String, String)
If the inbound transport endpoint at the other end of the pipeline is soap service, and unless an error handler customizes the response, the error code and error message will appear in the soap faultSince 11.1.1.4, instances of this class can also specify additional metadata that can be interpreted by the pipeline and/or inbound transport. For more info, see setJavaFault(java.lang.Throwable)
and setOpaqueData(java.util.Map<java.lang.String, java.lang.Object>)
Constructor Summary | |
---|---|
TransportException() Constructs a TransportException. |
|
TransportException(weblogic.logging.Loggable loggable) |
|
TransportException(weblogic.logging.Loggable loggable, java.lang.Throwable cause) |
|
TransportException(java.lang.String msg) Constructs a TransportException with the specified message text. |
|
TransportException(java.lang.String message, Source errorPayload) Deprecated. |
|
TransportException(java.lang.String msg, java.lang.String errorCode) Constructs a TransportException with the specified message text and specified error code |
|
TransportException(java.lang.String message, java.lang.Throwable cause) Constructs a TransportException with the specified detail message and cause. |
|
TransportException(java.lang.String message, java.lang.Throwable cause, java.lang.String errorCode) Constructs a TransportException with the specified detail message and cause and error code. |
|
TransportException(java.lang.Throwable cause) Constructs a TransportException with the specified cause and a detail message of (cause==null ? null : cause.toString()) (which typically contains the class and detail message of cause). |
|
TransportException(java.lang.Throwable cause, java.lang.String errorCode) Constructs a TransportException with the specified cause and error code. |
Method Summary | |
---|---|
java.lang.String |
getErrorCode() |
Source |
getErrorPayload() Deprecated. |
java.lang.Throwable |
getJavaFault() Get the java fault metadata. |
java.util.Map<java.lang.String,java.lang.Object> |
getOpaqueData() Get the opaque data. |
static TransportException |
newInstance(java.lang.Throwable cause) Most transport SDK API signatures declare only TransportException to be thrown. |
TransportException |
setJavaFault(java.lang.Throwable fault) When throwing an exception on the request thread, instruct the pipeline to add a throwable to the $fault variable. |
TransportException |
setOpaqueData(java.util.Map<java.lang.String,java.lang.Object> data) Stores opaque (i.e. |
Methods inherited from class java.lang.Throwable |
---|
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public TransportException()
public TransportException(java.lang.String msg)
msg
- Message text.public TransportException(java.lang.String msg, java.lang.String errorCode)
msg
- Message text.errorCode
- error codepublic TransportException(java.lang.String message, java.lang.Throwable cause)
message
- the detail message (which is saved for later retrieval by the Throwable.getMessage()
method).cause
- the cause (which is saved for later retrieval by the Throwable.getCause()
method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)public TransportException(java.lang.String message, java.lang.Throwable cause, java.lang.String errorCode)
message
- the detail message (which is saved for later retrieval by the Throwable.getMessage()
method).cause
- the cause (which is saved for later retrieval by the Throwable.getCause()
method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)errorCode
- error codepublic TransportException(java.lang.Throwable cause)
PrivilegedActionException
).
cause
- the cause (which is saved for later retrieval by the Throwable.getCause()
method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)public TransportException(java.lang.Throwable cause, java.lang.String errorCode)
cause
- the cause (which is saved for later retrieval by the Throwable.getCause()
method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)errorCode
- error codepublic TransportException(java.lang.String message, Source errorPayload)
message
- error messageerrorPayload
- error payload sourcepublic TransportException(weblogic.logging.Loggable loggable)
public TransportException(weblogic.logging.Loggable loggable, java.lang.Throwable cause)
Method Detail |
---|
@Deprecated
public Source getErrorPayload()
public java.lang.String getErrorCode()
public static TransportException newInstance(java.lang.Throwable cause)
void someAPI() throws TransportException { try { .... } catch (Exception e) { throw TransportException.newInstance(e); } }
cause
- original cause of the exceptionpublic TransportException setJavaFault(java.lang.Throwable fault)
BindingTypeInfo.MessageTypeEnum.JAVA
. This method is not thread-safe.fault
- throwablepublic java.lang.Throwable getJavaFault()
setJavaFault(java.lang.Throwable)
This method is not thread safe.public TransportException setOpaqueData(java.util.Map<java.lang.String,java.lang.Object> data)
TransportOptions.THROW_ON_ERROR
data
- opaque data, a map of object keyed by string.public java.util.Map<java.lang.String,java.lang.Object> getOpaqueData()
setOpaqueData(java.util.Map<java.lang.String, java.lang.Object>)
. This method is not thread safe
|
Oracle Fusion Middleware Java API Reference for Oracle Service Bus 11g Release 1 (11.1.1.6.3) E15033-08 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |