javacard.framework
Class ISOException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          java.lang.RuntimeException
              javacard.framework.CardRuntimeException
                  javacard.framework.ISOException

public class ISOException

extends CardRuntimeException

ISOException class encapsulates an ISO 7816-4 response status word as its reason code.

The APDU class throws JCRE owned instances of ISOException.

JCRE owned instances of exception classes are temporary JCRE Entry Point Objects and can be accessed from any applet context. References to these temporary objects cannot be stored in class variables or instance variables or array components. See Java Card Runtime Environment (JCRE) Specification, section 6.2.1 for details.

Constructor Summary

ISOException(short sw)
Constructs an ISOException instance with the specified status word.

Method Summary

short	getReason() Get reason code
void	setReason(short sw) Set reason code
static void	throwIt(short sw) Throws the JCRE owned instance of the ISOException class with the specified status word.

Methods inherited from class java.lang.Object

equals

Constructor Detail

ISOException

public ISOException(short sw)

Constructs an ISOException instance with the specified status word. To conserve on resources use throwIt() to use the JCRE owned instance of this class.

Parameters:

sw - the ISO 7816-4 defined status word

Method Detail

throwIt

public static void throwIt(short sw)

Throws the JCRE owned instance of the ISOException class with the specified status word.

JCRE owned instances of exception classes are temporary JCRE Entry Point Objects and can be accessed from any applet context. References to these temporary objects cannot be stored in class variables or instance variables or array components. See Java Card Runtime Environment (JCRE) Specification, section 6.2.1 for details.

Parameters:

sw - ISO 7816-4 defined status word

Throws:

ISOException - always.

getReason

public short getReason()

Get reason code

Overrides:

getReason in class CardRuntimeException

Returns:

the reason for the exception

setReason

public void setReason(short sw)

Set reason code

Overrides:

setReason in class CardRuntimeException

Parameters:

sw - the reason for the exception