View Javadoc
1   /*
2    * reserved comment block
3    * DO NOT REMOVE OR ALTER!
4    */
5   /*
6    * Copyright 1999-2004 The Apache Software Foundation.
7    *
8    * Licensed under the Apache License, Version 2.0 (the "License");
9    * you may not use this file except in compliance with the License.
10   * You may obtain a copy of the License at
11   *
12   *     http://www.apache.org/licenses/LICENSE-2.0
13   *
14   * Unless required by applicable law or agreed to in writing, software
15   * distributed under the License is distributed on an "AS IS" BASIS,
16   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
17   * See the License for the specific language governing permissions and
18   * limitations under the License.
19   */
20  /*
21   * $Id: DTMConfigurationException.java,v 1.2.4.1 2005/09/15 08:14:52 suresh_emailid Exp $
22   */
23  package com.sun.org.apache.xml.internal.dtm;
24  
25  import javax.xml.transform.SourceLocator;
26  
27  /**
28   * Indicates a serious configuration error.
29   */
30  public class DTMConfigurationException extends DTMException {
31      static final long serialVersionUID = -4607874078818418046L;
32  
33      /**
34       * Create a new <code>DTMConfigurationException</code> with no
35       * detail mesage.
36       */
37      public DTMConfigurationException() {
38          super("Configuration Error");
39      }
40  
41      /**
42       * Create a new <code>DTMConfigurationException</code> with
43       * the <code>String </code> specified as an error message.
44       *
45       * @param msg The error message for the exception.
46       */
47      public DTMConfigurationException(String msg) {
48          super(msg);
49      }
50  
51      /**
52       * Create a new <code>DTMConfigurationException</code> with a
53       * given <code>Exception</code> base cause of the error.
54       *
55       * @param e The exception to be encapsulated in a
56       * DTMConfigurationException.
57       */
58      public DTMConfigurationException(Throwable e) {
59          super(e);
60      }
61  
62      /**
63       * Create a new <code>DTMConfigurationException</code> with the
64       * given <code>Exception</code> base cause and detail message.
65       *
66       * @param msg The detail message.
67       * @param e The exception to be wrapped in a DTMConfigurationException
68       */
69      public DTMConfigurationException(String msg, Throwable e) {
70          super(msg, e);
71      }
72  
73      /**
74       * Create a new DTMConfigurationException from a message and a Locator.
75       *
76       * <p>This constructor is especially useful when an application is
77       * creating its own exception from within a DocumentHandler
78       * callback.</p>
79       *
80       * @param message The error or warning message.
81       * @param locator The locator object for the error or warning.
82       */
83      public DTMConfigurationException(String message,
84                                               SourceLocator locator) {
85          super(message, locator);
86      }
87  
88      /**
89       * Wrap an existing exception in a DTMConfigurationException.
90       *
91       * @param message The error or warning message, or null to
92       *                use the message from the embedded exception.
93       * @param locator The locator object for the error or warning.
94       * @param e Any exception.
95       */
96      public DTMConfigurationException(String message,
97                                               SourceLocator locator,
98                                               Throwable e) {
99          super(message, locator, e);
100     }
101 }