Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep

javax.crypto
Class ExemptionMechanism  view ExemptionMechanism download ExemptionMechanism.java

java.lang.Object
  extended byjavax.crypto.ExemptionMechanism

public class ExemptionMechanism
extends java.lang.Object

An exemption mechanism, which will conditionally allow cryptography where it is not normally allowed, implements things such as key recovery, key weakening, or key escrow.

Implementation note: this class is present for API-compatibility only; it is not actually used anywhere in this library and this library does not, in general, support crypto weakening.

Since:
1.4

Field Summary
private  ExemptionMechanismSpi emSpi
           
private  java.lang.String mechanism
           
private  java.security.Provider provider
           
private static java.lang.String SERVICE
           
private  boolean virgin
           
 
Constructor Summary
protected ExemptionMechanism(ExemptionMechanismSpi emSpi, java.security.Provider provider, java.lang.String mechanism)
           
 
Method Summary
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.
 byte[] genExemptionBlob()
           
 int genExemptionBlob(byte[] output)
           
 int genExemptionBlob(byte[] output, int outputOffset)
           
static ExemptionMechanism getInstance(java.lang.String mechanism)
           
static ExemptionMechanism getInstance(java.lang.String mechanism, java.security.Provider provider)
           
static ExemptionMechanism getInstance(java.lang.String mechanism, java.lang.String provider)
           
 java.lang.String getName()
           
 int getOutputSize(int inputLength)
           
 java.security.Provider getProvider()
           
 void init(java.security.Key key)
           
 void init(java.security.Key key, java.security.AlgorithmParameters params)
           
 void init(java.security.Key key, java.security.spec.AlgorithmParameterSpec params)
           
 boolean isCryptoAllowed(java.security.Key key)
           
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

SERVICE

private static final java.lang.String SERVICE
See Also:
Constant Field Values

emSpi

private ExemptionMechanismSpi emSpi

provider

private java.security.Provider provider

mechanism

private java.lang.String mechanism

virgin

private boolean virgin
Constructor Detail

ExemptionMechanism

protected ExemptionMechanism(ExemptionMechanismSpi emSpi,
                             java.security.Provider provider,
                             java.lang.String mechanism)
Method Detail

getInstance

public static final ExemptionMechanism getInstance(java.lang.String mechanism)
                                            throws java.security.NoSuchAlgorithmException

getInstance

public static final ExemptionMechanism getInstance(java.lang.String mechanism,
                                                   java.lang.String provider)
                                            throws java.security.NoSuchAlgorithmException,
                                                   java.security.NoSuchProviderException

getInstance

public static final ExemptionMechanism getInstance(java.lang.String mechanism,
                                                   java.security.Provider provider)
                                            throws java.security.NoSuchAlgorithmException

genExemptionBlob

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

genExemptionBlob

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

genExemptionBlob

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

getName

public final java.lang.String getName()

getOutputSize

public final int getOutputSize(int inputLength)
                        throws java.lang.IllegalStateException

getProvider

public final java.security.Provider getProvider()

init

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

init

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

init

public final void init(java.security.Key key,
                       java.security.spec.AlgorithmParameterSpec params)
                throws ExemptionMechanismException,
                       java.security.InvalidAlgorithmParameterException,
                       java.security.InvalidKeyException

isCryptoAllowed

public final boolean isCryptoAllowed(java.security.Key key)
                              throws ExemptionMechanismException

finalize

protected void finalize()
Description copied from class: java.lang.Object
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 java.lang.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.