org.apache.axis2.jaxws
Class ExceptionFactory

java.lang.Object
  org.apache.axis2.jaxws.ExceptionFactory

public class ExceptionFactory
extends Object

ExceptionFactory is used to create exceptions within the JAX-WS implementation. There are several reasons for using a factory to create exceptions. 1. We can intercept all exception creation and add the appropriate logging/serviceability. 2. Exceptions are chained. ExceptionFactory can lengthen or reduce the cause chains as necessary to support the JAX-WS programming model. 3. Prevents construction of the same exception. Uses similar principles as AxisFault.makeException.

Example Usage: // Example usage

public fooMethod() throws WebServiceException { try{ ... } catch(Exception e){ throw ExceptionFactory.makeWebServiceException(e); } }

Field Summary

protected static org.apache.commons.logging.Log

log

Method Summary

static ProtocolException	makeProtocolException(String message, Throwable throwable) Create a ProtocolException using the information from a Throwable and message
static WebServiceException	makeWebServiceException(String message) Make a WebServiceException with a given message
static WebServiceException	makeWebServiceException(String message, Throwable throwable) Create a WebServiceException using the information from a given Throwable instance and message
static WebServiceException	makeWebServiceException(Throwable throwable) Create a WebServiceException using the information from a given Throwable instance
static void	setInitialCause(Throwable target, Throwable initialCause) Give a target Throwable, set the initialCause Throwable as the initial cause on the target.
static String	stackToString(Throwable e) Get a string containing the stack of the specified exception

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

log

protected static org.apache.commons.logging.Log log

Method Detail

makeWebServiceException

public static WebServiceException makeWebServiceException(String message,
                                                          Throwable throwable)

Create a WebServiceException using the information from a given Throwable instance and message

Parameters:

message -

throwable -

Returns:

WebServiceException

makeProtocolException

public static ProtocolException makeProtocolException(String message,
                                                      Throwable throwable)

Create a ProtocolException using the information from a Throwable and message

Parameters:

message -

throwable -

Returns:

ProtocolException

makeWebServiceException

public static WebServiceException makeWebServiceException(String message)

Make a WebServiceException with a given message

Parameters:

message -

Returns:

WebServiceException

makeWebServiceException

public static WebServiceException makeWebServiceException(Throwable throwable)

Create a WebServiceException using the information from a given Throwable instance

Parameters:

throwable -

Returns:

WebServiceException

stackToString

public static String stackToString(Throwable e)

Get a string containing the stack of the specified exception

Parameters:

e -

Returns:

setInitialCause

public static void setInitialCause(Throwable target,
                                   Throwable initialCause)

Give a target Throwable, set the initialCause Throwable as the initial cause on the target.

Parameters:

target - The throwable on which to set the initial cause

initialCause - The initial cause to set on the target Throwable.