archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-26 06:14:49 +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

6
src/java.base/share/classes/javax/crypto/Cipher.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
@ -169,6 +169,7 @@ import sun.security.util.KnownOIDs;
* RFC 5116: An Interface and Algorithms for Authenticated Encryption
* @spec https://www.rfc-editor.org/info/rfc7539
* RFC 7539: ChaCha20 and Poly1305 for IETF Protocols
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @author Jan Luehe
* @see KeyGenerator
* @see SecretKey
@ -520,6 +521,7 @@ public class Cipher {
* Java Security Standard Algorithm Names Specification</a>
* for information about standard transformation names.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a {@code Cipher} object that implements the requested
* transformation
*
@ -611,6 +613,7 @@ public class Cipher {
*
* @param provider the name of the provider
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a {@code Cipher} object that implements the requested
* transformation
*
@ -683,6 +686,7 @@ public class Cipher {
*
* @param provider the provider
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a {@code Cipher} object that implements the requested
* transformation
*

5
src/java.base/share/classes/javax/crypto/ExemptionMechanism.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1999, 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1999, 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
@ -129,6 +129,7 @@ public class ExemptionMechanism {
* Java Security Standard Algorithm Names Specification</a>
* for information about standard exemption mechanism names.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code ExemptionMechanism} object
*
* @throws NoSuchAlgorithmException if no {@code Provider} supports an
@ -170,6 +171,7 @@ public class ExemptionMechanism {
*
* @param provider the name of the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code ExemptionMechanism} object
*
* @throws IllegalArgumentException if the {@code provider}
@ -214,6 +216,7 @@ public class ExemptionMechanism {
*
* @param provider the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code ExemptionMechanism} object
*
* @throws IllegalArgumentException if the {@code provider}

8
src/java.base/share/classes/javax/crypto/KDF.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2024, 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
@ -222,6 +222,7 @@ public final class KDF {
* Java Security Standard Algorithm Names Specification</a> for
* information about standard KDF algorithm names.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a {@code KDF} object
*
* @throws NoSuchAlgorithmException
@ -256,6 +257,7 @@ public final class KDF {
* @param provider
* the provider to use for this key derivation
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a {@code KDF} object
*
* @throws NoSuchAlgorithmException
@ -291,6 +293,7 @@ public final class KDF {
* @param provider
* the provider to use for this key derivation
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a {@code KDF} object
*
* @throws NoSuchAlgorithmException
@ -332,6 +335,7 @@ public final class KDF {
* the {@code KDFParameters} used to configure the derivation
* algorithm or {@code null} if no parameters are provided
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a {@code KDF} object
*
* @throws NoSuchAlgorithmException
@ -375,6 +379,7 @@ public final class KDF {
* @param provider
* the provider to use for this key derivation
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a {@code KDF} object
*
* @throws NoSuchAlgorithmException
@ -428,6 +433,7 @@ public final class KDF {
* @param provider
* the provider to use for this key derivation
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a {@code KDF} object
*
* @throws NoSuchAlgorithmException

5
src/java.base/share/classes/javax/crypto/KEM.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2023, 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2023, 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
@ -531,6 +531,7 @@ public final class KEM {
* "{@docRoot}/../specs/security/standard-names.html#kem-algorithms">
* Java Security Standard Algorithm Names Specification</a>
* for information about standard KEM algorithm names.
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code KEM} object
* @throws NoSuchAlgorithmException if no {@code Provider} supports a
* {@code KEM} implementation for the specified algorithm
@ -568,6 +569,7 @@ public final class KEM {
* for information about standard KEM algorithm names.
* @param provider the provider. If {@code null}, this method is equivalent
* to {@link #getInstance(String)}.
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code KEM} object
* @throws NoSuchAlgorithmException if a {@code provider} is specified and
* it does not support the specified KEM algorithm,
@ -599,6 +601,7 @@ public final class KEM {
* for information about standard KEM algorithm names.
* @param provider the provider. If {@code null}, this method is equivalent
* to {@link #getInstance(String)}.
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code KEM} object
* @throws NoSuchAlgorithmException if a {@code provider} is specified and
* it does not support the specified KEM algorithm,

6
src/java.base/share/classes/javax/crypto/KeyAgreement.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
@ -71,6 +71,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 KeyGenerator
@ -170,6 +171,7 @@ public class KeyAgreement {
* 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 KeyAgreement} object
*
* @throws NoSuchAlgorithmException if no {@code Provider} supports a
@ -217,6 +219,7 @@ public class KeyAgreement {
*
* @param provider the name of the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code KeyAgreement} object
*
* @throws IllegalArgumentException if the {@code provider}
@ -261,6 +264,7 @@ public class KeyAgreement {
*
* @param provider the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code KeyAgreement} object
*
* @throws IllegalArgumentException if the {@code provider}

6
src/java.base/share/classes/javax/crypto/KeyGenerator.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
@ -109,6 +109,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 Jan Luehe
*
* @see SecretKey
@ -226,6 +227,7 @@ public class KeyGenerator {
* 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 KeyGenerator} object
*
* @throws NoSuchAlgorithmException if no {@code Provider} supports a
@ -262,6 +264,7 @@ public class KeyGenerator {
*
* @param provider the name of the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code KeyGenerator} object
*
* @throws IllegalArgumentException if the {@code provider}
@ -305,6 +308,7 @@ public class KeyGenerator {
*
* @param provider the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code KeyGenerator} object
*
* @throws IllegalArgumentException if the {@code provider}

6
src/java.base/share/classes/javax/crypto/Mac.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1998, 2024, 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
@ -66,6 +66,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
*
* @since 1.4
@ -165,6 +166,7 @@ public class Mac implements Cloneable {
* 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 Mac} object
*
* @throws NoSuchAlgorithmException if no {@code Provider} supports a
@ -210,6 +212,7 @@ public class Mac implements Cloneable {
*
* @param provider the name of the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code Mac} object
*
* @throws IllegalArgumentException if the {@code provider}
@ -251,6 +254,7 @@ public class Mac implements Cloneable {
*
* @param provider the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code Mac} object
*
* @throws IllegalArgumentException if the {@code provider} is

6
src/java.base/share/classes/javax/crypto/SecretKeyFactory.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
@ -68,6 +68,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 SecretKey
@ -146,6 +147,7 @@ public class SecretKeyFactory {
* 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 SecretKeyFactory} object
*
* @throws NoSuchAlgorithmException if no {@code Provider} supports a
@ -183,6 +185,7 @@ public class SecretKeyFactory {
*
* @param provider the name of the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code SecretKeyFactory} object
*
* @throws IllegalArgumentException if the {@code provider}
@ -227,6 +230,7 @@ public class SecretKeyFactory {
*
* @param provider the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code SecretKeyFactory} object
*
* @throws IllegalArgumentException if the {@code provider}

5
src/java.base/share/classes/javax/net/ssl/KeyManagerFactory.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1999, 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1999, 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
@ -124,6 +124,7 @@ public class KeyManagerFactory {
* Algorithm Names Specification for information about standard
* algorithm names.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code KeyManagerFactory} object
*
* @throws NoSuchAlgorithmException if no {@code Provider} supports a
@ -165,6 +166,7 @@ public class KeyManagerFactory {
*
* @param provider the name of the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code KeyManagerFactory} object
*
* @throws IllegalArgumentException if the provider name is {@code null}
@ -210,6 +212,7 @@ public class KeyManagerFactory {
*
* @param provider an instance of the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code KeyManagerFactory} object
*
* @throws IllegalArgumentException if provider is {@code null}

6
src/java.base/share/classes/javax/net/ssl/SSLContext.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1999, 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1999, 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
@ -51,6 +51,7 @@ import sun.security.jca.GetInstance;
* Consult the release documentation for your implementation to see if any
* other protocols are supported.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @since 1.4
*/
public class SSLContext {
@ -161,6 +162,7 @@ public class SSLContext {
* Java Security Standard Algorithm Names Specification</a>
* for information about standard protocol names.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code SSLContext} object
*
* @throws NoSuchAlgorithmException if no {@code Provider} supports a
@ -200,6 +202,7 @@ public class SSLContext {
*
* @param provider the name of the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code SSLContext} object
*
* @throws IllegalArgumentException if the provider name is
@ -242,6 +245,7 @@ public class SSLContext {
*
* @param provider an instance of the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code SSLContext} object
*
* @throws IllegalArgumentException if the provider is {@code null}

5
src/java.base/share/classes/javax/net/ssl/SSLEngine.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
@ -917,6 +917,7 @@ public abstract class SSLEngine {
* Algorithm Names Specification, and may also include other cipher
* suites that the provider supports.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return an array of cipher suite names
* @see #getEnabledCipherSuites()
* @see #setEnabledCipherSuites(String[])
@ -943,6 +944,7 @@ public abstract class SSLEngine {
* Algorithm Names Specification, and may also include other cipher
* suites that the provider supports.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return an array of cipher suite names
* @see #getSupportedCipherSuites()
* @see #setEnabledCipherSuites(String[])
@ -970,6 +972,7 @@ public abstract class SSLEngine {
* on why a specific cipher suite may never be used on an engine.
*
* @param suites Names of all the cipher suites to enable
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @throws IllegalArgumentException when one or more of the ciphers
* named by the parameter is not supported, or when the
* parameter is null.

10
src/java.base/share/classes/javax/net/ssl/SSLParameters.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2005, 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2005, 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
@ -113,6 +113,7 @@ public class SSLParameters {
* Algorithm Names Specification. Providers may support cipher suite
* names not found in this list.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @param cipherSuites the array of ciphersuites (or null)
*/
@SuppressWarnings("this-escape")
@ -134,6 +135,7 @@ public class SSLParameters {
* Algorithm Names Specification. Providers may support cipher suite
* names not found in this list.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @param cipherSuites the array of ciphersuites (or null)
* @param protocols the array of protocols (or null)
*/
@ -158,6 +160,7 @@ public class SSLParameters {
* Algorithm Names Specification, and may also include other cipher suites
* that the provider supports.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a copy of the array of ciphersuites or null if none
* have been set.
*/
@ -175,6 +178,7 @@ public class SSLParameters {
* Algorithm Names Specification. Providers may support cipher suite
* names not found in this list or might not use the recommended name
* for a certain cipher suite.
* @spec security/standard-names.html Java Security Standard Algorithm Names
*/
public void setCipherSuites(String[] cipherSuites) {
this.cipherSuites = clone(cipherSuites);
@ -749,6 +753,7 @@ public class SSLParameters {
* with the SunJSSE provider to override the provider-specific default
* signature schemes.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return an array of signature scheme {@code Strings} or {@code null} if
* none have been set. For non-null returns, this method will
* return a new array each time it is invoked. The array is
@ -794,6 +799,7 @@ public class SSLParameters {
* method will make a copy of this array. Providers should ignore
* unknown signature scheme names while establishing the
* SSL/TLS/DTLS connections.
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @throws IllegalArgumentException if any element in the
* {@code signatureSchemes} array is {@code null} or
* {@linkplain String#isBlank() blank}.
@ -868,6 +874,7 @@ public class SSLParameters {
* {@systemProperty jdk.tls.namedGroups} system property with the SunJSSE
* provider to override the provider-specific default named groups.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return an array of key exchange named group names {@code Strings} or
* {@code null} if none have been set. For non-null returns, this
* method will return a new array each time it is invoked. The
@ -913,6 +920,7 @@ public class SSLParameters {
* This method will make a copy of this array. Providers should
* ignore unknown named group scheme names while establishing the
* SSL/TLS/DTLS connections.
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @throws IllegalArgumentException if any element in the
* {@code namedGroups} array is a duplicate, {@code null} or
* {@linkplain String#isBlank() blank}.

5
src/java.base/share/classes/javax/net/ssl/SSLServerSocket.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
@ -177,6 +177,7 @@ public abstract class SSLServerSocket extends ServerSocket {
* Algorithm Names Specification, and may also include other cipher
* suites that the provider supports.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return an array of cipher suites enabled
* @see #getSupportedCipherSuites()
* @see #setEnabledCipherSuites(String[])
@ -211,6 +212,7 @@ public abstract class SSLServerSocket extends ServerSocket {
* @exception IllegalArgumentException when one or more of ciphers
* named by the parameter is not supported, or when
* the parameter is null.
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @see #getSupportedCipherSuites()
* @see #getEnabledCipherSuites()
*/
@ -233,6 +235,7 @@ public abstract class SSLServerSocket extends ServerSocket {
* Algorithm Names Specification, and may also include other cipher
* suites that the provider supports.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return an array of cipher suite names
* @see #getEnabledCipherSuites()
* @see #setEnabledCipherSuites(String[])

4
src/java.base/share/classes/javax/net/ssl/SSLServerSocketFactory.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
@ -91,6 +91,7 @@ public abstract class SSLServerSocketFactory extends ServerSocketFactory {
* Algorithm Names Specification, and may also include other cipher
* suites that the provider supports.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @see #getSupportedCipherSuites()
* @return array of the cipher suites enabled by default
*/
@ -112,6 +113,7 @@ public abstract class SSLServerSocketFactory extends ServerSocketFactory {
* Algorithm Names Specification, and may also include other cipher
* suites that the provider supports.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return an array of cipher suite names
* @see #getDefaultCipherSuites()
*/

5
src/java.base/share/classes/javax/net/ssl/SSLSocket.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
@ -305,6 +305,7 @@ public abstract class SSLSocket extends Socket
* Algorithm Names Specification, and may also include other cipher
* suites that the provider supports.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return an array of cipher suite names
* @see #getEnabledCipherSuites()
* @see #setEnabledCipherSuites(String [])
@ -331,6 +332,7 @@ public abstract class SSLSocket extends Socket
* Algorithm Names Specification, and may also include other cipher
* suites that the provider supports.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return an array of cipher suite names
* @see #getSupportedCipherSuites()
* @see #setEnabledCipherSuites(String [])
@ -358,6 +360,7 @@ public abstract class SSLSocket extends Socket
* on why a specific ciphersuite may never be used on a connection.
*
* @param suites Names of all the cipher suites to enable
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @throws IllegalArgumentException when one or more of the ciphers
* named by the parameter is not supported, or when the
* parameter is null.

4
src/java.base/share/classes/javax/net/ssl/SSLSocketFactory.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
@ -109,6 +109,7 @@ public abstract class SSLSocketFactory extends SocketFactory {
* Algorithm Names Specification, and may also include other cipher suites
* that the provider supports.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @see #getSupportedCipherSuites()
* @return array of the cipher suites enabled by default
*/
@ -128,6 +129,7 @@ public abstract class SSLSocketFactory extends SocketFactory {
* Algorithm Names Specification, and may also include other cipher suites
* that the provider supports.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @see #getDefaultCipherSuites()
* @return an array of cipher suite names
*/

6
src/java.base/share/classes/javax/net/ssl/TrustManagerFactory.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1999, 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1999, 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
@ -48,6 +48,7 @@ import sun.security.jca.GetInstance;
* 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
* @since 1.4
* @see TrustManager
*/
@ -138,6 +139,7 @@ public class TrustManagerFactory {
* Algorithm Names Specification for information about standard
* algorithm names.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code TrustManagerFactory} object
*
* @throws NoSuchAlgorithmException if no {@code Provider} supports a
@ -177,6 +179,7 @@ public class TrustManagerFactory {
* Algorithm Names Specification for information about standard
* algorithm names.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @param provider the name of the provider.
*
* @return the new {@code TrustManagerFactory} object
@ -224,6 +227,7 @@ public class TrustManagerFactory {
*
* @param provider an instance of the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code TrustManagerFactory} object
*
* @throws IllegalArgumentException if the provider is {@code null}

6
src/java.base/share/classes/javax/security/auth/login/Configuration.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1998, 2024, 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
@ -176,6 +176,7 @@ import sun.security.jca.GetInstance;
* Java Security Standard Algorithm Names Specification</a>
* for a list of standard Configuration types.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @since 1.4
* @see javax.security.auth.login.LoginContext
* @see java.security.Security security properties
@ -268,6 +269,7 @@ public abstract class Configuration {
*
* @param params parameters for the Configuration, which may be null.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code Configuration} object
*
* @throws IllegalArgumentException if the specified parameters
@ -324,6 +326,7 @@ public abstract class Configuration {
*
* @param provider the provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code Configuration} object
*
* @throws IllegalArgumentException if the specified provider
@ -387,6 +390,7 @@ public abstract class Configuration {
*
* @param provider the Provider.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the new {@code Configuration} object
*
* @throws IllegalArgumentException if the specified {@code Provider}

3
src/java.management/share/classes/com/sun/jmx/remote/security/HashedPasswordManager.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2017, 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2017, 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 static java.nio.charset.StandardCharsets.UTF_8;
* A user generated hashed password file can also be used instead of a
* clear-text password file. If generated by the user, hashed passwords must
* follow the format specified above.
* @spec security/standard-names.html Java Security Standard Algorithm Names
*/
public final class HashedPasswordManager {

6
src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/TransformService.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2005, 2019, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2005, 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
@ -101,6 +101,7 @@ import javax.xml.crypto.dsig.spec.TransformParameterSpec;
* necessary locking. Multiple threads each manipulating a different
* <code>TransformService</code> instance need not synchronize.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @author Sean Mullan
* @author JSR 105 Expert Group
* @since 1.6
@ -153,6 +154,7 @@ public abstract class TransformService implements Transform {
* "{@docRoot}/../specs/security/standard-names.html#xml-signature-xmlsignaturefactorykeyinfofactorytransformservice-mechanisms">
* Java Security Standard Algorithm Names Specification</a> for a list of
* standard mechanism types.
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a new <code>TransformService</code>
* @throws NullPointerException if <code>algorithm</code> or
* <code>mechanismType</code> is <code>null</code>
@ -215,6 +217,7 @@ public abstract class TransformService implements Transform {
* Java Security Standard Algorithm Names Specification</a> for a list of
* standard mechanism types.
* @param provider the <code>Provider</code> object
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a new <code>TransformService</code>
* @throws NullPointerException if <code>provider</code>,
* <code>algorithm</code>, or <code>mechanismType</code> is
@ -277,6 +280,7 @@ public abstract class TransformService implements Transform {
* Java Security Standard Algorithm Names Specification</a> for a list of
* standard mechanism types.
* @param provider the string name of the provider
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a new <code>TransformService</code>
* @throws NoSuchProviderException if the specified provider is not
* registered in the security provider list

6
src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/XMLSignatureFactory.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2005, 2018, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2005, 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
@ -143,6 +143,7 @@ import java.util.List;
* necessary locking. Multiple threads each manipulating a different
* <code>XMLSignatureFactory</code> instance need not synchronize.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @author Sean Mullan
* @author JSR 105 Expert Group
* @since 1.6
@ -186,6 +187,7 @@ public abstract class XMLSignatureFactory {
* "{@docRoot}/../specs/security/standard-names.html#xml-signature-xmlsignaturefactorykeyinfofactorytransformservice-mechanisms">
* Java Security Standard Algorithm Names Specification</a> for a list of
* standard mechanism types.
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a new <code>XMLSignatureFactory</code>
* @throws NullPointerException if <code>mechanismType</code> is
* <code>null</code>
@ -234,6 +236,7 @@ public abstract class XMLSignatureFactory {
* Java Security Standard Algorithm Names Specification</a> for a list of
* standard mechanism types.
* @param provider the <code>Provider</code> object
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a new <code>XMLSignatureFactory</code>
* @throws NullPointerException if <code>provider</code> or
* <code>mechanismType</code> is <code>null</code>
@ -287,6 +290,7 @@ public abstract class XMLSignatureFactory {
* Java Security Standard Algorithm Names Specification</a> for a list of
* standard mechanism types.
* @param provider the string name of the provider
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a new <code>XMLSignatureFactory</code>
* @throws NoSuchProviderException if the specified provider is not
* registered in the security provider list

6
src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/KeyInfoFactory.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2005, 2018, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2005, 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
@ -99,6 +99,7 @@ import javax.xml.crypto.dsig.*;
* Multiple threads each manipulating a different <code>KeyInfoFactory</code>
* instance need not synchronize.
*
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @author Sean Mullan
* @author JSR 105 Expert Group
* @since 1.6
@ -142,6 +143,7 @@ public abstract class KeyInfoFactory {
* "{@docRoot}/../specs/security/standard-names.html#xml-signature-xmlsignaturefactorykeyinfofactorytransformservice-mechanisms">
* Java Security Standard Algorithm Names Specification</a> for a list
* of standard mechanism types.
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a new <code>KeyInfoFactory</code>
* @throws NullPointerException if <code>mechanismType</code> is
* <code>null</code>
@ -189,6 +191,7 @@ public abstract class KeyInfoFactory {
* Java Security Standard Algorithm Names Specification</a> for a list
* of standard mechanism types.
* @param provider the <code>Provider</code> object
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a new <code>KeyInfoFactory</code>
* @throws NullPointerException if <code>mechanismType</code> or
* <code>provider</code> are <code>null</code>
@ -241,6 +244,7 @@ public abstract class KeyInfoFactory {
* Java Security Standard Algorithm Names Specification</a> for a list
* of standard mechanism types.
* @param provider the string name of the provider
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return a new <code>KeyInfoFactory</code>
* @throws NoSuchProviderException if the specified provider is not
* registered in the security provider list

6
src/jdk.jartool/share/classes/jdk/security/jarsigner/JarSigner.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2015, 2024, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2015, 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
@ -181,6 +181,7 @@ public final class JarSigner {
* "{@docRoot}/../specs/security/standard-names.html#messagedigest-algorithms">
* Java Cryptography Architecture Standard Algorithm Name
* Documentation</a> for information about standard algorithm names.
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the {@code JarSigner.Builder} itself.
* @throws NoSuchAlgorithmException if {@code algorithm} is not available.
*/
@ -202,6 +203,7 @@ public final class JarSigner {
* Java Cryptography Architecture Standard Algorithm Name
* Documentation</a> for information about standard algorithm names.
* @param provider the provider.
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the {@code JarSigner.Builder} itself.
* @throws NoSuchAlgorithmException if {@code algorithm} is not
* available in the specified provider.
@ -227,6 +229,7 @@ public final class JarSigner {
* "{@docRoot}/../specs/security/standard-names.html#signature-algorithms">
* Java Cryptography Architecture Standard Algorithm Name
* Documentation</a> for information about standard algorithm names.
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the {@code JarSigner.Builder} itself.
* @throws NoSuchAlgorithmException if {@code algorithm} is not available.
* @throws IllegalArgumentException if {@code algorithm} is not
@ -254,6 +257,7 @@ public final class JarSigner {
* Java Cryptography Architecture Standard Algorithm Name
* Documentation</a> for information about standard algorithm names.
* @param provider the provider.
* @spec security/standard-names.html Java Security Standard Algorithm Names
* @return the {@code JarSigner.Builder} itself.
* @throws NoSuchAlgorithmException if {@code algorithm} is not
* available in the specified provider.