iaik.pkcs.pkcs11.provider

Class TokenKeyStoreFastSpi

java.lang.Object

java.security.KeyStoreSpi

iaik.pkcs.pkcs11.provider.TokenKeyStoreSpi

iaik.pkcs.pkcs11.provider.TokenKeyStoreFastSpi

All Implemented Interfaces:

PKCS11EngineClass

public class TokenKeyStoreFastSpi
extends TokenKeyStoreSpi

An adapter class to gain the possibility to instantiate an object that is an instance of KeyStore. This KeyStore implementation extends class TokenKeyStoreSpi and overwrites the method engineLoad and ensureCurrentTables() to achieve better performance. This is done by leaving out the checking for any external token changes, which is done in every KeyStore method when using TokenKeyStoreSpi. The FastPKCS11KeyStore can be instantiated with KeyStore.getInstance("FastPKCS11KeyStore"); or KeyStore.getInstance("FastPKCS11"); It can be used when the PKCS#11 token is not removed or changed and if no token entries are added, changed or removed with external tools. The FastPKCS11KeyStore can also be used, if the moment of external changes is known and the KeyStore is then manually updated by using tokenKeyStore.updateKeyStore().

Field Summary

Fields inherited from class iaik.pkcs.pkcs11.provider.TokenKeyStoreSpi

aliases_, certificateChainAliasToPkcs11ObjectsTable_, certificateChains_, infoOfRecentToken_, isUpToDate_, KEY_STORE_TYPE, keyAliasToPkcs11ObjectTable_, keys_, lastNewID_, readSession_, supportProviderName_, tokenManager_, trustedCertificateAliasToPkcs11ObjectTable_, trustedCertificates_, usedMechanismInfos_, usedMechanisms_, userPIN_, useUserSession_, writeSession_

Constructor Summary

Constructors

Constructor and Description
TokenKeyStoreFastSpi()
TokenKeyStoreFastSpi(TokenManager tokenManager)

Method Summary

Modifier and Type	Method and Description
void	engineLoad(java.io.InputStream in, char[] password) Loads and initializes this key store.
protected void	ensureCurrentTables() Overwrites ensureCurrentTables() of TokenKeyStoreSpi in order to do no updating.

Methods inherited from class iaik.pkcs.pkcs11.provider.TokenKeyStoreSpi

clearTables, contains, createCertificate, createCertificateChain, createKeyCreationTemplate, createKeySpec, createPrivateKeySpec, createPublicKeySpec, createSecretKeySpec, createUniqueAlias, deleteCertificate, deleteChertificateChain, deleteKey, engineAliases, engineContainsAlias, engineDeleteEntry, engineGetCertificate, engineGetCertificateAlias, engineGetCertificateChain, engineGetCreationDate, engineGetKey, engineIsCertificateEntry, engineIsKeyEntry, engineSetCertificateEntry, engineSetKeyEntry, engineSetKeyEntry, engineSize, engineStore, ensureReadSession, ensureSupportProvider, ensureWriteSession, finalize, findCoreespondingKey, findKeysAndCertificateTables, generateNewID, getMechanismFeaturesSupport, getReadProtectedKeyOnDemand, getTokenManager, initialize, isEndUserCertificate, isSupportedBy, isUpToDate, loginSession, logoutSession, openReadSession, openWriteSession, readProviderName, releaseSessions, setKeyAttributes, setKeyAttributes, setReadProtectedKeyOnDemand, setUpToDate, tokenChanged, updateTables, writeProviderName

Methods inherited from class java.security.KeyStoreSpi

engineEntryInstanceOf, engineGetEntry, engineLoad, engineSetEntry, engineStore

Methods inherited from class java.lang.Object

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

Constructor Detail

TokenKeyStoreFastSpi

public TokenKeyStoreFastSpi()

TokenKeyStoreFastSpi

public TokenKeyStoreFastSpi(TokenManager tokenManager)

Method Detail

engineLoad

public void engineLoad(java.io.InputStream in,
                       char[] password)
                throws java.io.IOException,
                       java.lang.UnsupportedOperationException

Loads and initializes this key store. The user PIN may be provided as the password. If the application provides the PIN like this, the keystore will not prompt the password by other means. Please note that the keystore will keep a reference to the password object if it is provided.

Overrides:

engineLoad in class TokenKeyStoreSpi

Parameters:

in - The stream to load from.

password - The user PIN (or password) for the token.

Throws:

java.io.IOException - If the keystore cannot be loaded.

java.lang.UnsupportedOperationException - If getting the provider instance fails.

See Also:

KeyStoreSpi.engineLoad(InputStream,char[])

ensureCurrentTables

protected void ensureCurrentTables()
                            throws IAIKPkcs11Exception

Overwrites ensureCurrentTables() of TokenKeyStoreSpi in order to do no updating. This method does nothing.

Overrides:

ensureCurrentTables in class TokenKeyStoreSpi

Throws:

IAIKPkcs11Exception - If the update fails.