Package uicc.usim.suci

Class SUCIException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

javacard.framework.CardRuntimeException

uicc.usim.suci.SUCIException

All Implemented Interfaces:

Serializable

public class SUCIException
extends javacard.framework.CardRuntimeException

This class extends the Throwable class and allows the classes of this package to throw specific exceptions in case of problems.

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final short	ALREADY_REGISTERED	This reason code (= 2) is used to indicate that the there is already an instance of a SUCICalculator object registered in the USIM application.
static final short	NO_USIM	This reason code (= 1) is used to indicate that the there is no USIM.
static final short	NOT_REGISTERED	This reason code (= 3) is used to indicate that the provided object SUCICalculator is not the one already registered object in the USIM application.
static final short	WRONG_INTERFACE	This reason code (= 4) is used to indicate that the provided object doesn't implement the expected interface.
static final short	WRONG_OWNERSHIP	This reason code (= 5) is used to indicate that the provided object to be registered is not on the same security domain of the targeted USIM application.

Constructor Summary

Constructors

Constructor	Description
SUCIException(short reason)	Construct a SUCIException instance with the specified reason.

Method Summary

Modifier and Type	Method	Description
static void	throwIt(short reason)	Throws the JCRE instance of the SUCIException class with the specified reason.

Methods inherited from class javacard.framework.CardRuntimeException

getReason, setReason

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

NO_USIM

public static final short NO_USIM

This reason code (= 1) is used to indicate that the there is no USIM.

See Also:

• Constant Field Values

ALREADY_REGISTERED

public static final short ALREADY_REGISTERED

This reason code (= 2) is used to indicate that the there is already an instance of a SUCICalculator object registered in the USIM application.

See Also:

• Constant Field Values

NOT_REGISTERED

public static final short NOT_REGISTERED

This reason code (= 3) is used to indicate that the provided object SUCICalculator is not the one already registered object in the USIM application.

See Also:

• Constant Field Values

WRONG_INTERFACE

public static final short WRONG_INTERFACE

This reason code (= 4) is used to indicate that the provided object doesn't implement the expected interface.

See Also:

• Constant Field Values

WRONG_OWNERSHIP

public static final short WRONG_OWNERSHIP

This reason code (= 5) is used to indicate that the provided object to be registered is not on the same security domain of the targeted USIM application.

See Also:

• Constant Field Values

Constructor Details

SUCIException

public SUCIException(short reason)

Construct a SUCIException instance with the specified reason. To conserve on resources use throwIt() method to re-use the JCRE instance of this class.

Parameters:

reason - the reason for the exception

Method Details

throwIt

public static void throwIt(short reason)
                    throws SUCIException

Throws the JCRE instance of the SUCIException class with the specified reason.

Parameters:

reason - the reason for the exception.

Throws:

SUCIException - always