Create a new Exception, setting the cause if possible. : Exceptions « Language Basics « Java

1. Java
2. Language Basics
3. Exceptions

Create a new Exception, setting the cause if possible.

      
/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.    
 */

import java.lang.reflect.Constructor;
import java.lang.reflect.Method;

/**
 * Use this to create a new Exception.  This will run under JDK 1.3 or greater.
 * However, it running under JDK 1.4 it will set the cause.
 *
 * @author <a href="mailto:isidore@setgame.com">Llewellyn Falco</a>
 * @since 1.5
 */
public class ExceptionUtils
{
    private static boolean causesAllowed = true;

    /**
     * Create a new RuntimeException, setting the cause if possible.
     * @param message
     * @param cause
     * @return A runtime exception object.
     */
    public static RuntimeException createRuntimeException(
            String message, Throwable cause)
    {
        return (RuntimeException) createWithCause(
                RuntimeException.class, message, cause);
    }

    /**
     * Create a new Exception, setting the cause if possible.
     * @param clazz
     * @param message
     * @param cause
     * @return A Throwable.
     */
    public static Throwable createWithCause(Class clazz,
            String message, Throwable cause)
    {
        Throwable re = null;
        if (causesAllowed)
        {
            try
            {
                Constructor constructor = clazz
                        .getConstructor(new Class[]{String.class,
                                Throwable.class});
                re = (Throwable) constructor
                        .newInstance(new Object[]{message, cause});
            }
            catch (RuntimeException e)
            {
                throw e;
            }
            catch (Exception e)
            {
                causesAllowed = false;
            }
        }
        if (re == null)
        {
            try
            {
                Constructor constructor = clazz
                        .getConstructor(new Class[]{String.class});
                re = (Throwable) constructor
                        .newInstance(new Object[]{message
                                + " caused by " + cause});
            }
            catch (RuntimeException e)
            {
                throw e;
            }
            catch (Exception e)
            {
                throw new RuntimeException("Error caused " + e); // should be impossible
            }
        }
        return re;
    }

    /**
     * Set the cause of the Exception.  Will detect if this is not allowed.
     * @param onObject
     * @param cause
     */
    public static void setCause(Throwable onObject, Throwable cause)
    {
        if (causesAllowed)
        {
            try
            {
                Method method = onObject.getClass().getMethod("initCause", new Class[]{Throwable.class});
                method.invoke(onObject, new Object[]{cause});
            }
            catch (RuntimeException e)
            {
                throw e;
            }
            catch (Exception e)
            {
                causesAllowed = false;
            }
        }
    }
}

   
    
    
    
    
    
  

Related examples in the same category

1.	Illustrate various Exceptions
2.	Experience exceptions
3.	StackTrace
4.	Getting the Stack Trace of an Exception
5.	What happens if a method declares an unchecked exception?
6.	Simple demo of exceptions
7.	Simple demo of exceptions, with finally clause
8.	ThreadBasedCatcher - Demonstrate catching uncaught exceptions
9.	Exception Catcher
10.	Turning off Checked exceptions
11.	Demonstrates exception chaining
12.	Finally is always executed
13.	Demonstrating the Exception Methods
14.	Further embellishment of exception classes
15.	The finally clause is always executed
16.	Your own Exception class
17.	Catching exception hierarchies
18.	How an exception can be lost
19.	Exception in main method
20.	Ignoring RuntimeExceptions
21.	Demonstrating fillInStackTrace()
22.	Put printStackTrace() into a String: redirect the StackTrace to a String with a StringWriter/PrintWriter
23.	Rethrow a different object from the one that was caught
24.	Inheriting your own exceptions
25.	Overridden methods may throw only the exceptions
26.	Returns the output of printStackTrace as a String.
27.	Locates a particular type of exception
28.	Throw Exception Out
29.	Get Deepest Throwable
30.	Make a string representation of the exception
31.	Utility methods for dealing with stack traces
32.	Returns the root cause of an exception
33.	Utility class to work with throwables
34.	Print all of the thread's information and stack traces
35.	Convert an exception to a String with full stack trace
36.	Return stack trace from the passed exception as a string
37.	Create a new RuntimeException, setting the cause if possible.
38.	Set the cause of the Exception. Will detect if this is not allowed.
39.	Get the stack trace of the supplied exception.
40.	Display Stack Trace Information with StackTraceElement
41.	A collection of utility methods for manipulating exceptions
42.	A frame with a panel for testing various exceptions
43.	Convert Throwable to string
44.	Convert the result of Exception.getStackTrace to a String
45.	Prints the stack trace of the specified throwable to a string and returns it.
46.	Get Stack Trace Element
47.	Get stack trace and cause exception
48.	Exception Helper
49.	Exception Util