1 | /* Error.java -- Indication of fatal abnormal conditions
|
---|
2 | Copyright (C) 1998, 1999, 2001, 2002 Free Software Foundation, Inc.
|
---|
3 |
|
---|
4 | This file is part of GNU Classpath.
|
---|
5 |
|
---|
6 | GNU Classpath is free software; you can redistribute it and/or modify
|
---|
7 | it under the terms of the GNU General Public License as published by
|
---|
8 | the Free Software Foundation; either version 2, or (at your option)
|
---|
9 | any later version.
|
---|
10 |
|
---|
11 | GNU Classpath is distributed in the hope that it will be useful, but
|
---|
12 | WITHOUT ANY WARRANTY; without even the implied warranty of
|
---|
13 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
---|
14 | General Public License for more details.
|
---|
15 |
|
---|
16 | You should have received a copy of the GNU General Public License
|
---|
17 | along with GNU Classpath; see the file COPYING. If not, write to the
|
---|
18 | Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
|
---|
19 | 02111-1307 USA.
|
---|
20 |
|
---|
21 | Linking this library statically or dynamically with other modules is
|
---|
22 | making a combined work based on this library. Thus, the terms and
|
---|
23 | conditions of the GNU General Public License cover the whole
|
---|
24 | combination.
|
---|
25 |
|
---|
26 | As a special exception, the copyright holders of this library give you
|
---|
27 | permission to link this library with independent modules to produce an
|
---|
28 | executable, regardless of the license terms of these independent
|
---|
29 | modules, and to copy and distribute the resulting executable under
|
---|
30 | terms of your choice, provided that you also meet, for each linked
|
---|
31 | independent module, the terms and conditions of the license of that
|
---|
32 | module. An independent module is a module which is not derived from
|
---|
33 | or based on this library. If you modify this library, you may extend
|
---|
34 | this exception to your version of the library, but you are not
|
---|
35 | obligated to do so. If you do not wish to do so, delete this
|
---|
36 | exception statement from your version. */
|
---|
37 |
|
---|
38 |
|
---|
39 | package java.lang;
|
---|
40 |
|
---|
41 | /**
|
---|
42 | * Applications should not try to catch errors since they indicate
|
---|
43 | * abnormal conditions. An abnormal condition is something which should not
|
---|
44 | * occur, or which should not be recovered from. This latter category
|
---|
45 | * includes <code>ThreadDeath</code> and <code>AssertionError</code>.
|
---|
46 | *
|
---|
47 | * <p>A method is not required to declare any subclass of <code>Error</code> in
|
---|
48 | * its <code>throws</code> clause which might be thrown but not caught while
|
---|
49 | * executing the method.
|
---|
50 | *
|
---|
51 | * @author Brian Jones
|
---|
52 | * @author Tom Tromey <tromey@cygnus.com>
|
---|
53 | * @author Eric Blake <ebb9@email.byu.edu>
|
---|
54 | * @since 1.0
|
---|
55 | * @status updated to 1.4
|
---|
56 | */
|
---|
57 | public class Error extends Throwable
|
---|
58 | {
|
---|
59 | /**
|
---|
60 | * Compatible with JDK 1.0+.
|
---|
61 | */
|
---|
62 | private static final long serialVersionUID = 4980196508277280342L;
|
---|
63 |
|
---|
64 | /**
|
---|
65 | * Create an error without a message. The cause remains uninitialized.
|
---|
66 | *
|
---|
67 | * @see #initCause(Throwable)
|
---|
68 | */
|
---|
69 | public Error()
|
---|
70 | {
|
---|
71 | }
|
---|
72 |
|
---|
73 | /**
|
---|
74 | * Create an error with a message. The cause remains uninitialized.
|
---|
75 | *
|
---|
76 | * @param s the message string
|
---|
77 | * @see #initCause(Throwable)
|
---|
78 | */
|
---|
79 | public Error(String s)
|
---|
80 | {
|
---|
81 | super(s);
|
---|
82 | }
|
---|
83 |
|
---|
84 | /**
|
---|
85 | * Create an error with a message and a cause.
|
---|
86 | *
|
---|
87 | * @param s the message string
|
---|
88 | * @param cause the cause of this error
|
---|
89 | * @since 1.4
|
---|
90 | */
|
---|
91 | public Error(String s, Throwable cause)
|
---|
92 | {
|
---|
93 | super(s, cause);
|
---|
94 | }
|
---|
95 |
|
---|
96 | /**
|
---|
97 | * Create an error with a given cause, and a message of
|
---|
98 | * <code>cause == null ? null : cause.toString()</code>.
|
---|
99 | *
|
---|
100 | * @param cause the cause of this error
|
---|
101 | * @since 1.4
|
---|
102 | */
|
---|
103 | public Error(Throwable cause)
|
---|
104 | {
|
---|
105 | super(cause);
|
---|
106 | }
|
---|
107 | }
|
---|