emul/mini/src/main/java/java/lang/IllegalStateException.java
author Jaroslav Tulach <jaroslav.tulach@apidesign.org>
Sat, 26 Jan 2013 08:47:05 +0100
changeset 592 5e13b1ac2886
parent 66 8a74b5d8d1d4
permissions -rw-r--r--
In order to support fields of the same name in subclasses we are now prefixing them with name of the class that defines them. To provide convenient way to access them from generated bytecode and also directly from JavaScript, there is a getter/setter function for each field. It starts with _ followed by the field name. If called with a parameter, it sets the field, with a parameter it just returns it.
jaroslav@66
     1
/*
jaroslav@66
     2
 * Copyright (c) 1996, 2003, Oracle and/or its affiliates. All rights reserved.
jaroslav@66
     3
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
jaroslav@66
     4
 *
jaroslav@66
     5
 * This code is free software; you can redistribute it and/or modify it
jaroslav@66
     6
 * under the terms of the GNU General Public License version 2 only, as
jaroslav@66
     7
 * published by the Free Software Foundation.  Oracle designates this
jaroslav@66
     8
 * particular file as subject to the "Classpath" exception as provided
jaroslav@66
     9
 * by Oracle in the LICENSE file that accompanied this code.
jaroslav@66
    10
 *
jaroslav@66
    11
 * This code is distributed in the hope that it will be useful, but WITHOUT
jaroslav@66
    12
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
jaroslav@66
    13
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
jaroslav@66
    14
 * version 2 for more details (a copy is included in the LICENSE file that
jaroslav@66
    15
 * accompanied this code).
jaroslav@66
    16
 *
jaroslav@66
    17
 * You should have received a copy of the GNU General Public License version
jaroslav@66
    18
 * 2 along with this work; if not, write to the Free Software Foundation,
jaroslav@66
    19
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
jaroslav@66
    20
 *
jaroslav@66
    21
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
jaroslav@66
    22
 * or visit www.oracle.com if you need additional information or have any
jaroslav@66
    23
 * questions.
jaroslav@66
    24
 */
jaroslav@66
    25
jaroslav@66
    26
package java.lang;
jaroslav@66
    27
jaroslav@66
    28
/**
jaroslav@66
    29
 * Signals that a method has been invoked at an illegal or
jaroslav@66
    30
 * inappropriate time.  In other words, the Java environment or
jaroslav@66
    31
 * Java application is not in an appropriate state for the requested
jaroslav@66
    32
 * operation.
jaroslav@66
    33
 *
jaroslav@66
    34
 * @author  Jonni Kanerva
jaroslav@66
    35
 * @since   JDK1.1
jaroslav@66
    36
 */
jaroslav@66
    37
public
jaroslav@66
    38
class IllegalStateException extends RuntimeException {
jaroslav@66
    39
    /**
jaroslav@66
    40
     * Constructs an IllegalStateException with no detail message.
jaroslav@66
    41
     * A detail message is a String that describes this particular exception.
jaroslav@66
    42
     */
jaroslav@66
    43
    public IllegalStateException() {
jaroslav@66
    44
        super();
jaroslav@66
    45
    }
jaroslav@66
    46
jaroslav@66
    47
    /**
jaroslav@66
    48
     * Constructs an IllegalStateException with the specified detail
jaroslav@66
    49
     * message.  A detail message is a String that describes this particular
jaroslav@66
    50
     * exception.
jaroslav@66
    51
     *
jaroslav@66
    52
     * @param s the String that contains a detailed message
jaroslav@66
    53
     */
jaroslav@66
    54
    public IllegalStateException(String s) {
jaroslav@66
    55
        super(s);
jaroslav@66
    56
    }
jaroslav@66
    57
jaroslav@66
    58
    /**
jaroslav@66
    59
     * Constructs a new exception with the specified detail message and
jaroslav@66
    60
     * cause.
jaroslav@66
    61
     *
jaroslav@66
    62
     * <p>Note that the detail message associated with <code>cause</code> is
jaroslav@66
    63
     * <i>not</i> automatically incorporated in this exception's detail
jaroslav@66
    64
     * message.
jaroslav@66
    65
     *
jaroslav@66
    66
     * @param  message the detail message (which is saved for later retrieval
jaroslav@66
    67
     *         by the {@link Throwable#getMessage()} method).
jaroslav@66
    68
     * @param  cause the cause (which is saved for later retrieval by the
jaroslav@66
    69
     *         {@link Throwable#getCause()} method).  (A <tt>null</tt> value
jaroslav@66
    70
     *         is permitted, and indicates that the cause is nonexistent or
jaroslav@66
    71
     *         unknown.)
jaroslav@66
    72
     * @since 1.5
jaroslav@66
    73
     */
jaroslav@66
    74
    public IllegalStateException(String message, Throwable cause) {
jaroslav@66
    75
        super(message, cause);
jaroslav@66
    76
    }
jaroslav@66
    77
jaroslav@66
    78
    /**
jaroslav@66
    79
     * Constructs a new exception with the specified cause and a detail
jaroslav@66
    80
     * message of <tt>(cause==null ? null : cause.toString())</tt> (which
jaroslav@66
    81
     * typically contains the class and detail message of <tt>cause</tt>).
jaroslav@66
    82
     * This constructor is useful for exceptions that are little more than
jaroslav@66
    83
     * wrappers for other throwables (for example, {@link
jaroslav@66
    84
     * java.security.PrivilegedActionException}).
jaroslav@66
    85
     *
jaroslav@66
    86
     * @param  cause the cause (which is saved for later retrieval by the
jaroslav@66
    87
     *         {@link Throwable#getCause()} method).  (A <tt>null</tt> value is
jaroslav@66
    88
     *         permitted, and indicates that the cause is nonexistent or
jaroslav@66
    89
     *         unknown.)
jaroslav@66
    90
     * @since  1.5
jaroslav@66
    91
     */
jaroslav@66
    92
    public IllegalStateException(Throwable cause) {
jaroslav@66
    93
        super(cause);
jaroslav@66
    94
    }
jaroslav@66
    95
jaroslav@66
    96
    static final long serialVersionUID = -1848914673093119416L;
jaroslav@66
    97
}