Caused by

(KAB-studioからのおしらせです)

// Sample.java
public class Sample
{
    public static void main( String[] args )
    {
        try
        {
            try
            {
                // NullPointerExceptionを投げます。
                throw new NullPointerException();
            }
            catch( NullPointerException e )
            {
                // 投げられたNullPointerExceptionを拾いました。
                e.printStackTrace();
                // java.lang.NullPointerException
                //     at Sample.main(Sample.java:11)

                // さらに例外を投げます。
                // その際、今受け取った例外を「原因」として
                // 格納します。
                throw new Exception( e );
            }
        }
        catch( Exception e )
        {
            // 投げられたExceptionを拾いました。
            e.printStackTrace();
            // java.lang.Exception: java.lang.NullPointerException
            //     at Sample.main(Sample.java:23)
            // Caused by: java.lang.NullPointerException
            //     at Sample.main(Sample.java:11)
            // このように、元々の例外の情報も格納されています。
        }

        // 実際に良くあるパターン、throws指定に合わせて
        // 例外を乗り換えてある例。
        try
        {
            Sample sample = new Sample();
            sample.throwsNewException();
        }
        catch( NewException e )
        {
            e.printStackTrace();
            // NewException: java.lang.ClassNotFoundException
            //     at Sample.throwsNewException(Sample.java:71)
            //     at Sample.main(Sample.java:42)
            // Caused by: java.lang.ClassNotFoundException
            //     at Sample.throwsNewException(Sample.java:61)
            //     ... 1 more
            // このように、受け止めた例外が「殻」で、
            // 本当の原因が中に入っていることは多々あります。
            // 例外のスタックトレースを見るときには必ず
            // Caused byがないかどうかチェックしましょう。
        }
    }
    

    /**
    *   NewExceptionをthrows指定したメソッド。
    */
    private void throwsNewException() throws NewException
    {
        // たとえばこの中でClassNotFoundExceptionが
        // 投げられる可能性があり、それを拾う場合。
        try
        {
            throw new ClassNotFoundException();
        }
        catch( ClassNotFoundException e )
        {
            e.printStackTrace();
            // java.lang.ClassNotFoundException
            //    at Sample.throwsNewException(Sample.java:70)
            //    at Sample.main(Sample.java:42)
            // ClassNotFoundExceptionを拾いました。
            // が、ここで処理もできないので「また投げ」します。
            // でもthrows指定で投げられるのはNewExceptionと
            // 決まっているので、コンストラクタで
            // 「原因」として渡します。
            throw new NewException( e );
            // ただし！
            // たとえば、拾った例外がNullPointerExceptionで、
            // throwsでの指定がClassNotFoundExceptionだった場合に、
            // 同じように詰め込んで投げるのはやめましょう。
            // こういう例が許されるのは、throwsで指定されたクラスが
            // 総称的な意味を持つクラス（たとえばServletException）の
            // 場合だけです。
        }
    }
}


/**
*   新しい自分専用例外クラス。
*/
class NewException extends Exception
{
    /**
    *   Exception( Throwable )のオーバーライド（？）コンストラクタ。
    */
    public NewException( Throwable e )
    {
        super( e );
    }
}