diff --git a/src/java.base/share/classes/java/security/AlgorithmParameterGenerator.java b/src/java.base/share/classes/java/security/AlgorithmParameterGenerator.java index cec473cef96..0410179550b 100644 --- a/src/java.base/share/classes/java/security/AlgorithmParameterGenerator.java +++ b/src/java.base/share/classes/java/security/AlgorithmParameterGenerator.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1997, 2022, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -88,6 +88,7 @@ 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 * 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 diff --git a/src/java.base/share/classes/java/security/AlgorithmParameters.java b/src/java.base/share/classes/java/security/AlgorithmParameters.java index 7747d642c20..defe25571f7 100644 --- a/src/java.base/share/classes/java/security/AlgorithmParameters.java +++ b/src/java.base/share/classes/java/security/AlgorithmParameters.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -69,6 +69,7 @@ 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 * 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} diff --git a/src/java.base/share/classes/java/security/DrbgParameters.java b/src/java.base/share/classes/java/security/DrbgParameters.java index 4bcb179feca..5cd8b171c72 100644 --- a/src/java.base/share/classes/java/security/DrbgParameters.java +++ b/src/java.base/share/classes/java/security/DrbgParameters.java @@ -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 */ diff --git a/src/java.base/share/classes/java/security/KeyFactory.java b/src/java.base/share/classes/java/security/KeyFactory.java index 7c51faf6aa2..8eaf72f1b83 100644 --- a/src/java.base/share/classes/java/security/KeyFactory.java +++ b/src/java.base/share/classes/java/security/KeyFactory.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -84,6 +84,7 @@ 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 * 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 diff --git a/src/java.base/share/classes/java/security/KeyPairGenerator.java b/src/java.base/share/classes/java/security/KeyPairGenerator.java index 3583248f81e..6d7148a76f5 100644 --- a/src/java.base/share/classes/java/security/KeyPairGenerator.java +++ b/src/java.base/share/classes/java/security/KeyPairGenerator.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -131,6 +131,7 @@ 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 * 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 * 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 * 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 * 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 diff --git a/src/java.base/share/classes/java/security/KeyStore.java b/src/java.base/share/classes/java/security/KeyStore.java index b420cc69aa6..9e50a1588e7 100644 --- a/src/java.base/share/classes/java/security/KeyStore.java +++ b/src/java.base/share/classes/java/security/KeyStore.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -183,6 +183,7 @@ 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 * 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 diff --git a/src/java.base/share/classes/java/security/MessageDigest.java b/src/java.base/share/classes/java/security/MessageDigest.java index f83c4ed6d3b..fa8d3dea8fd 100644 --- a/src/java.base/share/classes/java/security/MessageDigest.java +++ b/src/java.base/share/classes/java/security/MessageDigest.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1996, 2024, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1996, 2025, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -96,6 +96,7 @@ 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 * 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 * 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 * 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() { diff --git a/src/java.base/share/classes/java/security/SecureRandom.java b/src/java.base/share/classes/java/security/SecureRandom.java index e6cc1134c09..e53341be9da 100644 --- a/src/java.base/share/classes/java/security/SecureRandom.java +++ b/src/java.base/share/classes/java/security/SecureRandom.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1996, 2024, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1996, 2025, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -144,7 +144,7 @@ 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 * 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 * 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 diff --git a/src/java.base/share/classes/java/security/SecureRandomSpi.java b/src/java.base/share/classes/java/security/SecureRandomSpi.java index 3185f61720a..4c7c58cae11 100644 --- a/src/java.base/share/classes/java/security/SecureRandomSpi.java +++ b/src/java.base/share/classes/java/security/SecureRandomSpi.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1998, 2022, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1998, 2025, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -79,6 +79,7 @@ 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 */ diff --git a/src/java.base/share/classes/java/security/Signature.java b/src/java.base/share/classes/java/security/Signature.java index 006188aac61..52aa4328b2c 100644 --- a/src/java.base/share/classes/java/security/Signature.java +++ b/src/java.base/share/classes/java/security/Signature.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1996, 2024, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1996, 2025, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -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 * 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 * 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} diff --git a/src/java.base/share/classes/java/security/cert/CertPath.java b/src/java.base/share/classes/java/security/cert/CertPath.java index ffbbf0291b1..54c47c36119 100644 --- a/src/java.base/share/classes/java/security/cert/CertPath.java +++ b/src/java.base/share/classes/java/security/cert/CertPath.java @@ -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 * diff --git a/src/java.base/share/classes/java/security/cert/CertPathBuilder.java b/src/java.base/share/classes/java/security/cert/CertPathBuilder.java index de1a86312c4..692bfa0fb8e 100644 --- a/src/java.base/share/classes/java/security/cert/CertPathBuilder.java +++ b/src/java.base/share/classes/java/security/cert/CertPathBuilder.java @@ -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 * 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 * diff --git a/src/java.base/share/classes/java/security/cert/CertPathValidator.java b/src/java.base/share/classes/java/security/cert/CertPathValidator.java index c79283b536f..539bee34192 100644 --- a/src/java.base/share/classes/java/security/cert/CertPathValidator.java +++ b/src/java.base/share/classes/java/security/cert/CertPathValidator.java @@ -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 * 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 * diff --git a/src/java.base/share/classes/java/security/cert/CertStore.java b/src/java.base/share/classes/java/security/cert/CertStore.java index 3801a1fbcaf..ce213a7c2e8 100644 --- a/src/java.base/share/classes/java/security/cert/CertStore.java +++ b/src/java.base/share/classes/java/security/cert/CertStore.java @@ -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 * diff --git a/src/java.base/share/classes/java/security/cert/Certificate.java b/src/java.base/share/classes/java/security/cert/Certificate.java index 618026c894d..50e70da0689 100644 --- a/src/java.base/share/classes/java/security/cert/Certificate.java +++ b/src/java.base/share/classes/java/security/cert/Certificate.java @@ -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 * for information about standard certificate types. + * @spec security/standard-names.html Java Security Standard Algorithm Names */ protected Certificate(String type) { this.type = type; diff --git a/src/java.base/share/classes/java/security/cert/CertificateFactory.java b/src/java.base/share/classes/java/security/cert/CertificateFactory.java index fb47ca29af1..3ee375c163c 100644 --- a/src/java.base/share/classes/java/security/cert/CertificateFactory.java +++ b/src/java.base/share/classes/java/security/cert/CertificateFactory.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1998, 2022, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1998, 2025, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -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 * 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 diff --git a/src/java.base/share/classes/java/security/cert/CertificateFactorySpi.java b/src/java.base/share/classes/java/security/cert/CertificateFactorySpi.java index 7a782dcc659..1bf346198e6 100644 --- a/src/java.base/share/classes/java/security/cert/CertificateFactorySpi.java +++ b/src/java.base/share/classes/java/security/cert/CertificateFactorySpi.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1998, 2022, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1998, 2025, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -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 diff --git a/src/java.base/share/classes/java/security/spec/ECGenParameterSpec.java b/src/java.base/share/classes/java/security/spec/ECGenParameterSpec.java index 4d506726c9f..553793fa469 100644 --- a/src/java.base/share/classes/java/security/spec/ECGenParameterSpec.java +++ b/src/java.base/share/classes/java/security/spec/ECGenParameterSpec.java @@ -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 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) { diff --git a/src/java.base/share/classes/java/security/spec/EncodedKeySpec.java b/src/java.base/share/classes/java/security/spec/EncodedKeySpec.java index 8bb23d08df3..7ddc9bf8e03 100644 --- a/src/java.base/share/classes/java/security/spec/EncodedKeySpec.java +++ b/src/java.base/share/classes/java/security/spec/EncodedKeySpec.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1997, 2022, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -79,6 +79,7 @@ public abstract class EncodedKeySpec implements KeySpec { * "{@docRoot}/../specs/security/standard-names.html#keyfactory-algorithms"> * Java Security Standard Algorithm Names Specification * 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 diff --git a/src/java.base/share/classes/java/security/spec/NamedParameterSpec.java b/src/java.base/share/classes/java/security/spec/NamedParameterSpec.java index d50426b6ccf..c4091705df0 100644 --- a/src/java.base/share/classes/java/security/spec/NamedParameterSpec.java +++ b/src/java.base/share/classes/java/security/spec/NamedParameterSpec.java @@ -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. * + * @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 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) { diff --git a/src/java.base/share/classes/java/security/spec/PKCS8EncodedKeySpec.java b/src/java.base/share/classes/java/security/spec/PKCS8EncodedKeySpec.java index 73d79a41321..799de359956 100644 --- a/src/java.base/share/classes/java/security/spec/PKCS8EncodedKeySpec.java +++ b/src/java.base/share/classes/java/security/spec/PKCS8EncodedKeySpec.java @@ -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 * 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 diff --git a/src/java.base/share/classes/java/security/spec/PSSParameterSpec.java b/src/java.base/share/classes/java/security/spec/PSSParameterSpec.java index a05ce1b4b7a..504154b2360 100644 --- a/src/java.base/share/classes/java/security/spec/PSSParameterSpec.java +++ b/src/java.base/share/classes/java/security/spec/PSSParameterSpec.java @@ -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 diff --git a/src/java.base/share/classes/java/security/spec/X509EncodedKeySpec.java b/src/java.base/share/classes/java/security/spec/X509EncodedKeySpec.java index 7de4a2a1417..e9801f6f7f3 100644 --- a/src/java.base/share/classes/java/security/spec/X509EncodedKeySpec.java +++ b/src/java.base/share/classes/java/security/spec/X509EncodedKeySpec.java @@ -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 * 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 diff --git a/src/java.base/share/classes/javax/crypto/Cipher.java b/src/java.base/share/classes/javax/crypto/Cipher.java index 8187f863b5c..3de732c6687 100644 --- a/src/java.base/share/classes/javax/crypto/Cipher.java +++ b/src/java.base/share/classes/javax/crypto/Cipher.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -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 * 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 * diff --git a/src/java.base/share/classes/javax/crypto/ExemptionMechanism.java b/src/java.base/share/classes/javax/crypto/ExemptionMechanism.java index d360b3577a0..63686b8433f 100644 --- a/src/java.base/share/classes/javax/crypto/ExemptionMechanism.java +++ b/src/java.base/share/classes/javax/crypto/ExemptionMechanism.java @@ -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 * 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} diff --git a/src/java.base/share/classes/javax/crypto/KDF.java b/src/java.base/share/classes/javax/crypto/KDF.java index 0ee0904c1c2..9859bd47787 100644 --- a/src/java.base/share/classes/javax/crypto/KDF.java +++ b/src/java.base/share/classes/javax/crypto/KDF.java @@ -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 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 diff --git a/src/java.base/share/classes/javax/crypto/KEM.java b/src/java.base/share/classes/javax/crypto/KEM.java index 3cb053c194c..287efc75371 100644 --- a/src/java.base/share/classes/javax/crypto/KEM.java +++ b/src/java.base/share/classes/javax/crypto/KEM.java @@ -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 * 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, diff --git a/src/java.base/share/classes/javax/crypto/KeyAgreement.java b/src/java.base/share/classes/javax/crypto/KeyAgreement.java index 5e2ceb185aa..e3a68e88d03 100644 --- a/src/java.base/share/classes/javax/crypto/KeyAgreement.java +++ b/src/java.base/share/classes/javax/crypto/KeyAgreement.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -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 * 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} diff --git a/src/java.base/share/classes/javax/crypto/KeyGenerator.java b/src/java.base/share/classes/javax/crypto/KeyGenerator.java index ad112e6ffeb..02d0bd75753 100644 --- a/src/java.base/share/classes/javax/crypto/KeyGenerator.java +++ b/src/java.base/share/classes/javax/crypto/KeyGenerator.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -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 * 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} diff --git a/src/java.base/share/classes/javax/crypto/Mac.java b/src/java.base/share/classes/javax/crypto/Mac.java index d4de87304b3..fb1eb2c310a 100644 --- a/src/java.base/share/classes/javax/crypto/Mac.java +++ b/src/java.base/share/classes/javax/crypto/Mac.java @@ -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 * 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 diff --git a/src/java.base/share/classes/javax/crypto/SecretKeyFactory.java b/src/java.base/share/classes/javax/crypto/SecretKeyFactory.java index 1156c40b77c..49b8605ad4d 100644 --- a/src/java.base/share/classes/javax/crypto/SecretKeyFactory.java +++ b/src/java.base/share/classes/javax/crypto/SecretKeyFactory.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -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 * 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} diff --git a/src/java.base/share/classes/javax/net/ssl/KeyManagerFactory.java b/src/java.base/share/classes/javax/net/ssl/KeyManagerFactory.java index 4ff8d35f717..652a20c8377 100644 --- a/src/java.base/share/classes/javax/net/ssl/KeyManagerFactory.java +++ b/src/java.base/share/classes/javax/net/ssl/KeyManagerFactory.java @@ -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} diff --git a/src/java.base/share/classes/javax/net/ssl/SSLContext.java b/src/java.base/share/classes/javax/net/ssl/SSLContext.java index 861c7645b73..b8759d0414d 100644 --- a/src/java.base/share/classes/javax/net/ssl/SSLContext.java +++ b/src/java.base/share/classes/javax/net/ssl/SSLContext.java @@ -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 * 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} diff --git a/src/java.base/share/classes/javax/net/ssl/SSLEngine.java b/src/java.base/share/classes/javax/net/ssl/SSLEngine.java index 6d066ea5ca9..228750e080c 100644 --- a/src/java.base/share/classes/javax/net/ssl/SSLEngine.java +++ b/src/java.base/share/classes/javax/net/ssl/SSLEngine.java @@ -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. diff --git a/src/java.base/share/classes/javax/net/ssl/SSLParameters.java b/src/java.base/share/classes/javax/net/ssl/SSLParameters.java index e1f43994064..88fa6924899 100644 --- a/src/java.base/share/classes/javax/net/ssl/SSLParameters.java +++ b/src/java.base/share/classes/javax/net/ssl/SSLParameters.java @@ -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}. diff --git a/src/java.base/share/classes/javax/net/ssl/SSLServerSocket.java b/src/java.base/share/classes/javax/net/ssl/SSLServerSocket.java index b4afed41a1b..71cb304edbc 100644 --- a/src/java.base/share/classes/javax/net/ssl/SSLServerSocket.java +++ b/src/java.base/share/classes/javax/net/ssl/SSLServerSocket.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -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[]) diff --git a/src/java.base/share/classes/javax/net/ssl/SSLServerSocketFactory.java b/src/java.base/share/classes/javax/net/ssl/SSLServerSocketFactory.java index 22f64f98f29..6a35a34e5f4 100644 --- a/src/java.base/share/classes/javax/net/ssl/SSLServerSocketFactory.java +++ b/src/java.base/share/classes/javax/net/ssl/SSLServerSocketFactory.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1997, 2022, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -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() */ diff --git a/src/java.base/share/classes/javax/net/ssl/SSLSocket.java b/src/java.base/share/classes/javax/net/ssl/SSLSocket.java index a77968ada16..a18c203320d 100644 --- a/src/java.base/share/classes/javax/net/ssl/SSLSocket.java +++ b/src/java.base/share/classes/javax/net/ssl/SSLSocket.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -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. diff --git a/src/java.base/share/classes/javax/net/ssl/SSLSocketFactory.java b/src/java.base/share/classes/javax/net/ssl/SSLSocketFactory.java index b90a9d4c25c..6d0815ef80d 100644 --- a/src/java.base/share/classes/javax/net/ssl/SSLSocketFactory.java +++ b/src/java.base/share/classes/javax/net/ssl/SSLSocketFactory.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997, 2025, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -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 */ diff --git a/src/java.base/share/classes/javax/net/ssl/TrustManagerFactory.java b/src/java.base/share/classes/javax/net/ssl/TrustManagerFactory.java index af08d97f0d2..76c76806403 100644 --- a/src/java.base/share/classes/javax/net/ssl/TrustManagerFactory.java +++ b/src/java.base/share/classes/javax/net/ssl/TrustManagerFactory.java @@ -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} diff --git a/src/java.base/share/classes/javax/security/auth/login/Configuration.java b/src/java.base/share/classes/javax/security/auth/login/Configuration.java index bebf5f6901a..6e69d0746ff 100644 --- a/src/java.base/share/classes/javax/security/auth/login/Configuration.java +++ b/src/java.base/share/classes/javax/security/auth/login/Configuration.java @@ -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 * 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} diff --git a/src/java.management/share/classes/com/sun/jmx/remote/security/HashedPasswordManager.java b/src/java.management/share/classes/com/sun/jmx/remote/security/HashedPasswordManager.java index c50b22fade6..a247ba66533 100644 --- a/src/java.management/share/classes/com/sun/jmx/remote/security/HashedPasswordManager.java +++ b/src/java.management/share/classes/com/sun/jmx/remote/security/HashedPasswordManager.java @@ -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 { diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/TransformService.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/TransformService.java index bf5486f4d32..9040552beb7 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/TransformService.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/TransformService.java @@ -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 * TransformService 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 for a list of * standard mechanism types. + * @spec security/standard-names.html Java Security Standard Algorithm Names * @return a new TransformService * @throws NullPointerException if algorithm or * mechanismType is null @@ -215,6 +217,7 @@ public abstract class TransformService implements Transform { * Java Security Standard Algorithm Names Specification for a list of * standard mechanism types. * @param provider the Provider object + * @spec security/standard-names.html Java Security Standard Algorithm Names * @return a new TransformService * @throws NullPointerException if provider, * algorithm, or mechanismType is @@ -277,6 +280,7 @@ public abstract class TransformService implements Transform { * Java Security Standard Algorithm Names Specification 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 TransformService * @throws NoSuchProviderException if the specified provider is not * registered in the security provider list diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/XMLSignatureFactory.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/XMLSignatureFactory.java index 07fb9a271f2..4af0591691a 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/XMLSignatureFactory.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/XMLSignatureFactory.java @@ -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 * XMLSignatureFactory 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 for a list of * standard mechanism types. + * @spec security/standard-names.html Java Security Standard Algorithm Names * @return a new XMLSignatureFactory * @throws NullPointerException if mechanismType is * null @@ -234,6 +236,7 @@ public abstract class XMLSignatureFactory { * Java Security Standard Algorithm Names Specification for a list of * standard mechanism types. * @param provider the Provider object + * @spec security/standard-names.html Java Security Standard Algorithm Names * @return a new XMLSignatureFactory * @throws NullPointerException if provider or * mechanismType is null @@ -287,6 +290,7 @@ public abstract class XMLSignatureFactory { * Java Security Standard Algorithm Names Specification 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 XMLSignatureFactory * @throws NoSuchProviderException if the specified provider is not * registered in the security provider list diff --git a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/KeyInfoFactory.java b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/KeyInfoFactory.java index be5e4cef367..09f8a12e486 100644 --- a/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/KeyInfoFactory.java +++ b/src/java.xml.crypto/share/classes/javax/xml/crypto/dsig/keyinfo/KeyInfoFactory.java @@ -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 KeyInfoFactory * 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 for a list * of standard mechanism types. + * @spec security/standard-names.html Java Security Standard Algorithm Names * @return a new KeyInfoFactory * @throws NullPointerException if mechanismType is * null @@ -189,6 +191,7 @@ public abstract class KeyInfoFactory { * Java Security Standard Algorithm Names Specification for a list * of standard mechanism types. * @param provider the Provider object + * @spec security/standard-names.html Java Security Standard Algorithm Names * @return a new KeyInfoFactory * @throws NullPointerException if mechanismType or * provider are null @@ -241,6 +244,7 @@ public abstract class KeyInfoFactory { * Java Security Standard Algorithm Names Specification 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 KeyInfoFactory * @throws NoSuchProviderException if the specified provider is not * registered in the security provider list diff --git a/src/jdk.jartool/share/classes/jdk/security/jarsigner/JarSigner.java b/src/jdk.jartool/share/classes/jdk/security/jarsigner/JarSigner.java index 3ff0f2663a2..97ccd65dd05 100644 --- a/src/jdk.jartool/share/classes/jdk/security/jarsigner/JarSigner.java +++ b/src/jdk.jartool/share/classes/jdk/security/jarsigner/JarSigner.java @@ -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 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 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 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 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.