org.dihedron.crypto.providers.smartcard

Class SmartCardProviderFactory

java.lang.Object

org.dihedron.crypto.providers.ProviderFactory<SmartCardTraits>

org.dihedron.crypto.providers.smartcard.SmartCardProviderFactory

public class SmartCardProviderFactory
extends ProviderFactory<SmartCardTraits>

Smart card securoty provider factory class: helps install a security provider for PKCS#11 providers, once the reader in which the PKCS#11 token is available has been detected and information about the smart card (in the form of a SmartCard database entry) has been retrieved.

Author:

Andrea Funto'

Constructor Summary

Constructors

Constructor and Description
SmartCardProviderFactory()

Method Summary

Methods

Modifier and Type	Method and Description
Provider	acquire(SmartCardTraits traits) Installs a new PKCS#11 security provider supporting the smart card model and make specified in the initialisation traits, which must provide a reference to the smart card reader in which the card is present and to the database entry corresponding to the card's model.
void	release(Provider provider) Uninstalls the given provider; smart cards instantiate a new provider for each different smart card, in order to support multiple initialisation parameters, and these custom providers need to be uninstalled once one is done using them.

Methods inherited from class java.lang.Object

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

Constructor Detail

SmartCardProviderFactory

public SmartCardProviderFactory()

Method Detail

acquire

public Provider acquire(SmartCardTraits traits)
                 throws ProviderException

Installs a new PKCS#11 security provider supporting the smart card model and make specified in the initialisation traits, which must provide a reference to the smart card reader in which the card is present and to the database entry corresponding to the card's model.

Specified by:

acquire in class ProviderFactory<SmartCardTraits>

Parameters:

traits - the characteristics traits of the smart card whose capabilities the provider will expose.

Returns:

the new Provider, or null if none valid could be installed.

Throws:

SmartCardException

UnavailableDriverException

ProviderException

release

public void release(Provider provider)

Uninstalls the given provider; smart cards instantiate a new provider for each different smart card, in order to support multiple initialisation parameters, and these custom providers need to be uninstalled once one is done using them.

Overrides:

release in class ProviderFactory<SmartCardTraits>

Parameters:

provider - the provider to uninstall.