UndeclaredThrowableException.java revision f33eae7e84eb6d3b0f4e86b59605bb3de73009f3 
1/*
2 *  Licensed to the Apache Software Foundation (ASF) under one or more
3 *  contributor license agreements.  See the NOTICE file distributed with
4 *  this work for additional information regarding copyright ownership.
5 *  The ASF licenses this file to You under the Apache License, Version 2.0
6 *  (the "License"); you may not use this file except in compliance with
7 *  the License.  You may obtain a copy of the License at
8 *
9 *     http://www.apache.org/licenses/LICENSE-2.0
10 *
11 *  Unless required by applicable law or agreed to in writing, software
12 *  distributed under the License is distributed on an "AS IS" BASIS,
13 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 *  See the License for the specific language governing permissions and
15 *  limitations under the License.
16 */
17
18package java.lang.reflect;
19
20/**
21 * This class provides a wrapper for an undeclared, checked exception thrown by
22 * an InvocationHandler.
23 *
24 * @see java.lang.reflect.InvocationHandler#invoke
25 */
26public class UndeclaredThrowableException extends RuntimeException {
27
28    private static final long serialVersionUID = 330127114055056639L;
29
30    private Throwable undeclaredThrowable;
31
32    /**
33     * Constructs a new {@code UndeclaredThrowableException} instance with the
34     * undeclared, checked exception that occurred.
35     *
36     * @param exception
37     *            the undeclared, checked exception that occurred
38     */
39    public UndeclaredThrowableException(Throwable exception) {
40        super();
41        this.undeclaredThrowable = exception;
42        initCause(exception);
43    }
44
45    /**
46     * Constructs a new {@code UndeclaredThrowableException} instance with the
47     * undeclared, checked exception that occurred and a message.
48     *
49     * @param detailMessage
50     *            the detail message for the exception
51     * @param exception
52     *            the undeclared, checked exception that occurred
53     */
54    public UndeclaredThrowableException(Throwable exception,
55            String detailMessage) {
56        super(detailMessage);
57        this.undeclaredThrowable = exception;
58        initCause(exception);
59    }
60
61    /**
62     * Returns the undeclared, checked exception that occurred, which may be
63     * {@code null}.
64     *
65     * @return the undeclared, checked exception that occurred
66     */
67    public Throwable getUndeclaredThrowable() {
68        return undeclaredThrowable;
69    }
70
71    /**
72     * Returns the undeclared, checked exception that occurred, which may be
73     * {@code null}.
74     *
75     * @return the undeclared, checked exception that occurred
76     */
77    @Override
78    public Throwable getCause() {
79        return undeclaredThrowable;
80    }
81}
82