org.simalliance.openmobileapi

Class Provider

java.lang.Object

org.simalliance.openmobileapi.Provider

Direct Known Subclasses:

AuthenticationProvider, FileViewProvider, PKCS15Provider, SecureStorageProvider

public abstract class Provider
extends java.lang.Object

This Provider abstract class is the base class for all service layer classes. Each service layer class provides a set of methods for a certain aspect (file management, PIN authentication, PKCS#15 structure handling, ...) and acts as a provider for service routines. All Provider classes need an opened channel for the SE communication. Hence before a certain Provider class can be used for SE operations the channel has to be consigned. For performing different operations (PIN authentication, file operation, ...) the Provider classes can be easily combined by using the same channel for different Provider classes and calling alternately methods of these different providers. It has to be considered that each provider class needs a counterpart on SE side (e.g. an Applet with a standardised APDU interface as required by the Provider class). The application using a Provider class for SE interactions is in charge of assigning a channel to the Provider where the Provider's SE counterpart Applet is already preselected.

Constructor Summary

Constructors

Constructor and Description
Provider(Channel channel) Encapsulates the defined channel by a Provider object that can be used for performing a service operations on it.

Method Summary

Methods

Modifier and Type	Method and Description
Channel	getChannel() Returns the channel that is used by this provider.

Methods inherited from class java.lang.Object

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

Constructor Detail

Provider

public Provider(Channel channel)
         throws java.lang.IllegalStateException

Encapsulates the defined channel by a Provider object that can be used for performing a service operations on it. This constructor has to be called by derived Provider classes during the instantiation.

Parameters:

channel - The channel that shall be used by this Provider for service operations.

Throws:

java.lang.IllegalStateException - if the used channel is closed.

Method Detail

getChannel

public Channel getChannel()

Returns the channel that is used by this provider. This returned channel can also be used by other providers.

Returns:

The channel instance that is used by this provider.