Class 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 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.