Class ExemptionMechanism

protected ExemptionMechanism(ExemptionMechanismSpi emSpi,
                             Provider provider,
                             String mechanism)

protected void finalize()

Called on an object by the Virtual Machine at most once, at some point after the Object is determined unreachable but before it is destroyed. You would think that this means it eventually is called on every Object, but this is not necessarily the case. If execution terminates abnormally, garbage collection does not always happen. Thus you cannot rely on this method to always work. For finer control over garbage collection, use references from the java.lang.ref package.

Virtual Machines are free to not call this method if they can determine that it does nothing important; for example, if your class extends Object and overrides finalize to do simply super.finalize().

finalize() will be called by a Thread that has no locks on any Objects, and may be called concurrently. There are no guarantees on the order in which multiple objects are finalized. This means that finalize() is usually unsuited for performing actions that must be thread-safe, and that your implementation must be use defensive programming if it is to always work.

If an Exception is thrown from finalize() during garbage collection, it will be patently ignored and the Object will still be destroyed.

It is allowed, although not typical, for user code to call finalize() directly. User invocation does not affect whether automatic invocation will occur. It is also permitted, although not recommended, for a finalize() method to "revive" an object by making it reachable from normal code again.

Unlike constructors, finalize() does not get called for an object's superclass unless the implementation specifically calls super.finalize().

The default implementation does nothing.

Overrides:

finalize in interface Object

See Also:

System.gc(), System.runFinalizersOnExit(boolean), java.lang.ref

public final byte[] genExemptionBlob()
            throws IllegalStateException,
                   ExemptionMechanismException

public final int genExemptionBlob(byte[] output)
            throws IllegalStateException,
                   ExemptionMechanismException,
                   ShortBufferException

public final int genExemptionBlob(byte[] output,
                                  int outputOffset)
            throws IllegalStateException,
                   ExemptionMechanismException,
                   ShortBufferException

public static final ExemptionMechanism getInstance(String mechanism)
            throws NoSuchAlgorithmException

Create an instance of ExemptionMechanism for a designated mechanism from the first Security Provider offering it.

Parameters:

mechanism - the name of the exemption mechanism to create.

Returns:

a newly created instance of ExemptionMechanism.

Throws:

IllegalArgumentException - if the provider is null.

NoSuchAlgorithmException - if no such exemption mechanism is available from any known Security Provider.

IllegalArgumentException - if mechanism is null or is an empty string.

public static final ExemptionMechanism getInstance(String mechanism,
                                                   String provider)
            throws NoSuchAlgorithmException,
                   NoSuchProviderException

Create an instance of ExemptionMechanism for a designated mechanism from a named provider.

Parameters:

mechanism - the name of the exemption mechanism to create.

provider - the security provider to provide the exemption mechanism.

Returns:

a newly created instance of ExemptionMechanism.

Throws:

NoSuchAlgorithmException - if no such exemption mechanism is available from the named provider.

NoSuchProviderException - if no Security Provider with the designated name is known to the underlying JVM.

IllegalArgumentException - if either mechanism or provider is null, or if mechanism is an empty string.

public static final ExemptionMechanism getInstance(String mechanism,
                                                   Provider provider)
            throws NoSuchAlgorithmException

Create an instance of ExemptionMechanism for a designated mechanism from a designated provider.

Parameters:

mechanism - the name of the exemption mechanism to create.

provider - the security provider to provide the exemption mechanism.

Returns:

a newly created instance of ExemptionMechanism.

Throws:

NoSuchAlgorithmException - if an exemption mechanism could not be created.

IllegalArgumentException - if either mechanism or provider is null, or if mechanism is an empty string.

public final String getName()

public final int getOutputSize(int inputLength)
            throws IllegalStateException

public final Provider getProvider()

public final void init(Key key)
            throws ExemptionMechanismException,
                   InvalidKeyException

public final void init(Key key,
                       AlgorithmParameters params)
            throws ExemptionMechanismException,
                   InvalidAlgorithmParameterException,
                   InvalidKeyException

public final void init(Key key,
                       AlgorithmParameterSpec params)
            throws ExemptionMechanismException,
                   InvalidAlgorithmParameterException,
                   InvalidKeyException

public final boolean isCryptoAllowed(Key key)
            throws ExemptionMechanismException