jdk/src/java.base/share/classes/javax/crypto/KeyGenerator.java
changeset 45118 e4258d800b54
parent 42780 7781326fff20
child 45435 7a91c865edd4
equal deleted inserted replaced
45117:7470e726740b 45118:e4258d800b54
     1 /*
     1 /*
     2  * Copyright (c) 1997, 2016, Oracle and/or its affiliates. All rights reserved.
     2  * Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     4  *
     4  *
     5  * This code is free software; you can redistribute it and/or modify it
     5  * This code is free software; you can redistribute it and/or modify it
     6  * under the terms of the GNU General Public License version 2 only, as
     6  * under the terms of the GNU General Public License version 2 only, as
     7  * published by the Free Software Foundation.  Oracle designates this
     7  * published by the Free Software Foundation.  Oracle designates this
    93  * <li>{@code DESede} (168)</li>
    93  * <li>{@code DESede} (168)</li>
    94  * <li>{@code HmacSHA1}</li>
    94  * <li>{@code HmacSHA1}</li>
    95  * <li>{@code HmacSHA256}</li>
    95  * <li>{@code HmacSHA256}</li>
    96  * </ul>
    96  * </ul>
    97  * These algorithms are described in the <a href=
    97  * These algorithms are described in the <a href=
    98  * "{@docRoot}/../technotes/guides/security/StandardNames.html#KeyGenerator">
    98  * "{@docRoot}/../specs/security/standard-names.html#keygenerator-algorithms">
    99  * KeyGenerator section</a> of the
    99  * KeyGenerator section</a> of the
   100  * Java Cryptography Architecture Standard Algorithm Name Documentation.
   100  * Java Security Standard Algorithm Names Specification.
   101  * Consult the release documentation for your implementation to see if any
   101  * Consult the release documentation for your implementation to see if any
   102  * other algorithms are supported.
   102  * other algorithms are supported.
   103  *
   103  *
   104  * @author Jan Luehe
   104  * @author Jan Luehe
   105  *
   105  *
   214      * may be different than the order of providers returned by
   214      * may be different than the order of providers returned by
   215      * {@link Security#getProviders() Security.getProviders()}.
   215      * {@link Security#getProviders() Security.getProviders()}.
   216      *
   216      *
   217      * @param algorithm the standard name of the requested key algorithm.
   217      * @param algorithm the standard name of the requested key algorithm.
   218      * See the KeyGenerator section in the <a href=
   218      * See the KeyGenerator section in the <a href=
   219      * "{@docRoot}/../technotes/guides/security/StandardNames.html#KeyGenerator">
   219      * "{@docRoot}/../specs/security/standard-names.html#keygenerator-algorithms">
   220      * Java Cryptography Architecture Standard Algorithm Name Documentation</a>
   220      * Java Security Standard Algorithm Names Specification</a>
   221      * for information about standard algorithm names.
   221      * for information about standard algorithm names.
   222      *
   222      *
   223      * @return the new {@code KeyGenerator} object
   223      * @return the new {@code KeyGenerator} object
   224      *
   224      *
   225      * @throws NoSuchAlgorithmException if no {@code Provider} supports a
   225      * @throws NoSuchAlgorithmException if no {@code Provider} supports a
   248      * <p> Note that the list of registered providers may be retrieved via
   248      * <p> Note that the list of registered providers may be retrieved via
   249      * the {@link Security#getProviders() Security.getProviders()} method.
   249      * the {@link Security#getProviders() Security.getProviders()} method.
   250      *
   250      *
   251      * @param algorithm the standard name of the requested key algorithm.
   251      * @param algorithm the standard name of the requested key algorithm.
   252      * See the KeyGenerator section in the <a href=
   252      * See the KeyGenerator section in the <a href=
   253      * "{@docRoot}/../technotes/guides/security/StandardNames.html#KeyGenerator">
   253      * "{@docRoot}/../specs/security/standard-names.html#keygenerator-algorithms">
   254      * Java Cryptography Architecture Standard Algorithm Name Documentation</a>
   254      * Java Security Standard Algorithm Names Specification</a>
   255      * for information about standard algorithm names.
   255      * for information about standard algorithm names.
   256      *
   256      *
   257      * @param provider the name of the provider.
   257      * @param provider the name of the provider.
   258      *
   258      *
   259      * @return the new {@code KeyGenerator} object
   259      * @return the new {@code KeyGenerator} object
   291      * object is returned.  Note that the specified Provider object
   291      * object is returned.  Note that the specified Provider object
   292      * does not have to be registered in the provider list.
   292      * does not have to be registered in the provider list.
   293      *
   293      *
   294      * @param algorithm the standard name of the requested key algorithm.
   294      * @param algorithm the standard name of the requested key algorithm.
   295      * See the KeyGenerator section in the <a href=
   295      * See the KeyGenerator section in the <a href=
   296      * "{@docRoot}/../technotes/guides/security/StandardNames.html#KeyGenerator">
   296      * "{@docRoot}/../specs/security/standard-names.html#keygenerator-algorithms">
   297      * Java Cryptography Architecture Standard Algorithm Name Documentation</a>
   297      * Java Security Standard Algorithm Names Specification</a>
   298      * for information about standard algorithm names.
   298      * for information about standard algorithm names.
   299      *
   299      *
   300      * @param provider the provider.
   300      * @param provider the provider.
   301      *
   301      *
   302      * @return the new {@code KeyGenerator} object
   302      * @return the new {@code KeyGenerator} object