001: /*
002: *
003: *
004: * Copyright 1990-2007 Sun Microsystems, Inc. All Rights Reserved.
005: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER
006: *
007: * This program is free software; you can redistribute it and/or
008: * modify it under the terms of the GNU General Public License version
009: * 2 only, as published by the Free Software Foundation.
010: *
011: * This program is distributed in the hope that it will be useful, but
012: * WITHOUT ANY WARRANTY; without even the implied warranty of
013: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
014: * General Public License version 2 for more details (a copy is
015: * included at /legal/license.txt).
016: *
017: * You should have received a copy of the GNU General Public License
018: * version 2 along with this work; if not, write to the Free Software
019: * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
020: * 02110-1301 USA
021: *
022: * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
023: * Clara, CA 95054 or visit www.sun.com if you need additional
024: * information or have any questions.
025: */
026:
027: package javacard.framework;
028:
029: /**
030: * <code>SystemException</code> represents a <code>JCSystem</code>
031: * class-related exception.
032: */
033:
034: public class SystemException extends CardRuntimeException {
035:
036: // SystemException reason code
037: /**
038: * This reason code is used to indicate that one or more input parameters
039: * is out of allowed bounds.
040: */
041: public static final short ILLEGAL_VALUE = 1;
042:
043: /**
044: * This reason code is used by the <code>makeTransient*()</code> methods
045: * to indicate that no room is available in volatile memory for
046: * the requested object.
047: */
048: public static final short NO_TRANSIENT_SPACE = 2;
049:
050: /**
051: * This reason code is used to indicate that the request to create
052: * a transient object is not allowed in the current applet context.
053: * See <em>Java Card Runtime Environment (JCRE)
054: * Specification</em>, section 6.2.1 for details.
055: */
056: public static final short ILLEGAL_TRANSIENT = 3;
057:
058: /**
059: * This reason code is used by the
060: * <code>javacard.framework.Applet.register()</code> method
061: * to indicate that the input AID parameter is not a legal AID value.
062: */
063: public static final short ILLEGAL_AID = 4;
064:
065: /**
066: * This reason code is used to indicate that there is insufficient resource
067: * in the Card for the request.
068: * <p>For example, the Java Card Virtual Machine may <code>throw</code>
069: * this exception reason when there is insufficient heap space to
070: * create a new instance.
071: */
072: public static final short NO_RESOURCE = 5;
073:
074: /**
075: * This reason code is used to indicate that the requested function is not
076: * allowed. For example,
077: * <CODE>JCSystem.requestObjectDeletion()</CODE> method throws
078: * this exception if the object deletion mechanism is not implemented.
079: */
080: public static final short ILLEGAL_USE = 6;
081:
082: /**
083: * Constructs a SystemException.
084: * @param reason the reason for the exception
085: */
086:
087: public SystemException(short reason) {
088: super (reason);
089: }
090:
091: /**
092: * Throws an instance of <code>SystemException</code> with the
093: * specified reason.
094: * @param reason the reason for the exception.
095: * @exception SystemException always
096: */
097: public static void throwIt(short reason) throws SystemException {
098: throw new SystemException(reason);
099: }
100: }
|