|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface DSAKeyPairGenerator
An interface to an object capable of generating DSA key pairs.
The initialize
methods may each be called any number
of times. If no initialize
method is called on a
DSAKeyPairGenerator, the default is to generate 1024-bit keys, using
precomputed p, q and g parameters and an instance of SecureRandom as
the random bit source.
Users wishing to indicate DSA-specific parameters, and to generate a key pair suitable for use with the DSA algorithm typically
getInstance
method with "DSA"
as its argument.
initialize
methods from this DSAKeyPairGenerator interface.
generateKeyPair
method from the KeyPairGenerator class.
Note: it is not always necessary to do do algorithm-specific
initialization for a DSA key pair generator. That is, it is not always
necessary to call an initialize
method in this interface.
Algorithm-independent initialization using the initialize
method
in the KeyPairGenerator
interface is all that is needed when you accept defaults for algorithm-specific
parameters.
KeyPairGenerator
Method Summary | |
---|---|
void |
initialize(DSAParams params,
SecureRandom random)
Initializes the key pair generator using the DSA family parameters (p,q and g) and an optional SecureRandom bit source. |
void |
initialize(int modlen,
boolean genParams,
SecureRandom random)
Initializes the key pair generator for a given modulus length (instead of parameters), and an optional SecureRandom bit source. |
Method Detail |
---|
void initialize(DSAParams params, SecureRandom random) throws InvalidParameterException
params
- the parameters to use to generate the keys.random
- the random bit source to use to generate key bits;
can be null.
InvalidParameterException
- if the params
value is invalid or null.void initialize(int modlen, boolean genParams, SecureRandom random) throws InvalidParameterException
If genParams
is true, this method generates new
p, q and g parameters. If it is false, the method uses precomputed
parameters for the modulus length requested. If there are no
precomputed parameters for that modulus length, an exception will be
thrown. It is guaranteed that there will always be
default parameters for modulus lengths of 512 and 1024 bits.
modlen
- the modulus length in bits. Valid values are any
multiple of 8 between 512 and 1024, inclusive.random
- the random bit source to use to generate key bits;
can be null.genParams
- whether or not to generate new parameters for
the modulus length requested.
InvalidParameterException
- if modlen
is not
between 512 and 1024, or if genParams
is false and
there are no precomputed parameters for the requested modulus
length.
|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 1993, 2010, Oracle and/or its affiliates. All rights reserved.