--- old/src/java.base/share/classes/javax/crypto/SecretKeyFactory.java 2015-08-18 14:21:04.453018810 +0400 +++ new/src/java.base/share/classes/javax/crypto/SecretKeyFactory.java 2015-08-18 14:21:04.245018820 +0400 @@ -38,7 +38,7 @@ * This class represents a factory for secret keys. * *
Key factories are used to convert keys (opaque
- * cryptographic keys of type Key
) into key specifications
+ * cryptographic keys of type {@code Key}) into key specifications
* (transparent representations of the underlying key material), and vice
* versa.
* Secret key factories operate only on secret (symmetric) keys.
@@ -53,16 +53,16 @@
* {@link #getKeySpec(javax.crypto.SecretKey, java.lang.Class) getKeySpec}
* methods.
* For example, the DES secret-key factory supplied by the "SunJCE" provider
- * supports DESKeySpec
as a transparent representation of DES
+ * supports {@code DESKeySpec} as a transparent representation of DES
* keys, and that provider's secret-key factory for Triple DES keys supports
- * DESedeKeySpec
as a transparent representation of Triple DES
+ * {@code DESedeKeySpec} as a transparent representation of Triple DES
* keys.
*
*
Every implementation of the Java platform is required to support the
- * following standard SecretKeyFactory
algorithms:
+ * following standard {@code SecretKeyFactory} algorithms:
*
SecretKeyFactory
object that converts
+ * Returns a {@code SecretKeyFactory} object that converts
* secret keys of the specified algorithm.
*
* This method traverses the list of registered security Providers, @@ -144,7 +144,7 @@ * Java Cryptography Architecture Standard Algorithm Name Documentation
* for information about standard algorithm names. * - * @return the newSecretKeyFactory
object.
+ * @return the new {@code SecretKeyFactory} object.
*
* @exception NullPointerException if the specified algorithm
* is null.
@@ -161,7 +161,7 @@
}
/**
- * Returns a SecretKeyFactory
object that converts
+ * Returns a {@code SecretKeyFactory} object that converts
* secret keys of the specified algorithm.
*
* A new SecretKeyFactory object encapsulating the
@@ -181,7 +181,7 @@
*
* @param provider the name of the provider.
*
- * @return the new SecretKeyFactory
object.
+ * @return the new {@code SecretKeyFactory} object.
*
* @exception NoSuchAlgorithmException if a SecretKeyFactorySpi
* implementation for the specified algorithm is not
@@ -193,7 +193,7 @@
* @throws NoSuchProviderException if the specified provider is not
* registered in the security provider list.
*
- * @exception IllegalArgumentException if the provider
+ * @exception IllegalArgumentException if the {@code provider}
* is null or empty.
*
* @see java.security.Provider
@@ -208,7 +208,7 @@
}
/**
- * Returns a SecretKeyFactory
object that converts
+ * Returns a {@code SecretKeyFactory} object that converts
* secret keys of the specified algorithm.
*
*
A new SecretKeyFactory object encapsulating the
@@ -225,7 +225,7 @@
*
* @param provider the provider.
*
- * @return the new SecretKeyFactory
object.
+ * @return the new {@code SecretKeyFactory} object.
*
* @exception NullPointerException if the specified algorithm
* is null.
@@ -234,7 +234,7 @@
* implementation for the specified algorithm is not available
* from the specified Provider object.
*
- * @exception IllegalArgumentException if the provider
+ * @exception IllegalArgumentException if the {@code provider}
* is null.
*
* @see java.security.Provider
@@ -248,9 +248,9 @@
}
/**
- * Returns the provider of this SecretKeyFactory
object.
+ * Returns the provider of this {@code SecretKeyFactory} object.
*
- * @return the provider of this SecretKeyFactory
object
+ * @return the provider of this {@code SecretKeyFactory} object
*/
public final Provider getProvider() {
synchronized (lock) {
@@ -261,13 +261,13 @@
}
/**
- * Returns the algorithm name of this SecretKeyFactory
object.
+ * Returns the algorithm name of this {@code SecretKeyFactory} object.
*
*
This is the same name that was specified in one of the
- * getInstance
calls that created this
- * SecretKeyFactory
object.
+ * {@code getInstance} calls that created this
+ * {@code SecretKeyFactory} object.
*
- * @return the algorithm name of this SecretKeyFactory
+ * @return the algorithm name of this {@code SecretKeyFactory}
* object.
*/
public final String getAlgorithm() {
@@ -314,7 +314,7 @@
}
/**
- * Generates a SecretKey
object from the provided key
+ * Generates a {@code SecretKey} object from the provided key
* specification (key material).
*
* @param keySpec the specification (key material) of the secret key
@@ -361,9 +361,9 @@
*
* @exception InvalidKeySpecException if the requested key specification is
* inappropriate for the given key (e.g., the algorithms associated with
- * key
and keySpec
do not match, or
- * key
references a key on a cryptographic hardware device
- * whereas keySpec
is the specification of a software-based
+ * {@code key} and {@code keySpec} do not match, or
+ * {@code key} references a key on a cryptographic hardware device
+ * whereas {@code keySpec} is the specification of a software-based
* key), or the given key cannot be dealt with
* (e.g., the given key has an algorithm or format not supported by this
* secret-key factory).