archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-26 14:24:46 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

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

Browse source 
Reviewed-by: weijun
This commit is contained in:
Koushik Thirupattur 2025-01-25 19:06:47 +00:00 • committed by Weijun Wang
parent 99002e4f9d
commit 002679ac9f
46 changed files with 201 additions and 44 deletions
Download patch file Download diff file Expand all files Collapse all files

6
src/java.base/share/classes/java/security/AlgorithmParameterGenerator.java
View file

@ -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 @@ import sun.security.jca.JCAUtil;
* 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 class AlgorithmParameterGenerator {
* 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 class AlgorithmParameterGenerator {
*
* @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 class AlgorithmParameterGenerator {
*
* @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

6
src/java.base/share/classes/java/security/AlgorithmParameters.java
View file

@ -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 @@ import java.util.Objects;
* 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 class AlgorithmParameters {
* 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 class AlgorithmParameters {
*
* @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 class AlgorithmParameters {
*
* @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}

1
src/java.base/share/classes/java/security/DrbgParameters.java
View file

@ -229,6 +229,7 @@ import java.util.Objects;
*
* @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
*/

6
src/java.base/share/classes/java/security/KeyFactory.java
View file

@ -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 @@ import sun.security.jca.GetInstance.Instance;
* 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 @@ public class KeyFactory {
* 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 class KeyFactory {
*
* @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 class KeyFactory {
*
* @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

8
src/java.base/share/classes/java/security/KeyPairGenerator.java
View file

@ -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 @@ import sun.security.util.Debug;
* 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 @@ public abstract class KeyPairGenerator extends KeyPairGeneratorSpi {
* 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 @@ public abstract class KeyPairGenerator extends KeyPairGeneratorSpi {
* 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 abstract class KeyPairGenerator extends KeyPairGeneratorSpi {
*
* @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 abstract class KeyPairGenerator extends KeyPairGeneratorSpi {
* 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

7
src/java.base/share/classes/java/security/KeyStore.java
View file

@ -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 @@ import sun.security.util.Debug;
* 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 class KeyStore {
* @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 @@ public class KeyStore {
* 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 class KeyStore {
*
* @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 class KeyStore {
*
* @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

8
src/java.base/share/classes/java/security/MessageDigest.java
View file

@ -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 @@ import javax.crypto.SecretKey;
* 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 @@ public abstract class MessageDigest extends MessageDigestSpi {
* 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 abstract class MessageDigest extends MessageDigestSpi {
*
* @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 abstract class MessageDigest extends MessageDigestSpi {
*
* @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 abstract class MessageDigest extends MessageDigestSpi {
* 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() {

12
src/java.base/share/classes/java/security/SecureRandom.java
View file

@ -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 @@ import java.util.regex.Pattern;
* 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 @@ public class SecureRandom extends java.util.Random {
* 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 @@ public class SecureRandom extends java.util.Random {
* 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 class SecureRandom extends java.util.Random {
*
* @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 class SecureRandom extends java.util.Random {
*
* @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 class SecureRandom extends java.util.Random {
* @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 class SecureRandom extends java.util.Random {
*
* @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 class SecureRandom extends java.util.Random {
*
* @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

3
src/java.base/share/classes/java/security/SecureRandomSpi.java
View file

@ -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 @@ package java.security;
* {@code SecureRandom} will call the applicable engine methods
* without any synchronization.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @since 1.2
*/

7
src/java.base/share/classes/java/security/Signature.java
View file

@ -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
@ -122,6 +122,7 @@ import sun.security.util.KnownOIDs;
* 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
*
@ -206,6 +207,7 @@ public abstract class Signature extends SignatureSpi {
* "{@docRoot}/../specs/security/standard-names.html#signature-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 Signature(String algorithm) {
this.algorithm = algorithm;
@ -252,6 +254,7 @@ public abstract class Signature extends SignatureSpi {
* 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 Signature} object
*
* @throws NoSuchAlgorithmException if no {@code Provider} supports a
@ -375,6 +378,7 @@ public abstract class Signature extends SignatureSpi {
*
* @param provider the name of the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code Signature} object
*
* @throws IllegalArgumentException if the provider name is {@code null}
@ -428,6 +432,7 @@ public abstract class Signature extends SignatureSpi {
*
* @param provider the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code Signature} object
*
* @throws IllegalArgumentException if the provider is {@code null}

1
src/java.base/share/classes/java/security/cert/CertPath.java
View file

@ -111,6 +111,7 @@ import java.util.List;
* generally not difficult, since the {@code CertPath} and
* {@code List} objects in question are immutable.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @see CertificateFactory
* @see CertPathBuilder
*

6
src/java.base/share/classes/java/security/cert/CertPathBuilder.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2000, 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2000, 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
@ -90,6 +90,7 @@ import sun.security.jca.GetInstance.Instance;
* threads each manipulating a different {@code CertPathBuilder} instance
* need not synchronize.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @see CertPath
*
* @since 1.4
@ -154,6 +155,7 @@ public class CertPathBuilder {
* 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 CertPathBuilder} object that implements the
* specified algorithm
*
@ -194,6 +196,7 @@ public class CertPathBuilder {
*
* @param provider the name of the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a {@code CertPathBuilder} object that implements the
* specified algorithm
*
@ -237,6 +240,7 @@ public class CertPathBuilder {
*
* @param provider the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a {@code CertPathBuilder} object that implements the
* specified algorithm
*

6
src/java.base/share/classes/java/security/cert/CertPathValidator.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2000, 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2000, 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
@ -92,6 +92,7 @@ import sun.security.jca.GetInstance.Instance;
* threads each manipulating a different {@code CertPathValidator}
* instance need not synchronize.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @see CertPath
*
* @since 1.4
@ -155,6 +156,7 @@ public class CertPathValidator {
* 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 CertPathValidator} object that implements the
* specified algorithm
*
@ -195,6 +197,7 @@ public class CertPathValidator {
*
* @param provider the name of the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a {@code CertPathValidator} object that implements the
* specified algorithm
*
@ -239,6 +242,7 @@ public class CertPathValidator {
*
* @param provider the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a {@code CertPathValidator} object that implements the
* specified algorithm
*

6
src/java.base/share/classes/java/security/cert/CertStore.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2000, 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2000, 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 @@ import sun.security.jca.GetInstance.Instance;
* Multiple threads may concurrently invoke the static methods defined in
* this class with no ill effects.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @since 1.4
* @author Sean Mullan, Steve Hanna
*/
@ -216,6 +217,7 @@ public class CertStore {
*
* @param params the initialization parameters (may be {@code null}).
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a {@code CertStore} object that implements the specified
* {@code CertStore} type
*
@ -282,6 +284,7 @@ public class CertStore {
*
* @param provider the name of the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a {@code CertStore} object that implements the
* specified type
*
@ -343,6 +346,7 @@ public class CertStore {
*
* @param provider the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a {@code CertStore} object that implements the
* specified type
*

1
src/java.base/share/classes/java/security/cert/Certificate.java
View file

@ -79,6 +79,7 @@ public abstract class Certificate implements java.io.Serializable {
* "{@docRoot}/../specs/security/standard-names.html#certificatefactory-types">
* Java Security Standard Algorithm Names Specification</a>
* for information about standard certificate types.
* @spec security/standard-names.html Java Security Standard Algorithm Names
*/
protected Certificate(String type) {
this.type = type;

8
src/java.base/share/classes/java/security/cert/CertificateFactory.java
View file

@ -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
@ -109,6 +109,7 @@ import sun.security.jca.GetInstance.Instance;
* Consult the release documentation for your implementation to see if any
* other types or encodings are supported.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @author Hemma Prafullchandra
* @author Jan Luehe
* @author Sean Mullan
@ -176,6 +177,7 @@ public class CertificateFactory {
* Java Security Standard Algorithm Names Specification</a>
* for information about standard certificate types.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a certificate factory object for the specified type
*
* @throws CertificateException if no {@code Provider} supports a
@ -219,6 +221,7 @@ public class CertificateFactory {
*
* @param provider the name of the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a certificate factory object for the specified type
*
* @throws CertificateException if a {@code CertificateFactorySpi}
@ -265,6 +268,7 @@ public class CertificateFactory {
* for information about standard certificate types.
* @param provider the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a certificate factory object for the specified type
*
* @throws CertificateException if a {@code CertificateFactorySpi}
@ -369,6 +373,7 @@ public class CertificateFactory {
* {@code remove} method result in an
* {@code UnsupportedOperationException}.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return an {@code Iterator} over the names of the supported
* {@code CertPath} encodings (as {@code String}s)
* @since 1.4
@ -407,6 +412,7 @@ public class CertificateFactory {
*
* @param inStream an {@code InputStream} containing the data
* @param encoding the encoding used for the data
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a {@code CertPath} initialized with the data from the
* {@code InputStream}
* @throws CertificateException if an exception occurs while decoding or

3
src/java.base/share/classes/java/security/cert/CertificateFactorySpi.java
View file

@ -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
@ -198,6 +198,7 @@ public abstract class CertificateFactorySpi {
* existing service providers, this method cannot be {@code abstract}
* and by default throws an {@code UnsupportedOperationException}.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return an {@code Iterator} over the names of the supported
* {@code CertPath} encodings (as {@code String}s)
* @throws UnsupportedOperationException if the method is not supported

3
src/java.base/share/classes/java/security/spec/ECGenParameterSpec.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2003, 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2003, 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
@ -50,6 +50,7 @@ public class ECGenParameterSpec extends NamedParameterSpec {
* "{@docRoot}/../specs/security/standard-names.html#ecgenparameterspec">
* Java Security Standard Algorithm Names Specification</a> for
* information about standard names.
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @throws NullPointerException if {@code stdName} is null.
*/
public ECGenParameterSpec(String stdName) {

3
src/java.base/share/classes/java/security/spec/EncodedKeySpec.java
View file

@ -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
@ -79,6 +79,7 @@ public abstract class EncodedKeySpec implements KeySpec {
* "{@docRoot}/../specs/security/standard-names.html#keyfactory-algorithms">
* Java Security Standard Algorithm Names Specification</a>
* for information about standard algorithm names.
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @throws NullPointerException if {@code encodedKey}
* or {@code algorithm} is null.
* @throws IllegalArgumentException if {@code algorithm} is

4
src/java.base/share/classes/java/security/spec/NamedParameterSpec.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2018, 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2018, 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
@ -36,6 +36,7 @@ import java.util.Objects;
* "{@docRoot}/../specs/security/standard-names.html#namedparameterspec">
* Java Security Standard Algorithm Names Specification</a>.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @since 11
*
*/
@ -131,6 +132,7 @@ public class NamedParameterSpec implements AlgorithmParameterSpec {
* Java Security Standard Algorithm Names Specification</a> for
* information about standard names.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @throws NullPointerException if {@code stdName} is null.
*/
public NamedParameterSpec(String stdName) {

3
src/java.base/share/classes/java/security/spec/PKCS8EncodedKeySpec.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1997, 2017, 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 @@ public class PKCS8EncodedKeySpec extends EncodedKeySpec {
* "{@docRoot}/../specs/security/standard-names.html#keyfactory-algorithms">
* Java Security Standard Algorithm Names Specification</a>
* for information about standard algorithm names.
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @throws NullPointerException if {@code encodedKey}
* or {@code algorithm} is null.
* @throws IllegalArgumentException if {@code algorithm} is

3
src/java.base/share/classes/java/security/spec/PSSParameterSpec.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2001, 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2001, 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
@ -140,6 +140,7 @@ public class PSSParameterSpec implements AlgorithmParameterSpec {
* getMGFParameters().
* @param saltLen the length of salt in bytes
* @param trailerField the value of the trailer field
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @throws NullPointerException if {@code mdName}, or {@code mgfName}
* is null
* @throws IllegalArgumentException if {@code saltLen} or

3
src/java.base/share/classes/java/security/spec/X509EncodedKeySpec.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1997, 2017, 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
@ -78,6 +78,7 @@ public class X509EncodedKeySpec extends EncodedKeySpec {
* "{@docRoot}/../specs/security/standard-names.html#keyfactory-algorithms">
* Java Security Standard Algorithm Names Specification</a>
* for information about standard algorithm names.
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @throws NullPointerException if {@code encodedKey}
* or {@code algorithm} is null.
* @throws IllegalArgumentException if {@code algorithm} is