Skip navigation links

Oracle BPEL Process Manager Client Java API Reference
10g Release 3 (10.1.3.1.0)

B28986-01


com.oracle.bpel.client
Class BPELFault

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by com.oracle.bpel.client.BPELFault

All Implemented Interfaces:
java.io.Serializable

public class BPELFault
extends java.lang.Exception

This class represents a standard fault that may be thrown by the server during run-time. A BPEL fault has defined, minimally, a QName that corresponds to the fault name (there are several standard faults that are supported, please refer to Appendix A - Standard Faults in the BPEL 1.1 specification for a complete list).

This class can only be used from within a bpelx:exec activity; the throw activity can be used from BPEL code.

Additional information (such as a fault variable) can be passed through as a part. Currently, internal system errors populate error codes and summary messages via parts.

See Also:
Serialized Form

Constructor Summary
BPELFault(javax.xml.namespace.QName faultName)
          Creates a new fault with a fault QName.
BPELFault(javax.xml.namespace.QName faultName, javax.xml.namespace.QName messageTypeQName)
          Creates a new fault with fault name and message type QName.
BPELFault(javax.xml.namespace.QName faultQName, java.lang.String summary)
          Creates a new fault with fault name and summary message.

 

Method Summary
 javax.xml.namespace.QName getFaultName()
          Returns the fault name.
 java.lang.String getMessage()
          Returns String with the fault name, message type QName and parts defined for this fault.
 javax.xml.namespace.QName getMessageType()
          Returns the message type QName.
 java.lang.Object getPart(java.lang.String name)
          Returns the part value with the specified name.
 java.util.Map getParts()
          Returns a map of parts.
 void setFaultName(javax.xml.namespace.QName faultName)
          Sets the fault name.
 void setMessageType(javax.xml.namespace.QName messageTypeQName)
          Sets the message type QName.
 void setPart(java.lang.String name, java.lang.Object value)
          Sets a part with the given name and value.

 

Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

 

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

 

Constructor Detail

BPELFault

public BPELFault(javax.xml.namespace.QName faultName)
Creates a new fault with a fault QName.

BPELFault

public BPELFault(javax.xml.namespace.QName faultName,
                 javax.xml.namespace.QName messageTypeQName)
Creates a new fault with fault name and message type QName.

BPELFault

public BPELFault(javax.xml.namespace.QName faultQName,
                 java.lang.String summary)
Creates a new fault with fault name and summary message. The message will be added as a part with name summary.

Method Detail

setFaultName

public void setFaultName(javax.xml.namespace.QName faultName)
Sets the fault name.

getFaultName

public javax.xml.namespace.QName getFaultName()
Returns the fault name.

setMessageType

public void setMessageType(javax.xml.namespace.QName messageTypeQName)
Sets the message type QName.

getMessageType

public javax.xml.namespace.QName getMessageType()
Returns the message type QName.

setPart

public void setPart(java.lang.String name,
                    java.lang.Object value)
Sets a part with the given name and value. The value will be converted to an XML element with the given name as tag name, if it is not already an XML element.
Parameters:
name - part name
part - part value

getPart

public java.lang.Object getPart(java.lang.String name)
Returns the part value with the specified name.

getParts

public java.util.Map getParts()
Returns a map of parts.

getMessage

public java.lang.String getMessage()
Returns String with the fault name, message type QName and parts defined for this fault.
Overrides:
getMessage in class java.lang.Throwable

Skip navigation links

Oracle BPEL Process Manager Client Java API Reference
10g Release 3 (10.1.3.1.0)

B28986-01


Copyright © 2006, Oracle. All rights reserved.