add spec links

wangweij · Jan 6, 2025 · 4634ab1 · 4634ab1
1 parent cd90591
commit 4634ab1
Show file tree

Hide file tree

Showing 8 changed files with 10 additions and 1 deletion.
diff --git a/src/java.base/share/classes/java/security/Key.java b/src/java.base/share/classes/java/security/Key.java
@@ -120,7 +120,7 @@ public interface Key extends java.io.Serializable {
 
     /**
      * Returns the standard algorithm name for this key. For
-     * example, "DSA" would indicate that this key is a DSA key.
+     * example, "RSA" would indicate that this key is an RSA key.
      * See the Key Algorithms section in the
      * <a href="{@docRoot}/../specs/security/standard-names.html#key-algorithms">
      * Java Security Standard Algorithm Names Specification</a>

diff --git a/src/java.base/share/classes/java/security/spec/EncodedKeySpec.java b/src/java.base/share/classes/java/security/spec/EncodedKeySpec.java
@@ -83,6 +83,7 @@ public EncodedKeySpec(byte[] encodedKey) {
      * or {@code algorithm} is null.
      * @throws IllegalArgumentException if {@code algorithm} is
      * the empty string {@code ""}
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @since 9
      */
     protected EncodedKeySpec(byte[] encodedKey, String algorithm) {

diff --git a/src/java.base/share/classes/java/security/spec/PKCS8EncodedKeySpec.java b/src/java.base/share/classes/java/security/spec/PKCS8EncodedKeySpec.java
@@ -92,6 +92,7 @@ public PKCS8EncodedKeySpec(byte[] encodedKey) {
      * or {@code algorithm} is null.
      * @throws IllegalArgumentException if {@code algorithm} is
      * the empty string {@code ""}
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @since 9
      */
     public PKCS8EncodedKeySpec(byte[] encodedKey, String algorithm) {

diff --git a/src/java.base/share/classes/java/security/spec/X509EncodedKeySpec.java b/src/java.base/share/classes/java/security/spec/X509EncodedKeySpec.java
@@ -82,6 +82,7 @@ public X509EncodedKeySpec(byte[] encodedKey) {
      * or {@code algorithm} is null.
      * @throws IllegalArgumentException if {@code algorithm} is
      * the empty string {@code ""}
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @since 9
      */
     public X509EncodedKeySpec(byte[] encodedKey, String algorithm) {

diff --git a/src/java.base/share/classes/javax/crypto/KDF.java b/src/java.base/share/classes/javax/crypto/KDF.java
@@ -498,6 +498,7 @@ private static KDF handleException(NoSuchAlgorithmException e)
      *
      * @see <a href="#DelayedProviderSelection">Delayed Provider
      *         Selection</a>
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      *
      */
     public SecretKey deriveKey(String alg,

diff --git a/src/java.base/share/classes/javax/crypto/KDFSpi.java b/src/java.base/share/classes/javax/crypto/KDFSpi.java
@@ -133,6 +133,7 @@ protected KDFSpi(KDFParameters kdfParameters)
      *         if {@code alg} is empty or invalid
      * @throws NullPointerException
      *         if {@code alg} or {@code derivationSpec} is null
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      */
     protected abstract SecretKey engineDeriveKey(String alg,
                                                  AlgorithmParameterSpec derivationSpec)

diff --git a/src/java.base/share/classes/javax/crypto/KEM.java b/src/java.base/share/classes/javax/crypto/KEM.java
@@ -243,6 +243,7 @@ public Encapsulated encapsulate() {
          * @throws UnsupportedOperationException if the combination of
          *          {@code from}, {@code to}, and {@code algorithm}
          *          is not supported by the encapsulator
+         * @spec security/standard-names.html Java Security Standard Algorithm Names
          */
         public Encapsulated encapsulate(int from, int to, String algorithm) {
             return e.engineEncapsulate(from, to, algorithm);
@@ -373,6 +374,7 @@ public SecretKey decapsulate(byte[] encapsulation) throws DecapsulateException {
          * @throws UnsupportedOperationException if the combination of
          *          {@code from}, {@code to}, and {@code algorithm}
          *          is not supported by the decapsulator
+         * @spec security/standard-names.html Java Security Standard Algorithm Names
          */
         public SecretKey decapsulate(byte[] encapsulation,
                 int from, int to, String algorithm)

diff --git a/src/java.base/share/classes/javax/crypto/KEMSpi.java b/src/java.base/share/classes/javax/crypto/KEMSpi.java
@@ -147,6 +147,7 @@ interface EncapsulatorSpi {
          *          is not supported by the encapsulator
          * @see KEM.Encapsulated
          * @see KEM.Encapsulator#encapsulate(int, int, String)
+         * @spec security/standard-names.html Java Security Standard Algorithm Names
          */
         KEM.Encapsulated engineEncapsulate(int from, int to, String algorithm);
 
@@ -213,6 +214,7 @@ interface DecapsulatorSpi {
          *          {@code from}, {@code to}, and {@code algorithm}
          *          is not supported by the decapsulator
          * @see KEM.Decapsulator#decapsulate(byte[], int, int, String)
+         * @spec security/standard-names.html Java Security Standard Algorithm Names
          */
         SecretKey engineDecapsulate(byte[] encapsulation, int from, int to, String algorithm)
                 throws DecapsulateException;