1/*
2 * Copyright (c) 2009, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation.  Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
25
26
27package javax.xml.stream;
28
29/**
30 * An error class for reporting factory configuration errors.
31 *
32 * @version 1.0
33 * @author Copyright (c) 2009 by Oracle Corporation. All Rights Reserved.
34 * @since 1.6
35 */
36public class FactoryConfigurationError extends Error {
37    private static final long serialVersionUID = -2994412584589975744L;
38
39  Exception nested;
40
41  /**
42   * Default constructor
43   */
44  public FactoryConfigurationError(){}
45
46  /**
47   * Construct an exception with a nested inner exception
48   *
49   * @param e the exception to nest
50   */
51  public FactoryConfigurationError(java.lang.Exception e){
52    nested = e;
53  }
54
55  /**
56   * Construct an exception with a nested inner exception
57   * and a message
58   *
59   * @param e the exception to nest
60   * @param msg the message to report
61   */
62  public FactoryConfigurationError(java.lang.Exception e, java.lang.String msg){
63    super(msg);
64    nested = e;
65  }
66
67  /**
68   * Construct an exception with a nested inner exception
69   * and a message
70   *
71   * @param msg the message to report
72   * @param e the exception to nest
73   */
74  public FactoryConfigurationError(java.lang.String msg, java.lang.Exception e){
75    super(msg);
76    nested = e;
77  }
78
79  /**
80   * Construct an exception with associated message
81   *
82   * @param msg the message to report
83   */
84  public FactoryConfigurationError(java.lang.String msg) {
85    super(msg);
86  }
87
88  /**
89   * Return the nested exception (if any)
90   *
91   * @return the nested exception or null
92   */
93  public Exception getException() {
94    return nested;
95  }
96    /**
97     * use the exception chaining mechanism of JDK1.4
98    */
99    @Override
100    public Throwable getCause() {
101        return nested;
102    }
103
104  /**
105   * Report the message associated with this error
106   *
107   * @return the string value of the message
108   */
109  public String getMessage() {
110    String msg = super.getMessage();
111    if(msg != null)
112      return msg;
113    if(nested != null){
114      msg = nested.getMessage();
115      if(msg == null)
116        msg = nested.getClass().toString();
117    }
118    return msg;
119  }
120
121
122
123}
124