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.
     1 /*
     2  * Copyright (c) 1996, 2003, 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 package java.lang;
    27 
    28 /**
    29  * Signals that a method has been invoked at an illegal or
    30  * inappropriate time.  In other words, the Java environment or
    31  * Java application is not in an appropriate state for the requested
    32  * operation.
    33  *
    34  * @author  Jonni Kanerva
    35  * @since   JDK1.1
    36  */
    37 public
    38 class IllegalStateException extends RuntimeException {
    39     /**
    40      * Constructs an IllegalStateException with no detail message.
    41      * A detail message is a String that describes this particular exception.
    42      */
    43     public IllegalStateException() {
    44         super();
    45     }
    46 
    47     /**
    48      * Constructs an IllegalStateException with the specified detail
    49      * message.  A detail message is a String that describes this particular
    50      * exception.
    51      *
    52      * @param s the String that contains a detailed message
    53      */
    54     public IllegalStateException(String s) {
    55         super(s);
    56     }
    57 
    58     /**
    59      * Constructs a new exception with the specified detail message and
    60      * cause.
    61      *
    62      * <p>Note that the detail message associated with <code>cause</code> is
    63      * <i>not</i> automatically incorporated in this exception's detail
    64      * message.
    65      *
    66      * @param  message the detail message (which is saved for later retrieval
    67      *         by the {@link Throwable#getMessage()} method).
    68      * @param  cause the cause (which is saved for later retrieval by the
    69      *         {@link Throwable#getCause()} method).  (A <tt>null</tt> value
    70      *         is permitted, and indicates that the cause is nonexistent or
    71      *         unknown.)
    72      * @since 1.5
    73      */
    74     public IllegalStateException(String message, Throwable cause) {
    75         super(message, cause);
    76     }
    77 
    78     /**
    79      * Constructs a new exception with the specified cause and a detail
    80      * message of <tt>(cause==null ? null : cause.toString())</tt> (which
    81      * typically contains the class and detail message of <tt>cause</tt>).
    82      * This constructor is useful for exceptions that are little more than
    83      * wrappers for other throwables (for example, {@link
    84      * java.security.PrivilegedActionException}).
    85      *
    86      * @param  cause the cause (which is saved for later retrieval by the
    87      *         {@link Throwable#getCause()} method).  (A <tt>null</tt> value is
    88      *         permitted, and indicates that the cause is nonexistent or
    89      *         unknown.)
    90      * @since  1.5
    91      */
    92     public IllegalStateException(Throwable cause) {
    93         super(cause);
    94     }
    95 
    96     static final long serialVersionUID = -1848914673093119416L;
    97 }