uicc.scws
Class ScwsExtensionRegistry

java.lang.Object
  uicc.scws.ScwsExtensionRegistry

public class ScwsExtensionRegistry
extends java.lang.Object

Registry which handles the registration and deregistration of applications and their associated callback objects to the SCWS.

Method Summary

static void	deregister(ScwsExtension scwsExtension) Deregisters a ScwsExtension from the Smart Card Webserver.
static void	register(ScwsExtension scwsExtension, byte[] appId, short offset, short length) Registers an ScwsExtension with the given name to the SCWS.

Methods inherited from class java.lang.Object

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

Method Detail

register

public static void register(ScwsExtension scwsExtension,
                            byte[] appId,
                            short offset,
                            short length)
                     throws ScwsException,
                            java.lang.NullPointerException,
                            java.lang.ArrayIndexOutOfBoundsException

Registers an ScwsExtension with the given name to the SCWS. The application has to provide an object which is responsible for handling the HTTP requests.

Parameters:

scwsExtension - the object handling the HTTP requests

appId - the name of the application

offset - the offset to the name

length - the length of the name

Throws:

java.lang.NullPointerException - if scwsExtension or appID is equal to null.

java.lang.ArrayIndexOutOfBoundsException - if offset or length or both would cause access outside of the array bounds, or if length is negative

ScwsException - with reason SCWSEXTENSION_REGISTRY_ERRORif the appId is already registered

deregister

public static void deregister(ScwsExtension scwsExtension)
                       throws ScwsException,
                              java.lang.NullPointerException,
                              java.lang.SecurityException

Deregisters a ScwsExtension from the Smart Card Webserver.

Parameters:

scwsExtension - the extension to deregister

Throws:

java.lang.NullPointerException - if scwsExtension is equal to null

ScwsException - with reason SCWSEXTENSION_REGISTRY_ERROR if the scwsExtension has not been registered before

java.lang.SecurityException - if the caller has not the same JCRE context than the one that was used to register the application.