javax.crypto
Class ExemptionMechanismSpi
- java.lang.Object
javax.crypto.ExemptionMechanismSpi
- public abstract class ExemptionMechanismSpi
- extends java.lang.Object
ExemptionMechanism
class.
All the abstract methods in this class must be implemented by each
cryptographic service provider who wishes to supply the implementation
of a particular exemption mechanism.
Constructor Summary
Constructor and Description |
---|
ExemptionMechanismSpi()
|
Method Summary
Modifier and Type | Method and Description |
---|---|
|
engineGenExemptionBlob()
Generates the exemption mechanism key blob.
|
|
engineGenExemptionBlob(byte[] output,int outputOffset)
Generates the exemption mechanism key blob, and stores the result in
the
output buffer, starting at outputOffset
inclusive.
|
|
engineGetOutputSize(int inputLen)
Returns the length in bytes that an output buffer would need to be in
order to hold the result of the next
engineGenExemptionBlob operation, given the input length inputLen (in bytes).
|
|
engineInit(java.security.Key key)
Initializes this exemption mechanism with a key.
|
|
engineInit(java.security.Key key,java.security.AlgorithmParameters params)
Initializes this exemption mechanism with a key and a set of algorithm
parameters.
|
|
engineInit(java.security.Key key,java.security.spec.AlgorithmParameterSpec params)
Initializes this exemption mechanism with a key and a set of algorithm
parameters.
|
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail
ExemptionMechanismSpi
- public ExemptionMechanismSpi()
Method Detail
engineGetOutputSize
- protected abstract int engineGetOutputSize( int inputLen)
inputLen
- the input length (in bytes) engineInit
- protected abstract void engineInit( java.security.Key key)
- throws java.security.InvalidKeyException
- ExemptionMechanismException
If this exemption mechanism requires any algorithm parameters
that cannot be derived from the given key
, the underlying
exemption mechanism implementation is supposed to generate the required
parameters itself (using provider-specific default values); in the case
that algorithm parameters must be specified by the caller, an
InvalidKeyException
is raised.
key
- the key for this exemption mechanism java.security.InvalidKeyException
- if the given key is inappropriate for
this exemption mechanism. ExemptionMechanismException
- if problem(s) encountered in the
process of initializing. engineInit
- protected abstract void engineInit( java.security.Key key,
- java.security.spec.AlgorithmParameterSpec params)
- throws java.security.InvalidKeyException
- java.security.InvalidAlgorithmParameterException
- ExemptionMechanismException
If this exemption mechanism requires any algorithm parameters and
params
is null, the underlying exemption mechanism
implementation is supposed to generate the required parameters
itself (using provider-specific default values); in the case that
algorithm parameters must be specified by the caller, an
InvalidAlgorithmParameterException
is raised.
key
- the key for this exemption mechanism params
- the algorithm parameters java.security.InvalidKeyException
- if the given key is inappropriate for
this exemption mechanism. java.security.InvalidAlgorithmParameterException
- if the given algorithm
parameters are inappropriate for this exemption mechanism. ExemptionMechanismException
- if problem(s) encountered in the
process of initializing. engineInit
- protected abstract void engineInit( java.security.Key key,
- java.security.AlgorithmParameters params)
- throws java.security.InvalidKeyException
- java.security.InvalidAlgorithmParameterException
- ExemptionMechanismException
If this exemption mechanism requires any algorithm parameters
and params
is null, the underlying exemption mechanism
implementation is supposed to generate the required parameters
itself (using provider-specific default values); in the case that
algorithm parameters must be specified by the caller, an
InvalidAlgorithmParameterException
is raised.
key
- the key for this exemption mechanism params
- the algorithm parameters java.security.InvalidKeyException
- if the given key is inappropriate for
this exemption mechanism. java.security.InvalidAlgorithmParameterException
- if the given algorithm
parameters are inappropriate for this exemption mechanism. ExemptionMechanismException
- if problem(s) encountered in the
process of initializing. engineGenExemptionBlob
- protected abstract byte[] engineGenExemptionBlob( )
- throws ExemptionMechanismException
ExemptionMechanismException
- if problem(s) encountered in the
process of generating. engineGenExemptionBlob
- protected abstract int engineGenExemptionBlob( byte[] output,
- int outputOffset)
- throws ShortBufferException
- ExemptionMechanismException
output
buffer, starting at outputOffset
inclusive.
If the output
buffer is too small to hold the result,
a ShortBufferException
is thrown. In this case, repeat this
call with a larger output buffer. Use
engineGetOutputSize
to determine
how big the output buffer should be.
output
- the buffer for the result outputOffset
- the offset in output
where the result
is stored output
ShortBufferException
- if the given output buffer is too small
to hold the result. ExemptionMechanismException
- if problem(s) encountered in the
process of generating.
engineGenExemptionBlob
operation, given the input lengthinputLen
(in bytes).The actual output length of the next
engineGenExemptionBlob
call may be smaller than the length returned by this method.