Class AxisFault

Method Details

• makeFault

  public static AxisFault makeFault(Exception e)

  Make an AxisFault based on a passed Exception. If the Exception is already an AxisFault, simply use that. Otherwise, wrap it in an AxisFault. If the Exception is an InvocationTargetException (which already wraps another Exception), get the wrapped Exception out from there and use that instead of the passed one.

  Parameters:

  e - the Exception to build a fault for

  Returns:

  an AxisFault representing e

• clearFaultDetails

  public void clearFaultDetails()

  Clear the fault details list.

• dump

  public void dump()

  Dump the fault info to the log at debug level.

• dumpToString

  public String dumpToString()

  turn the fault and details into a string, with XML escaping. subclassers: for security (cross-site-scripting) reasons, escape everything that could contain caller-supplied data.

  Returns:

  stringified fault details

• setFaultCode

  public void setFaultCode(QName code)

  Set the fault code.

  Parameters:

  code - a new fault code

• setFaultCode

  public void setFaultCode(String code)

  Deprecated.

  expect to see this go away after 1.1, use setFaultCodeAsString instead!

  Set the fault code (as a String).

  Parameters:

  code - a new fault code

• setFaultCodeAsString

  public void setFaultCodeAsString(String code)

  set a fault code string that is turned into a qname in the SOAP 1.1 or 1.2 namespace, depending on the current context

  Parameters:

  code - fault code

• getFaultCode

  public QName getFaultCode()

  Get the fault code QName.

  Returns:

  fault code QName or null if there is none yet.

• addFaultSubCodeAsString

  public void addFaultSubCodeAsString(String code)

  Add a fault sub-code with the local name code and namespace Constants.NS_URI_AXIS. This is new in SOAP 1.2, ignored in SOAP 1.1

  Parameters:

  code - the local name of the code to add

  Since:

  axis1.1

• initFaultSubCodes

  protected void initFaultSubCodes()

  Do whatever is needed to create the fault subcodes data structure, if it is needed.

• addFaultSubCode

  public void addFaultSubCode(QName code)

  Add a fault sub-code. This is new in SOAP 1.2, ignored in SOAP 1.1.

  Parameters:

  code - the QName of the fault sub-code to add

  Since:

  axis1.1

• clearFaultSubCodes

  public void clearFaultSubCodes()

  Clear all fault sub-codes. This is new in SOAP 1.2, ignored in SOAP 1.1.

  Since:

  axis1.1

• getFaultSubCodes

  public QName[] getFaultSubCodes()

  get the fault subcode list; only used in SOAP 1.2

  Returns:

  null for no subcodes, or a QName array

  Since:

  axis1.1

• setFaultString

  public void setFaultString(String str)

  Set a fault string.

  Parameters:

  str - new fault string; null is turned into ""

• getFaultString

  public String getFaultString()

  Get the fault string; this will never be null but may be the empty string.

  Returns:

  a fault string

• setFaultReason

  public void setFaultReason(String str)

  This is SOAP 1.2 equivalent of setFaultString(java.lang.String).

  Parameters:

  str - the fault reason as a String

  Since:

  axis1.1

• getFaultReason

  public String getFaultReason()

  This is SOAP 1.2 equivalent of getFaultString().

  Returns:

  the fault String

  Since:

  axis1.1

• setFaultActor

  public void setFaultActor(String actor)

  Set the fault actor.

  Parameters:

  actor - fault actor

• getFaultActor

  public String getFaultActor()

  get the fault actor

  Returns:

  actor or null

• getFaultRole

  public String getFaultRole()

  This is SOAP 1.2 equivalent of getFaultActor().

  Returns:

  the name of the fault actor

  Since:

  axis1.1

• setFaultRole

  public void setFaultRole(String role)

  This is SOAP 1.2 equivalent of setFaultActor(java.lang.String).

  Since:

  axis1.1

• getFaultNode

  public String getFaultNode()

  Get the fault node. This is new in SOAP 1.2

  Returns:

  Since:

  axis1.1

• setFaultNode

  public void setFaultNode(String node)

  Set the fault node. This is new in SOAP 1.2.

  Parameters:

  node - a String representing the fault node

  Since:

  axis1.1

• setFaultDetail

  public void setFaultDetail(Element[] details)

  Set the fault detail element to the arrary of details.

  Parameters:

  details - list of detail elements, can be null

• setFaultDetailString

  public void setFaultDetailString(String details)

  set the fault details to a string element.

  Parameters:

  details - XML fragment

• addFaultDetailString

  public void addFaultDetailString(String detail)

  add a string tag to the fault details.

  Parameters:

  detail - XML fragment

• addFaultDetail

  public void addFaultDetail(Element detail)

  Append an element to the fault detail list.

  Parameters:

  detail - the new element to add

  Since:

  Axis1.1

• addFaultDetail

  public void addFaultDetail(QName qname, String body)

  Create an element of the given qname and add it to the details.

  Parameters:

  qname - qname of the element

  body - string to use as body

• getFaultDetails

  public Element[] getFaultDetails()

  Get all the fault details.

  Returns:

  an array of fault details, or null for none

• lookupFaultDetail

  public Element lookupFaultDetail(QName qname)

  Find a fault detail element by its qname.

  Parameters:

  qname - name of the node to look for

  Returns:

  the matching element or null

  Since:

  axis1.1

• removeFaultDetail

  public boolean removeFaultDetail(QName qname)

  Find and remove a specified fault detail element.

  Parameters:

  qname - qualified name of detail

  Returns:

  true if it was found and removed, false otherwise

  Since:

  axis1.1

• output

  public void output(SerializationContext context) throws Exception

  Add this fault and any needed headers to the output context.

  Parameters:

  context -

  Throws:

  Exception

• toString

  public String toString()

  Stringify this fault as the current fault string.

  Overrides:

  toString in class Throwable

  Returns:

  the fault string, possibly the empty string, but never null

• printStackTrace

  public void printStackTrace(PrintStream ps)

  The override of the base class method prints out the fault info before the stack trace.

  Overrides:

  printStackTrace in class Throwable

  Parameters:

  ps - where to print

• printStackTrace

  public void printStackTrace(PrintWriter pw)

  The override of the base class method prints out the fault info before the stack trace.

  Overrides:

  printStackTrace in class Throwable

  Parameters:

  pw - where to print

• addHeader

  public void addHeader(SOAPHeaderElement header)

  Add a SOAP header which should be serialized along with the fault.

  Parameters:

  header - a SOAPHeaderElement containing some fault-relevant stuff

• getHeaders

  public ArrayList getHeaders()

  Get the SOAP headers associated with this fault.

  Returns:

  an ArrayList containing any headers associated with this fault

• clearHeaders

  public void clearHeaders()

  Clear all fault headers.

• writeDetails

  public void writeDetails(QName qname, SerializationContext context) throws IOException

  Writes any exception data to the faultDetails. This can be overridden (and is) by emitted exception clases. The base implementation will attempt to serialize exception data the fault was created from an Exception and a type mapping is found for it.

  Parameters:

  qname - the QName to write this under

  context - the SerializationContext to write this fault to

  Throws:

  IOException - if we can't write ourselves for any reason

• addHostnameIfNeeded

  public void addHostnameIfNeeded()

  add the hostname of the current system. This is very useful for locating faults on a cluster.

  Since:

  Axis1.2

• addHostname

  public void addHostname(String hostname)

  add the hostname string. If one already exists, remove it.

  Parameters:

  hostname - string name of a host

  Since:

  Axis1.2

• removeHostname

  public void removeHostname()

  strip out the hostname on a message. This is useful for security reasons.