8347065: Add missing @SPEC tags for Java Security Standard Algorithm Names

Reviewed-by: weijun

Author: koushikthirupattur

src/java.base/share/classes/java/security/AlgorithmParameterGenerator.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2022, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -88,6 +88,7 @@
  * Consult the release documentation for your implementation to see if any
  * other algorithms are supported.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @author Jan Luehe
  *
  *
@@ -161,6 +162,7 @@ public final String getAlgorithm() {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code AlgorithmParameterGenerator} object
      *
      * @throws NoSuchAlgorithmException if no {@code Provider} supports an
@@ -208,6 +210,7 @@ public static AlgorithmParameterGenerator getInstance(String algorithm)
      *
      * @param provider the string name of the {@code Provider}.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code AlgorithmParameterGenerator} object
      *
      * @throws IllegalArgumentException if the provider name is {@code null}
@@ -258,6 +261,7 @@ public static AlgorithmParameterGenerator getInstance(String algorithm,
      *
      * @param provider the {@code Provider} object.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code AlgorithmParameterGenerator} object
      *
      * @throws IllegalArgumentException if the specified provider is

src/java.base/share/classes/java/security/AlgorithmParameters.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -69,6 +69,7 @@
  * Consult the release documentation for your implementation to see if any
  * other algorithms are supported.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @author Jan Luehe
  *
  *
@@ -147,6 +148,7 @@ public final String getAlgorithm() {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new parameter object
      *
      * @throws NoSuchAlgorithmException if no {@code Provider} supports an
@@ -194,6 +196,7 @@ public static AlgorithmParameters getInstance(String algorithm)
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new parameter object
      *
      * @throws IllegalArgumentException if the provider name is {@code null}
@@ -244,6 +247,7 @@ public static AlgorithmParameters getInstance(String algorithm,
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new parameter object
      *
      * @throws IllegalArgumentException if the provider is {@code null}

src/java.base/share/classes/java/security/DrbgParameters.java

@@ -229,6 +229,7 @@
  *
  * @spec https://nvlpubs.nist.gov/nistpubs/SpecialPublications/NIST.SP.800-90Ar1.pdf
  *      Recommendation for Random Number Generation Using Deterministic Random Bit Generators
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  *
  * @since 9
  */

src/java.base/share/classes/java/security/KeyFactory.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -84,6 +84,7 @@
  * Consult the release documentation for your implementation to see if any
  * other algorithms are supported.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @author Jan Luehe
  *
  * @see Key
@@ -169,6 +170,7 @@ private KeyFactory(String algorithm) throws NoSuchAlgorithmException {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code KeyFactory} object
      *
      * @throws NoSuchAlgorithmException if no {@code Provider} supports a
@@ -205,6 +207,7 @@ public static KeyFactory getInstance(String algorithm)
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code KeyFactory} object
      *
      * @throws IllegalArgumentException if the provider name is {@code null}
@@ -247,6 +250,7 @@ public static KeyFactory getInstance(String algorithm, String provider)
      *
      * @param provider the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code KeyFactory} object
      *
      * @throws IllegalArgumentException if the specified provider is

src/java.base/share/classes/java/security/KeyPairGenerator.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -131,6 +131,7 @@
  * Consult the release documentation for your implementation to see if any
  * other algorithms are supported.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @author Benjamin Renaud
  * @since 1.1
  *
