javacard.framework
Class CardException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by javacard.framework.CardException
Direct Known Subclasses:
UserException

public class CardException
extends Exception

The CardException class defines a field reason and two accessor methods getReason() and setReason(). The reason field encapsulates an exception cause identifier in Java Card. All Java Card checked exception classes should extend CardException.

Since:
BlackBerry API 4.2.1

Constructor Summary
CardException(short reason)
          Constructs a CardException instance with the specified reason.
 
Method Summary
 short getReason()
          Gets the reason code.
 void setReason(short reason)
          Sets the reason code.
static void throwIt(short reason)
          Throws an instance of CardException class with the specified reason.
 
Methods inherited from class java.lang.Throwable
getMessage, printStackTrace, toString
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 



Constructor Detail

CardException

public CardException(short reason)
Constructs a CardException instance with the specified reason.

Parameters:
reason - the reason for the exception
Since:
BlackBerry API 4.2.1


Method Detail

getReason

public short getReason()
Gets the reason code.

Returns:
the reason for the exception
Since:
BlackBerry API 4.2.1

setReason

public void setReason(short reason)
Sets the reason code.

Parameters:
reason - the reason for the exception
Since:
BlackBerry API 4.2.1

throwIt

public static void throwIt(short reason)
                    throws CardException
Throws an instance of CardException class with the specified reason.

Parameters:
reason - the reason for the exception
Throws:
CardException - always
Since:
BlackBerry API 4.2.1





Copyright 1999-2010 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.