java/security/KeyPairGenerator.java

44  * <p>A Key pair generator for a particular algorithm creates a public/private
45  * key pair that can be used with this algorithm. It also associates
46  * algorithm-specific parameters with each of the generated keys.
48  * <p>There are two ways to generate a key pair: in an algorithm-independent
49  * manner, and in an algorithm-specific manner.
56  * algorithms (e.g., in the case of the <i>DSA</i> algorithm, the keysize
69  * algorithm-independent {@code initialize} methods, it is up to the
70  * provider what to do about the algorithm-specific parameters (if any) to be
73  * <p>If the algorithm is the <i>DSA</i> algorithm, and the keysize (modulus
83  * <p>For situations where a set of algorithm-specific parameters already
142     private final String algorithm;
148      * Creates a KeyPairGenerator object for the specified algorithm.
150      * @param algorithm the standard string name of the algorithm.
154      * for information about standard algorithm names.
156     protected KeyPairGenerator(String algorithm) {
157         this.algorithm = algorithm;
161      * Returns the standard name of the algorithm for this key pair generator.
165      * for information about standard algorithm names.
167      * @return the standard string name of the algorithm.
170         return this.algorithm;
174             String algorithm) {
180             kpg = new Delegate(spi, algorithm);
185             pdebug.println("KeyPairGenerator." + algorithm +
186                 " algorithm from: " + kpg.provider.getName());
194      * key pairs for the specified algorithm.
200      * Provider that supports the specified algorithm is returned.
209      * the preferred provider order for the specified algorithm. This
213      * @param algorithm the standard string name of the algorithm.
217      * for information about standard algorithm names.
223      *         specified algorithm
225      * @throws NullPointerException if {@code algorithm} is {@code null}
229     public static KeyPairGenerator getInstance(String algorithm)
231         Objects.requireNonNull(algorithm, "null algorithm name");
233                 GetInstance.getServices("KeyPairGenerator", algorithm);
237                 (algorithm + " KeyPairGenerator not available");
247                     return getInstance(instance, algorithm);
249                     return new Delegate(instance, t, algorithm);
262      * key pairs for the specified algorithm.
272      * @param algorithm the standard string name of the algorithm.
276      * for information about standard algorithm names.
286      *         implementation for the specified algorithm is not
292      * @throws NullPointerException if {@code algorithm} is {@code null}
296     public static KeyPairGenerator getInstance(String algorithm,
299         Objects.requireNonNull(algorithm, "null algorithm name");
301                 KeyPairGeneratorSpi.class, algorithm, provider);
302         return getInstance(instance, algorithm);
307      * key pairs for the specified algorithm.
314      * @param algorithm the standard string name of the algorithm.
318      * for information about standard algorithm names.
328      *         implementation for the specified algorithm is not available
331      * @throws NullPointerException if {@code algorithm} is {@code null}
337     public static KeyPairGenerator getInstance(String algorithm,
339         Objects.requireNonNull(algorithm, "null algorithm name");
341                 KeyPairGeneratorSpi.class, algorithm, provider);
342         return getInstance(instance, algorithm);
369      * algorithm-specific metric, such as modulus length, specified in
384      * algorithm-specific metric, such as modulus length, specified in
483      * (algorithm-specific) values of the generated keys.
503      * (algorithm-specific) values of the generated keys.
560     //    . getInstance(algorithm, provider) was used
585         Delegate(KeyPairGeneratorSpi spi, String algorithm) {
586             super(algorithm);
591                 String algorithm) {
592             super(algorithm);
599                 pdebug.println("KeyPairGenerator." + algorithm +
600                     " algorithm from: " + provider.getName());