01: /* $Id: PluginConfigurationException.java 476205 2006-11-17 16:43:10Z dennisl $
02: *
03: * Licensed to the Apache Software Foundation (ASF) under one or more
04: * contributor license agreements. See the NOTICE file distributed with
05: * this work for additional information regarding copyright ownership.
06: * The ASF licenses this file to You under the Apache License, Version 2.0
07: * (the "License"); you may not use this file except in compliance with
08: * the License. You may obtain a copy of the License at
09: *
10: * http://www.apache.org/licenses/LICENSE-2.0
11: *
12: * Unless required by applicable law or agreed to in writing, software
13: * distributed under the License is distributed on an "AS IS" BASIS,
14: * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15: * See the License for the specific language governing permissions and
16: * limitations under the License.
17: */
18:
19: package org.apache.commons.digester.plugins;
20:
21: /**
22: * Thrown when an error occurs due to the way the calling application uses
23: * the plugins module. Because the pre-existing Digester API doesn't provide
24: * any option for throwing checked exceptions at some points where Plugins
25: * can potentially fail, this exception extends RuntimeException so that it
26: * can "tunnel" through these points.
27: *
28: * @since 1.6
29: */
30:
31: public class PluginConfigurationException extends RuntimeException {
32: private Throwable cause = null;
33:
34: /**
35: * @param cause underlying exception that caused this to be thrown
36: */
37: public PluginConfigurationException(Throwable cause) {
38: this (cause.getMessage());
39: this .cause = cause;
40: }
41:
42: /**
43: * @param msg describes the reason this exception is being thrown.
44: */
45: public PluginConfigurationException(String msg) {
46: super (msg);
47: }
48:
49: /**
50: * @param msg describes the reason this exception is being thrown.
51: * @param cause underlying exception that caused this to be thrown
52: */
53: public PluginConfigurationException(String msg, Throwable cause) {
54: this (msg);
55: this .cause = cause;
56: }
57:
58: /**
59: * Return the cause of this exception (if any) as specified in the
60: * exception constructor.
61: *
62: * @since 1.8
63: */
64: public Throwable getCause() {
65: return cause;
66: }
67: }
|