Package uicc.usim.suci

Class SUCIRegistry

java.lang.Object

uicc.usim.suci.SUCIRegistry

public class SUCIRegistry
extends Object

The SUCIRegistry class contains static method(s) to register object(s) in the USIM. Theses object exposes SUCI related services.

Method Summary

Modifier and Type	Method	Description
static void	deregisterSUCICalculator(javacard.framework.AID aid, SUCICalculator calc)	Deregister an instance of an object that implements SUCICalculator interface from the indicated USIM application.
static void	deregisterSUCICalculator(SUCICalculator calc)	Deregister an instance of an object that implements SUCICalculator interface from the USIM application.
static void	registerSUCICalculator(javacard.framework.AID aid, SUCICalculator calc)	Register an instance of an object that implements SUCICalculator interface to the indicated USIM application.
static void	registerSUCICalculator(SUCICalculator calc)	Register an instance of an object that implements SUCICalculator interface to the USIM application.

Methods inherited from class java.lang.Object

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

Method Details

registerSUCICalculator

public static void registerSUCICalculator(javacard.framework.AID aid,
 SUCICalculator calc)

Register an instance of an object that implements SUCICalculator interface to the indicated USIM application. This object will be used by the USIM to retrieve the SUCI to be returned to the terminal

Note:

• The object SUCICalculator, shall be in the same security domain of the the indicated USIM application.
• To deregister the object SUCICalculator, the reference of this object will be needed.

Parameters:

aid - AID of the USIM requesting USIM SUCI services

calc - object that implements SUCICalculator

Throws:

NullPointerException - if aid or calc is null

javacard.framework.SystemException - if aid is not present or not an USIM application

SUCIException - with the following reason codes:

• SUCIException.ALREADY_REGISTERED if a SUCICalculator is already registered to the indicated USIM
• SUCIException.WRONG_INTERFACE if calc object doesn't implement SUCICalculator interface
• SUCIException.WRONG_OWNERSHIP if calc object is from an application not in the same security domain of the indicated USIM application.

registerSUCICalculator

public static void registerSUCICalculator(SUCICalculator calc)

Register an instance of an object that implements SUCICalculator interface to the USIM application. This object will be used by the USIM to retrieve the SUCI to be returned to the terminal

Note:

• The object SUCICalculator, shall be in the same security domain of the the indicated USIM application.
• To deregister the object SUCICalculator, the reference of this object will be needed.

Parameters:

calc - object that implements SUCICalculator

Throws:

NullPointerException - if calc is null

SUCIException - with the following reason codes:

• SUCIException.NO_USIM if there is no USIM available.
• SUCIException.ALREADY_REGISTERED if an SUCICalculator is already registered to the indicated USIM
• SUCIException.WRONG_INTERFACE if calc object doesn't implement SUCICalculator interface
• SUCIException.WRONG_OWNERSHIP if calc object is from an application not in the same security domain of the indicated USIM application.

deregisterSUCICalculator

public static void deregisterSUCICalculator(javacard.framework.AID aid,
 SUCICalculator calc)

Deregister an instance of an object that implements SUCICalculator interface from the indicated USIM application.

Parameters:

aid - AID of the USIM using SUCI services

calc - object that implements SUCICalculator that is registered and should be deregistered

Throws:

NullPointerException - if aid or calc is null

javacard.framework.SystemException - if aid is not present or not an USIM application

SUCIException - with the following reason codes:

• SUCIException.NOT_REGISTERED if the SUCICalculator is not registered for the indicated USIM. The SUCICalculator registered object, if any, will stay registered.

deregisterSUCICalculator

public static void deregisterSUCICalculator(SUCICalculator calc)

Deregister an instance of an object that implements SUCICalculator interface from the USIM application.

Parameters:

calc - object that implements SUCICalculator that is registered and should be deregistered

Throws:

NullPointerException - if calc is null

SUCIException - with the following reason codes:

• SUCIException.NO_USIM if there is no USIM available.
• SUCIException.NOT_REGISTERED if the SUCICalculator is not registered to the indicated USIM. The SUCICalculator registered object, if any, will stay registered.