@@ -157,6 +158,7 @@ public abstract class KeyPairGenerator extends KeyPairGeneratorSpi {
      * "{@docRoot}/../specs/security/standard-names.html#keypairgenerator-algorithms">
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      */
     protected KeyPairGenerator(String algorithm) {
         this.algorithm = algorithm;
@@ -169,6 +171,7 @@ protected KeyPairGenerator(String algorithm) {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the standard string name of the algorithm.
      */
     public String getAlgorithm() {
@@ -221,6 +224,7 @@ private static KeyPairGenerator getInstance(Instance instance,
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code KeyPairGenerator} object
      *
      * @throws NoSuchAlgorithmException if no {@code Provider} supports a
@@ -280,6 +284,7 @@ public static KeyPairGenerator getInstance(String algorithm)
      *
      * @param provider the string name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code KeyPairGenerator} object
      *
      * @throws IllegalArgumentException if the provider name is {@code null}
@@ -320,6 +325,7 @@ public static KeyPairGenerator getInstance(String algorithm,
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @param provider the provider.
      *
      * @return the new {@code KeyPairGenerator} object

src/java.base/share/classes/java/security/KeyStore.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -183,6 +183,7 @@
  * Consult the release documentation for your implementation to see if any
  * other types are supported.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @author Jan Luehe
  *
  * @see java.security.PrivateKey
@@ -300,6 +301,7 @@ public PasswordProtection(char[] password) {
          * @throws    NullPointerException if {@code protectionAlgorithm} is
          *     {@code null}
          *
+         * @spec security/standard-names.html Java Security Standard Algorithm Names
          * @since 1.8
          */
         public PasswordProtection(char[] password, String protectionAlgorithm,
@@ -852,6 +854,7 @@ private String getProviderName() {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard keystore types.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a keystore object of the specified type
      *
      * @throws KeyStoreException if no provider supports a
@@ -893,6 +896,7 @@ public static KeyStore getInstance(String type)
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a keystore object of the specified type
      *
      * @throws IllegalArgumentException if the provider name is {@code null}
@@ -939,6 +943,7 @@ public static KeyStore getInstance(String type, String provider)
      *
      * @param provider the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a keystore object of the specified type
      *
      * @throws IllegalArgumentException if the specified provider is

src/java.base/share/classes/java/security/MessageDigest.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1996, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1996, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -96,6 +96,7 @@
  * Consult the release documentation for your implementation to see if any
  * other algorithms are supported.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @author Benjamin Renaud
  * @since 1.1
  *
@@ -128,6 +129,7 @@ public abstract class MessageDigest extends MessageDigestSpi {
      * "{@docRoot}/../specs/security/standard-names.html#messagedigest-algorithms">
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      */
     protected MessageDigest(String algorithm) {
         this.algorithm = algorithm;
@@ -166,6 +168,7 @@ private MessageDigest(String algorithm, Provider p) {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code MessageDigest} object that implements the
      *         specified algorithm
      *
@@ -221,6 +224,7 @@ public static MessageDigest getInstance(String algorithm)
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code MessageDigest} object that implements the
      *         specified algorithm
      *
@@ -275,6 +279,7 @@ public static MessageDigest getInstance(String algorithm, String provider)
      *
      * @param provider the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return a {@code MessageDigest} object that implements the
      *         specified algorithm
      *
@@ -513,6 +518,7 @@ public void reset() {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the name of the algorithm
      */
     public final String getAlgorithm() {

src/java.base/share/classes/java/security/SecureRandom.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1996, 2024, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1996, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -144,7 +144,7 @@
  *      RFC 4086: Randomness Requirements for Security
  * @spec https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.140-2.pdf
  *      Security Requirements for Cryptographic Modules
- *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @see java.security.SecureRandomSpi
  * @see java.util.Random
  *
@@ -214,6 +214,7 @@ public class SecureRandom extends java.util.Random {
      * "{@docRoot}/../specs/security/standard-names.html#securerandom-number-generation-algorithms">
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard RNG algorithm names.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      */
     public SecureRandom() {
         /*
@@ -257,6 +258,7 @@ private boolean getThreadSafe() {
      * for information about standard RNG algorithm names.
      *
      * @param seed the seed.
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @throws NullPointerException if {@code seed} is {@code null}
      */
     public SecureRandom(byte[] seed) {
@@ -371,6 +373,7 @@ private String getProviderName() {
      * Java Security Standard Algorithm Names Specification</a>
      * for information about standard RNG algorithm names.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code SecureRandom} object
      *
      * @throws NoSuchAlgorithmException if no {@code Provider} supports a
@@ -412,6 +415,7 @@ public static SecureRandom getInstance(String algorithm)
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code SecureRandom} object
      *
      * @throws IllegalArgumentException if the provider name is {@code null}
@@ -456,6 +460,7 @@ public static SecureRandom getInstance(String algorithm, String provider)
      *
      * @param provider the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code SecureRandom} object
      *
      * @throws IllegalArgumentException if the specified provider is
@@ -511,6 +516,7 @@ public static SecureRandom getInstance(String algorithm,
      * @param params the {@code SecureRandomParameters}
      *               the newly created {@code SecureRandom} object must support.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code SecureRandom} object
      *
      * @throws IllegalArgumentException if the specified params is
@@ -563,6 +569,7 @@ public static SecureRandom getInstance(
      *
      * @param provider the name of the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code SecureRandom} object
      *
      * @throws IllegalArgumentException if the provider name is {@code null}
@@ -615,6 +622,7 @@ public static SecureRandom getInstance(String algorithm,
      *
      * @param provider the provider.
      *
+     * @spec security/standard-names.html Java Security Standard Algorithm Names
      * @return the new {@code SecureRandom} object
      *
      * @throws IllegalArgumentException if the specified provider or params

src/java.base/share/classes/java/security/SecureRandomSpi.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1998, 2022, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1998, 2025, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -79,6 +79,7 @@
  * {@code SecureRandom} will call the applicable engine methods
  * without any synchronization.
  *
+ * @spec security/standard-names.html Java Security Standard Algorithm Names
  * @since 1.2
  */