diff --git a/jdk/src/share/classes/java/security/Signature.java b/jdk/src/share/classes/java/security/Signature.java index 2306eb4560..3c02f455c0 100644 --- a/jdk/src/share/classes/java/security/Signature.java +++ b/jdk/src/share/classes/java/security/Signature.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1996, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1996, 2022, 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 @@ -592,8 +592,6 @@ public final void initVerify(Certificate certificate) * is not encoded properly or does not include required parameter * information or cannot be used for digital signature purposes. * @exception InvalidAlgorithmParameterException if the params is invalid. - * - * @since 8 */ final void initVerify(Certificate certificate, AlgorithmParameterSpec params) diff --git a/jdk/src/share/classes/java/security/interfaces/RSAKey.java b/jdk/src/share/classes/java/security/interfaces/RSAKey.java index 6e03cf64dd..6021b18971 100644 --- a/jdk/src/share/classes/java/security/interfaces/RSAKey.java +++ b/jdk/src/share/classes/java/security/interfaces/RSAKey.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1999, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1999, 2022, 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 @@ -56,6 +56,7 @@ public interface RSAKey { * explicitly specified or implicitly created during * key pair generation. * + * @apiNote This method is defined in Java SE 8 Maintenance Release 3. * @implSpec * The default implementation returns {@code null}. * diff --git a/jdk/src/share/classes/java/security/spec/MGF1ParameterSpec.java b/jdk/src/share/classes/java/security/spec/MGF1ParameterSpec.java index 97730c3f2b..313c36c318 100644 --- a/jdk/src/share/classes/java/security/spec/MGF1ParameterSpec.java +++ b/jdk/src/share/classes/java/security/spec/MGF1ParameterSpec.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2022, 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 @@ -98,12 +98,18 @@ public class MGF1ParameterSpec implements AlgorithmParameterSpec { /** * The MGF1ParameterSpec which uses SHA-512/224 message digest + * + * @apiNote This field is defined in Java SE 8 Maintenance Release 3. + * @since 8 */ public static final MGF1ParameterSpec SHA512_224 = new MGF1ParameterSpec("SHA-512/224"); /** * The MGF1ParameterSpec which uses SHA-512/256 message digest + * + * @apiNote This field is defined in Java SE 8 Maintenance Release 3. + * @since 8 */ public static final MGF1ParameterSpec SHA512_256 = new MGF1ParameterSpec("SHA-512/256"); diff --git a/jdk/src/share/classes/java/security/spec/PSSParameterSpec.java b/jdk/src/share/classes/java/security/spec/PSSParameterSpec.java index 91d033f012..e608886b0a 100644 --- a/jdk/src/share/classes/java/security/spec/PSSParameterSpec.java +++ b/jdk/src/share/classes/java/security/spec/PSSParameterSpec.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2001, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2001, 2022, 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 @@ public class PSSParameterSpec implements AlgorithmParameterSpec { /** * The {@code TrailerFieldBC} constant as defined in PKCS#1 * + * @apiNote This field is defined in Java SE 8 Maintenance Release 3. * @since 8 */ public static final int TRAILER_FIELD_BC = 1; diff --git a/jdk/src/share/classes/java/security/spec/RSAKeyGenParameterSpec.java b/jdk/src/share/classes/java/security/spec/RSAKeyGenParameterSpec.java index fa53afb582..56afac6e8a 100644 --- a/jdk/src/share/classes/java/security/spec/RSAKeyGenParameterSpec.java +++ b/jdk/src/share/classes/java/security/spec/RSAKeyGenParameterSpec.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1999, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1999, 2022, 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 @@ -70,6 +70,7 @@ public RSAKeyGenParameterSpec(int keysize, BigInteger publicExponent) { * Constructs a new {@code RSAKeyGenParameterSpec} object from the * given keysize, public-exponent value, and key parameters. * + * @apiNote This method is defined in Java SE 8 Maintenance Release 3. * @param keysize the modulus size (specified in number of bits) * @param publicExponent the public exponent * @param keyParams the key parameters, may be null @@ -103,6 +104,7 @@ public BigInteger getPublicExponent() { /** * Returns the parameters to be associated with key. * + * @apiNote This method is defined in Java SE 8 Maintenance Release 3. * @return the associated parameters, may be null if * not present * @since 8 diff --git a/jdk/src/share/classes/java/security/spec/RSAMultiPrimePrivateCrtKeySpec.java b/jdk/src/share/classes/java/security/spec/RSAMultiPrimePrivateCrtKeySpec.java index 4a911f120e..650f91629a 100644 --- a/jdk/src/share/classes/java/security/spec/RSAMultiPrimePrivateCrtKeySpec.java +++ b/jdk/src/share/classes/java/security/spec/RSAMultiPrimePrivateCrtKeySpec.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2001, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2001, 2022, 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 @@ -104,6 +104,7 @@ public RSAMultiPrimePrivateCrtKeySpec(BigInteger modulus, * are copied to protect against subsequent modification when * constructing this object. * + * @apiNote This method is defined in Java SE 8 Maintenance Release 3. * @param modulus the modulus n * @param publicExponent the public exponent e * @param privateExponent the private exponent d diff --git a/jdk/src/share/classes/java/security/spec/RSAPrivateCrtKeySpec.java b/jdk/src/share/classes/java/security/spec/RSAPrivateCrtKeySpec.java index 7e18e75f67..636c41ef02 100644 --- a/jdk/src/share/classes/java/security/spec/RSAPrivateCrtKeySpec.java +++ b/jdk/src/share/classes/java/security/spec/RSAPrivateCrtKeySpec.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1998, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1998, 2022, 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 @@ -81,6 +81,7 @@ public RSAPrivateCrtKeySpec(BigInteger modulus, * Creates a new {@code RSAPrivateCrtKeySpec} with additional * key parameters. * + * @apiNote This method is defined in Java SE 8 Maintenance Release 3. * @param modulus the modulus n * @param publicExponent the public exponent e * @param privateExponent the private exponent d diff --git a/jdk/src/share/classes/java/security/spec/RSAPrivateKeySpec.java b/jdk/src/share/classes/java/security/spec/RSAPrivateKeySpec.java index 4584ff41ce..f0d7662010 100644 --- a/jdk/src/share/classes/java/security/spec/RSAPrivateKeySpec.java +++ b/jdk/src/share/classes/java/security/spec/RSAPrivateKeySpec.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1998, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1998, 2022, 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 @@ -60,6 +60,7 @@ public RSAPrivateKeySpec(BigInteger modulus, BigInteger privateExponent) { /** * Creates a new RSAPrivateKeySpec with additional key parameters. * + * @apiNote This method is defined in Java SE 8 Maintenance Release 3. * @param modulus the modulus * @param privateExponent the private exponent * @param params the parameters associated with this key, may be null @@ -94,6 +95,7 @@ public BigInteger getPrivateExponent() { * Returns the parameters associated with this key, may be null if not * present. * + * @apiNote This method is defined in Java SE 8 Maintenance Release 3. * @return the parameters associated with this key * @since 8 */ diff --git a/jdk/src/share/classes/java/security/spec/RSAPublicKeySpec.java b/jdk/src/share/classes/java/security/spec/RSAPublicKeySpec.java index 5efecb5d32..7f7bad3c3e 100644 --- a/jdk/src/share/classes/java/security/spec/RSAPublicKeySpec.java +++ b/jdk/src/share/classes/java/security/spec/RSAPublicKeySpec.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1998, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1998, 2022, 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 @@ -60,6 +60,7 @@ public RSAPublicKeySpec(BigInteger modulus, BigInteger publicExponent) { /** * Creates a new RSAPublicKeySpec with additional key parameters. * + * @apiNote This method is defined in Java SE 8 Maintenance Release 3. * @param modulus the modulus * @param publicExponent the public exponent * @param params the parameters associated with this key, may be null @@ -95,6 +96,7 @@ public BigInteger getPublicExponent() { * Returns the parameters associated with this key, may be null if not * present. * + * @apiNote This method is defined in Java SE 8 Maintenance Release 3. * @return the parameters associated with this key * @since 8 */ diff --git a/jdk/src/share/classes/javax/net/ssl/SSLEngine.java b/jdk/src/share/classes/javax/net/ssl/SSLEngine.java index 80da84a4e0..56961cda9d 100644 --- a/jdk/src/share/classes/javax/net/ssl/SSLEngine.java +++ b/jdk/src/share/classes/javax/net/ssl/SSLEngine.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2022, 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 @@ -1265,6 +1265,7 @@ public void setSSLParameters(SSLParameters params) { * Application-Layer Protocol Negotiation (ALPN), can negotiate * application-level values between peers. * + * @apiNote This method is defined in Java SE 8 Maintenance Release 3. * @implSpec * The implementation in this class throws * {@code UnsupportedOperationException} and performs no other action. @@ -1290,6 +1291,7 @@ public String getApplicationProtocol() { * a connection may be in the middle of a handshake. The * application protocol may or may not yet be available. * + * @apiNote This method is defined in Java SE 8 Maintenance Release 3. * @implSpec * The implementation in this class throws * {@code UnsupportedOperationException} and performs no other action. @@ -1350,7 +1352,8 @@ public String getHandshakeApplicationProtocol() { * }); * } * - * @apiNote + * @apiNote This method is defined in Java SE 8 Maintenance Release 3. + *

* This method should be called by TLS server applications before the TLS * handshake begins. Also, this {@code SSLEngine} should be configured with * parameters that are compatible with the application protocol selected by @@ -1380,6 +1383,7 @@ public void setHandshakeApplicationProtocolSelector( * setHandshakeApplicationProtocolSelector} * for the function's type parameters. * + * @apiNote This method is defined in Java SE 8 Maintenance Release 3. * @implSpec * The implementation in this class throws * {@code UnsupportedOperationException} and performs no other action. diff --git a/jdk/src/share/classes/javax/net/ssl/SSLParameters.java b/jdk/src/share/classes/javax/net/ssl/SSLParameters.java index 92d9a55530..d213558e8b 100644 --- a/jdk/src/share/classes/javax/net/ssl/SSLParameters.java +++ b/jdk/src/share/classes/javax/net/ssl/SSLParameters.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2022, 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 @@ -486,6 +486,7 @@ public final boolean getUseCipherSuitesOrder() { *

* This method will return a new array each time it is invoked. * + * @apiNote This method is defined in Java SE 8 Maintenance Release 3. * @return a non-null, possibly zero-length array of application protocol * {@code String}s. The array is ordered based on protocol * preference, with {@code protocols[0]} being the most preferred. @@ -518,6 +519,7 @@ public String[] getApplicationProtocols() { * action to take. (For example, ALPN will send a * {@code "no_application_protocol"} alert and terminate the connection.) * + * @apiNote This method is defined in Java SE 8 Maintenance Release 3. * @implSpec * This method will make a copy of the {@code protocols} array. * diff --git a/jdk/src/share/classes/javax/net/ssl/SSLSocket.java b/jdk/src/share/classes/javax/net/ssl/SSLSocket.java index 263f342e85..7ecd47c835 100644 --- a/jdk/src/share/classes/javax/net/ssl/SSLSocket.java +++ b/jdk/src/share/classes/javax/net/ssl/SSLSocket.java @@ -1,5 +1,5 @@ /* - * Copyright (c) 1997, 2019, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997, 2022, 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 @@ -674,6 +674,7 @@ public void setSSLParameters(SSLParameters params) { * Application-Layer Protocol Negotiation (ALPN), can negotiate * application-level values between peers. * + * @apiNote This method is defined in Java SE 8 Maintenance Release 3. * @implSpec * The implementation in this class throws * {@code UnsupportedOperationException} and performs no other action. @@ -699,6 +700,7 @@ public String getApplicationProtocol() { * a connection may be in the middle of a handshake. The * application protocol may or may not yet be available. * + * @apiNote This method is defined in Java SE 8 Maintenance Release 3. * @implSpec * The implementation in this class throws * {@code UnsupportedOperationException} and performs no other action. @@ -760,7 +762,8 @@ public String getHandshakeApplicationProtocol() { * }); * } * - * @apiNote + * @apiNote This method is defined in Java SE 8 Maintenance Release 3. + *

* This method should be called by TLS server applications before the TLS * handshake begins. Also, this {@code SSLSocket} should be configured with * parameters that are compatible with the application protocol selected by @@ -789,6 +792,7 @@ public void setHandshakeApplicationProtocolSelector( * setHandshakeApplicationProtocolSelector} * for the function's type parameters. * + * @apiNote This method is defined in Java SE 8 Maintenance Release 3. * @implSpec * The implementation in this class throws * {@code UnsupportedOperationException} and performs no other action.