51 |
* |
* |
52 |
* @author Brian Jones |
* @author Brian Jones |
53 |
* @author Warren Levy (warrenl@cygnus.com) |
* @author Warren Levy (warrenl@cygnus.com) |
54 |
|
* @author Andrew John Hughes (gnu_andrew@member.fsf.org) |
55 |
* @since 1.1 |
* @since 1.1 |
56 |
* @status updated to 1.4 |
* @status updated to 1.5 |
57 |
*/ |
*/ |
58 |
public class IllegalStateException extends RuntimeException |
public class IllegalStateException extends RuntimeException |
59 |
{ |
{ |
78 |
{ |
{ |
79 |
super(s); |
super(s); |
80 |
} |
} |
81 |
|
|
82 |
|
/** |
83 |
|
* <p> |
84 |
|
* Constructs a <code>IllegalStateException</code> using |
85 |
|
* the specified error message, which should give further details |
86 |
|
* as to the reason for this exception. The specified cause |
87 |
|
* <code>Throwable</code> may be used to provide additional history, |
88 |
|
* with regards to the root of the problem. It is perfectly valid |
89 |
|
* for this to be null, if the cause of the problem is unknown. |
90 |
|
* </p> |
91 |
|
* <p> |
92 |
|
* <strong>Note</strong>: the detail message from the cause is not |
93 |
|
* automatically incorporated into the resulting detail message of |
94 |
|
* this exception. |
95 |
|
* </p> |
96 |
|
* |
97 |
|
* @param message the detail message, which should give the reason for |
98 |
|
* this exception being thrown. |
99 |
|
* @param cause the cause of this exception, or null if the cause |
100 |
|
* is unknown. |
101 |
|
* @since 1.5 |
102 |
|
*/ |
103 |
|
public IllegalStateException(String message, Throwable cause) |
104 |
|
{ |
105 |
|
super(message, cause); |
106 |
|
} |
107 |
|
|
108 |
|
/** |
109 |
|
* <p> |
110 |
|
* Constructs a <code>IllegalStateException</code> using |
111 |
|
* the specified cause <code>Throwable</code>, which may be used |
112 |
|
* to provide additional history, with regards to the root of the |
113 |
|
* problem. It is perfectly valid for this to be null, if the |
114 |
|
* cause of the problem is unknown. |
115 |
|
* </p> |
116 |
|
* <p> |
117 |
|
* The detail message is automatically constructed from the detail |
118 |
|
* message of the supplied causal exception. If the cause is null, |
119 |
|
* then the detail message will also be null. Otherwise, the detail |
120 |
|
* message of this exception will be that of the causal exception. |
121 |
|
* This makes this constructor very useful for simply wrapping another |
122 |
|
* exception. |
123 |
|
* </p> |
124 |
|
* |
125 |
|
* @param cause the cause of this exception, or null if the cause |
126 |
|
* is unknown. |
127 |
|
* @since 1.5 |
128 |
|
*/ |
129 |
|
public IllegalStateException(Throwable cause) |
130 |
|
{ |
131 |
|
super(cause); |
132 |
|
} |
133 |
|
|
134 |
} |
} |
135 |
|
|