Class PKCS11Provider

java/src/org/opensc/pkcs11/PKCS11Provider.java:55–358

The PKCS#11 provider of the OpenSC project. This provider is based on the RSA Security Inc. PKCS#11 Cryptographic Token Interface (Cryptoki) . @author wglas

 * @author wglas
 */
public class PKCS11Provider extends Provider implements DestroyableParent
{
	static private final Log log = LogFactory.getLog(PKCS11Provider.class);

	/**
	 * To be changed, when the interface changes.
	 */
	private static final long serialVersionUID = -2568219416560640437L;

	/* This value has to correspond to the value of version in build.xml */
	private static final double version = 0.2;
	/* This value has to correspond to the value of patchlevel in build.xml */
	private static final double patchlevel = 0;
	
	static {
		System.loadLibrary("opensc-PKCS11-"+version); 
	} 
	 
	 private long pkcs11ModuleHandle;
	 private ShutdownThread shutdownThread;
	 private DestroyableHolder destroyableHolder;

	 private native long loadNativePKCS11Module(String filename) throws PKCS11Exception;
	 private native void unloadPKCS11Module(long handle) throws PKCS11Exception;
	
	 /* (non-Javadoc)
	 * @see java.lang.Object#finalize()
	 */
	@Override
	protected void finalize() throws Throwable
	{
		cleanup();
		super.finalize();
	}
	
	/**
	 * Additional function, which may e used by application to cleanup all
	 * allocated C resources of the underlying JNI plugin.
	 */
	public synchronized void cleanup()
	{
		if (this.pkcs11ModuleHandle != 0L)
		{
			try
			{
                this.destroyableHolder.destroy();
			} catch (DestroyFailedException e)
			{
				log.error("Failure during destruction of C resources:",e);
			}
			
			try
			{
				unloadPKCS11Module(this.pkcs11ModuleHandle);
			} catch (PKCS11Exception e)
			{
				log.error("Failure unloading PKCS#11 module:",e);
			}