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

8230648: Replace @exception tag with @throws in java.base

Browse source 
Minor coding style update of javadoc tag in any file in java.base

Reviewed-by: prappo, lancea
This commit is contained in:
Julia Boes 2019-09-20 11:07:52 +01:00
parent 2fc6c6459d
commit b15b322cf3
196 changed files with 1959 additions and 1962 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,5 +1,5 @@
/*
* Copyright (c) 1997, 2015, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1997, 2019, 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
@ -162,10 +162,10 @@ public final class AccessControlContext {
* @param combiner the {@code DomainCombiner} to be associated
* with the provided {@code AccessControlContext}.
*
* @exception NullPointerException if the provided
* @throws NullPointerException if the provided
* {@code context} is {@code null}.
*
* @exception SecurityException if a security manager is installed and the
* @throws SecurityException if a security manager is installed and the
* caller does not have the "createAccessControlContext"
* {@link SecurityPermission}
* @since 1.3
@ -344,7 +344,7 @@ public final class AccessControlContext {
* {@code AccessControlContext}, or {@code null}
* if there is none.
*
* @exception SecurityException if a security manager is installed and
* @throws SecurityException if a security manager is installed and
* the caller does not have the "getDomainCombiner"
* {@link SecurityPermission}
* @since 1.3
@ -383,10 +383,10 @@ public final class AccessControlContext {
*
* @param perm the requested permission.
*
* @exception AccessControlException if the specified permission
* @throws AccessControlException if the specified permission
* is not permitted, based on the current security policy and the
* context encapsulated by this object.
* @exception NullPointerException if the permission to check for is null.
* @throws NullPointerException if the permission to check for is null.
*/
public void checkPermission(Permission perm)
throws AccessControlException

22
src/java.base/share/classes/java/security/AccessController.java
View file

@ -298,7 +298,7 @@ public final class AccessController {
*
* @return the value returned by the action's {@code run} method.
*
* @exception NullPointerException if the action is {@code null}
* @throws NullPointerException if the action is {@code null}
*
* @see #doPrivileged(PrivilegedAction,AccessControlContext)
* @see #doPrivileged(PrivilegedExceptionAction)
@ -330,7 +330,7 @@ public final class AccessController {
*
* @return the value returned by the action's {@code run} method.
*
* @exception NullPointerException if the action is {@code null}
* @throws NullPointerException if the action is {@code null}
*
* @see #doPrivileged(PrivilegedAction)
* @see java.security.DomainCombiner
@ -377,7 +377,7 @@ public final class AccessController {
*
* @return the value returned by the action's {@code run} method.
*
* @exception NullPointerException if the action is {@code null}
* @throws NullPointerException if the action is {@code null}
*
* @see #doPrivileged(PrivilegedAction)
* @see #doPrivileged(PrivilegedExceptionAction,AccessControlContext)
@ -534,9 +534,9 @@ public final class AccessController {
*
* @return the value returned by the action's {@code run} method
*
* @exception PrivilegedActionException if the specified action's
* @throws PrivilegedActionException if the specified action's
* {@code run} method threw a <i>checked</i> exception
* @exception NullPointerException if the action is {@code null}
* @throws NullPointerException if the action is {@code null}
*
* @see #doPrivileged(PrivilegedAction)
* @see #doPrivileged(PrivilegedExceptionAction,AccessControlContext)
@ -577,9 +577,9 @@ public final class AccessController {
*
* @return the value returned by the action's {@code run} method
*
* @exception PrivilegedActionException if the specified action's
* @throws PrivilegedActionException if the specified action's
* {@code run} method threw a <i>checked</i> exception
* @exception NullPointerException if the action is {@code null}
* @throws NullPointerException if the action is {@code null}
*
* @see #doPrivileged(PrivilegedAction)
* @see #doPrivileged(PrivilegedExceptionAction,AccessControlContext)
@ -672,9 +672,9 @@ public final class AccessController {
*
* @return the value returned by the action's {@code run} method
*
* @exception PrivilegedActionException if the specified action's
* @throws PrivilegedActionException if the specified action's
* {@code run} method threw a <i>checked</i> exception
* @exception NullPointerException if the action is {@code null}
* @throws NullPointerException if the action is {@code null}
*
* @see #doPrivileged(PrivilegedAction)
* @see #doPrivileged(PrivilegedAction,AccessControlContext)
@ -990,9 +990,9 @@ public final class AccessController {
*
* @param perm the requested permission.
*
* @exception AccessControlException if the specified permission
* @throws AccessControlException if the specified permission
* is not permitted, based on the current security policy.
* @exception NullPointerException if the specified permission
* @throws NullPointerException if the specified permission
* is {@code null} and is checked based on the
* security policy currently in effect.
*/

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

@ -1,5 +1,5 @@
/*
* Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1997, 2019, 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
@ -334,7 +334,7 @@ public class AlgorithmParameterGenerator {
*
* @param genParamSpec the set of algorithm-specific parameter generation values.
*
* @exception InvalidAlgorithmParameterException if the given parameter
* @throws InvalidAlgorithmParameterException if the given parameter
* generation values are inappropriate for this parameter generator.
*/
public final void init(AlgorithmParameterSpec genParamSpec)
@ -349,7 +349,7 @@ public class AlgorithmParameterGenerator {
* @param genParamSpec the set of algorithm-specific parameter generation values.
* @param random the source of randomness.
*
* @exception InvalidAlgorithmParameterException if the given parameter
* @throws InvalidAlgorithmParameterException if the given parameter
* generation values are inappropriate for this parameter generator.
*/
public final void init(AlgorithmParameterSpec genParamSpec,

4
src/java.base/share/classes/java/security/AlgorithmParameterGeneratorSpi.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1997, 2019, 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
@ -76,7 +76,7 @@ public abstract class AlgorithmParameterGeneratorSpi {
* @param genParamSpec the set of algorithm-specific parameter generation values.
* @param random the source of randomness.
*
* @exception InvalidAlgorithmParameterException if the given parameter
* @throws InvalidAlgorithmParameterException if the given parameter
* generation values are inappropriate for this parameter generator.
*/
protected abstract void engineInit(AlgorithmParameterSpec genParamSpec,

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

@ -1,5 +1,5 @@
/*
* Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1997, 2019, 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
@ -282,7 +282,7 @@ public class AlgorithmParameters {
*
* @param paramSpec the parameter specification.
*
* @exception InvalidParameterSpecException if the given parameter
* @throws InvalidParameterSpecException if the given parameter
* specification is inappropriate for the initialization of this parameter
* object, or if this parameter object has already been initialized.
*/
@ -303,7 +303,7 @@ public class AlgorithmParameters {
*
* @param params the encoded parameters.
*
* @exception IOException on decoding errors, or if this parameter object
* @throws IOException on decoding errors, or if this parameter object
* has already been initialized.
*/
public final void init(byte[] params) throws IOException {
@ -325,7 +325,7 @@ public class AlgorithmParameters {
*
* @param format the name of the decoding scheme.
*
* @exception IOException on decoding errors, or if this parameter object
* @throws IOException on decoding errors, or if this parameter object
* has already been initialized.
*/
public final void init(byte[] params, String format) throws IOException {
@ -349,7 +349,7 @@ public class AlgorithmParameters {
*
* @return the parameter specification.
*
* @exception InvalidParameterSpecException if the requested parameter
* @throws InvalidParameterSpecException if the requested parameter
* specification is inappropriate for this parameter object, or if this
* parameter object has not been initialized.
*/
@ -370,7 +370,7 @@ public class AlgorithmParameters {
*
* @return the parameters encoded using their primary encoding format.
*
* @exception IOException on encoding errors, or if this parameter object
* @throws IOException on encoding errors, or if this parameter object
* has not been initialized.
*/
public final byte[] getEncoded() throws IOException
@ -392,7 +392,7 @@ public class AlgorithmParameters {
*
* @return the parameters encoded using the specified encoding scheme.
*
* @exception IOException on encoding errors, or if this parameter object
* @throws IOException on encoding errors, or if this parameter object
* has not been initialized.
*/
public final byte[] getEncoded(String format) throws IOException

14
src/java.base/share/classes/java/security/AlgorithmParametersSpi.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1997, 2019, 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,7 +56,7 @@ public abstract class AlgorithmParametersSpi {
*
* @param paramSpec the parameter specification.
*
* @exception InvalidParameterSpecException if the given parameter
* @throws InvalidParameterSpecException if the given parameter
* specification is inappropriate for the initialization of this parameter
* object.
*/
@ -71,7 +71,7 @@ public abstract class AlgorithmParametersSpi {
*
* @param params the encoded parameters.
*
* @exception IOException on decoding errors
* @throws IOException on decoding errors
*/
protected abstract void engineInit(byte[] params)
throws IOException;
@ -88,7 +88,7 @@ public abstract class AlgorithmParametersSpi {
*
* @param format the name of the decoding format.
*
* @exception IOException on decoding errors
* @throws IOException on decoding errors
*/
protected abstract void engineInit(byte[] params, String format)
throws IOException;
@ -109,7 +109,7 @@ public abstract class AlgorithmParametersSpi {
*
* @return the parameter specification.
*
* @exception InvalidParameterSpecException if the requested parameter
* @throws InvalidParameterSpecException if the requested parameter
* specification is inappropriate for this parameter object.
*/
protected abstract
@ -124,7 +124,7 @@ public abstract class AlgorithmParametersSpi {
*
* @return the parameters encoded using their primary encoding format.
*
* @exception IOException on encoding errors.
* @throws IOException on encoding errors.
*/
protected abstract byte[] engineGetEncoded() throws IOException;
@ -139,7 +139,7 @@ public abstract class AlgorithmParametersSpi {
*
* @return the parameters encoded using the specified encoding scheme.
*
* @exception IOException on encoding errors.
* @throws IOException on encoding errors.
*/
protected abstract byte[] engineGetEncoded(String format)
throws IOException;

4
src/java.base/share/classes/java/security/AllPermission.java
View file

@ -178,10 +178,10 @@ final class AllPermissionCollection
*
* @param permission the Permission object to add.
*
* @exception IllegalArgumentException - if the permission is not a
* @throws IllegalArgumentException - if the permission is not a
* AllPermission
*
* @exception SecurityException - if this AllPermissionCollection object
* @throws SecurityException - if this AllPermissionCollection object
* has been marked readonly
*/

4
src/java.base/share/classes/java/security/BasicPermission.java
View file

@ -349,13 +349,13 @@ final class BasicPermissionCollection
*
* @param permission the Permission object to add.
*
* @exception IllegalArgumentException - if the permission is not a
* @throws IllegalArgumentException - if the permission is not a
* BasicPermission, or if
* the permission is not of the
* same Class as the other
* permissions in this collection.
*
* @exception SecurityException - if this BasicPermissionCollection object
* @throws SecurityException - if this BasicPermissionCollection object
* has been marked readonly
*/
@Override

10
src/java.base/share/classes/java/security/Certificate.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1996, 2017, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1996, 2019, 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,10 +101,10 @@ public interface Certificate {
* @param stream the output stream to which to encode the
* certificate.
*
* @exception KeyException if the certificate is not
* @throws KeyException if the certificate is not
* properly initialized, or data is missing, etc.
*
* @exception IOException if a stream exception occurs while
* @throws IOException if a stream exception occurs while
* trying to output the encoded certificate to the output stream.
*
* @see #decode
@ -121,10 +121,10 @@ public interface Certificate {
* @param stream the input stream from which to fetch the data
* being decoded.
*
* @exception KeyException if the certificate is not properly initialized,
* @throws KeyException if the certificate is not properly initialized,
* or data is missing, etc.
*
* @exception IOException if an exception occurs while trying to input
* @throws IOException if an exception occurs while trying to input
* the encoded certificate from the input stream.
*
* @see #encode

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

@ -1,5 +1,5 @@
/*
* Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1996, 2019, 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
@ -117,7 +117,7 @@ public class DigestInputStream extends FilterInputStream {
*
* @return the byte read.
*
* @exception IOException if an I/O error occurs.
* @throws IOException if an I/O error occurs.
*
* @see MessageDigest#update(byte)
*/
@ -154,7 +154,7 @@ public class DigestInputStream extends FilterInputStream {
* read because the end of the stream had already been reached when
* the call was made.
*
* @exception IOException if an I/O error occurs.
* @throws IOException if an I/O error occurs.
*
* @see MessageDigest#update(byte[], int, int)
*/

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

@ -1,5 +1,5 @@
/*
* Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1996, 2019, 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
@ -108,7 +108,7 @@ public class DigestOutputStream extends FilterOutputStream {
* @param b the byte to be used for updating and writing to the
* output stream.
*
* @exception IOException if an I/O error occurs.
* @throws IOException if an I/O error occurs.
*
* @see MessageDigest#update(byte)
*/
@ -138,7 +138,7 @@ public class DigestOutputStream extends FilterOutputStream {
* @param len the number of bytes of data to be updated and written
* from {@code b}, starting at offset {@code off}.
*
* @exception IOException if an I/O error occurs.
* @throws IOException if an I/O error occurs.
*
* @see MessageDigest#update(byte[], int, int)
*/

4
src/java.base/share/classes/java/security/DomainLoadStoreParameter.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2013, 2019, 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
@ -125,7 +125,7 @@ public final class DomainLoadStoreParameter implements LoadStoreParameter {
* been specified by properties in the domain configuration data.
* It is cloned to prevent subsequent modification.
*
* @exception NullPointerException if {@code configuration} or
* @throws NullPointerException if {@code configuration} or
* {@code protectionParams} is {@code null}
*/
public DomainLoadStoreParameter(URI configuration,

4
src/java.base/share/classes/java/security/Guard.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1997, 2019, 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,7 +50,7 @@ public interface Guard {
*
* @param object the object being protected by the guard.
*
* @exception SecurityException if access is denied.
* @throws SecurityException if access is denied.
*
*/
void checkGuard(Object object) throws SecurityException;

2
src/java.base/share/classes/java/security/GuardedObject.java
View file

@ -77,7 +77,7 @@ public class GuardedObject implements java.io.Serializable {
*
* @return the guarded object.
*
* @exception SecurityException if access to the guarded object is
* @throws SecurityException if access to the guarded object is
* denied.
*/
public Object getObject()

20
src/java.base/share/classes/java/security/Identity.java
View file

@ -113,7 +113,7 @@ public abstract class Identity implements Principal, Serializable {
* @param name the identity name.
* @param scope the scope of the identity.
*
* @exception KeyManagementException if there is already an identity
* @throws KeyManagementException if there is already an identity
* with the same name in the scope.
*/
public Identity(String name, IdentityScope scope) throws
@ -173,10 +173,10 @@ public abstract class Identity implements Principal, Serializable {
*
* @param key the public key for this identity.
*
* @exception KeyManagementException if another identity in the
* @throws KeyManagementException if another identity in the
* identity's scope has the same public key, or if another exception occurs.
*
* @exception SecurityException if a security manager exists and its
* @throws SecurityException if a security manager exists and its
* {@code checkSecurityAccess} method doesn't allow
* setting the public key.
*
@ -200,7 +200,7 @@ public abstract class Identity implements Principal, Serializable {
*
* @param info the information string.
*
* @exception SecurityException if a security manager exists and its
* @throws SecurityException if a security manager exists and its
* {@code checkSecurityAccess} method doesn't allow
* setting the information string.
*
@ -235,11 +235,11 @@ public abstract class Identity implements Principal, Serializable {
*
* @param certificate the certificate to be added.
*
* @exception KeyManagementException if the certificate is not valid,
* @throws KeyManagementException if the certificate is not valid,
* if the public key in the certificate being added conflicts with
* this identity's public key, or if another exception occurs.
*
* @exception SecurityException if a security manager exists and its
* @throws SecurityException if a security manager exists and its
* {@code checkSecurityAccess} method doesn't allow
* adding a certificate.
*
@ -286,10 +286,10 @@ public abstract class Identity implements Principal, Serializable {
*
* @param certificate the certificate to be removed.
*
* @exception KeyManagementException if the certificate is
* @throws KeyManagementException if the certificate is
* missing, or if another exception occurs.
*
* @exception SecurityException if a security manager exists and its
* @throws SecurityException if a security manager exists and its
* {@code checkSecurityAccess} method doesn't allow
* removing a certificate.
*
@ -400,7 +400,7 @@ public abstract class Identity implements Principal, Serializable {
* @return information about this identity, such as its name and the
* name of its scope (if any).
*
* @exception SecurityException if a security manager exists and its
* @throws SecurityException if a security manager exists and its
* {@code checkSecurityAccess} method doesn't allow
* returning a string describing this identity.
*
@ -430,7 +430,7 @@ public abstract class Identity implements Principal, Serializable {
* is true, then this method returns more information than that
* provided by the {@code toString} method without any arguments.
*
* @exception SecurityException if a security manager exists and its
* @throws SecurityException if a security manager exists and its
* {@code checkSecurityAccess} method doesn't allow
* returning a string describing this identity.
*

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

@ -121,7 +121,7 @@ class IdentityScope extends Identity {
* @param name the scope name.
* @param scope the scope for the new identity scope.
*
* @exception KeyManagementException if there is already an identity
* @throws KeyManagementException if there is already an identity
* with the same name in the scope.
*/
public IdentityScope(String name, IdentityScope scope)
@ -155,7 +155,7 @@ class IdentityScope extends Identity {
*
* @param scope the scope to set.
*
* @exception SecurityException if a security manager exists and its
* @throws SecurityException if a security manager exists and its
* {@code checkSecurityAccess} method doesn't allow
* setting the identity scope.
*
@ -214,7 +214,7 @@ class IdentityScope extends Identity {
*
* @param identity the identity to be added.
*
* @exception KeyManagementException if the identity is not
* @throws KeyManagementException if the identity is not
* valid, a name conflict occurs, another identity has the same
* public key as the identity being added, or another exception
* occurs. */
@ -226,7 +226,7 @@ class IdentityScope extends Identity {
*
* @param identity the identity to be removed.
*
* @exception KeyManagementException if the identity is missing,
* @throws KeyManagementException if the identity is missing,
* or another exception occurs.
*/
public abstract void removeIdentity(Identity identity)

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

@ -1,5 +1,5 @@
/*
* Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1997, 2019, 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
@ -337,7 +337,7 @@ public class KeyFactory {
*
* @return the public key.
*
* @exception InvalidKeySpecException if the given key specification
* @throws InvalidKeySpecException if the given key specification
* is inappropriate for this key factory to produce a public key.
*/
public final PublicKey generatePublic(KeySpec keySpec)
@ -375,7 +375,7 @@ public class KeyFactory {
*
* @return the private key.
*
* @exception InvalidKeySpecException if the given key specification
* @throws InvalidKeySpecException if the given key specification
* is inappropriate for this key factory to produce a private key.
*/
public final PrivateKey generatePrivate(KeySpec keySpec)
@ -423,7 +423,7 @@ public class KeyFactory {
* @return the underlying key specification (key material) in an instance
* of the requested specification class.
*
* @exception InvalidKeySpecException if the requested key specification is
* @throws InvalidKeySpecException if the requested key specification is
* inappropriate for the given key, or the given key cannot be processed
* (e.g., the given key has an unrecognized algorithm or format).
*/
@ -462,7 +462,7 @@ public class KeyFactory {
*
* @return the translated key.
*
* @exception InvalidKeyException if the given key cannot be processed
* @throws InvalidKeyException if the given key cannot be processed
* by this key factory.
*/
public final Key translateKey(Key key) throws InvalidKeyException {

10
src/java.base/share/classes/java/security/KeyFactorySpi.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1997, 2019, 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
@ -77,7 +77,7 @@ public abstract class KeyFactorySpi {
*
* @return the public key.
*
* @exception InvalidKeySpecException if the given key specification
* @throws InvalidKeySpecException if the given key specification
* is inappropriate for this key factory to produce a public key.
*/
protected abstract PublicKey engineGeneratePublic(KeySpec keySpec)
@ -91,7 +91,7 @@ public abstract class KeyFactorySpi {
*
* @return the private key.
*
* @exception InvalidKeySpecException if the given key specification
* @throws InvalidKeySpecException if the given key specification
* is inappropriate for this key factory to produce a private key.
*/
protected abstract PrivateKey engineGeneratePrivate(KeySpec keySpec)
@ -116,7 +116,7 @@ public abstract class KeyFactorySpi {
* @return the underlying key specification (key material) in an instance
* of the requested specification class.
* @exception InvalidKeySpecException if the requested key specification is
* @throws InvalidKeySpecException if the requested key specification is
* inappropriate for the given key, or the given key cannot be dealt with
* (e.g., the given key has an unrecognized format).
*/
@ -133,7 +133,7 @@ public abstract class KeyFactorySpi {
*
* @return the translated key.
*
* @exception InvalidKeyException if the given key cannot be processed
* @throws InvalidKeyException if the given key cannot be processed
* by this key factory.
*/
protected abstract Key engineTranslateKey(Key key)

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

@ -1,5 +1,5 @@
/*
* Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1997, 2019, 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
@ -369,7 +369,7 @@ public abstract class KeyPairGenerator extends KeyPairGeneratorSpi {
* algorithm-specific metric, such as modulus length, specified in
* number of bits.
*
* @exception InvalidParameterException if the {@code keysize} is not
* @throws InvalidParameterException if the {@code keysize} is not
* supported by this KeyPairGenerator object.
*/
public void initialize(int keysize) {
@ -385,7 +385,7 @@ public abstract class KeyPairGenerator extends KeyPairGeneratorSpi {
* number of bits.
* @param random the source of randomness.
*
* @exception InvalidParameterException if the {@code keysize} is not
* @throws InvalidParameterException if the {@code keysize} is not
* supported by this KeyPairGenerator object.
*
* @since 1.2
@ -426,7 +426,7 @@ public abstract class KeyPairGenerator extends KeyPairGeneratorSpi {
*
* @param params the parameter set used to generate the keys.
*
* @exception InvalidAlgorithmParameterException if the given parameters
* @throws InvalidAlgorithmParameterException if the given parameters
* are inappropriate for this key pair generator.
*
* @since 1.2
@ -454,7 +454,7 @@ public abstract class KeyPairGenerator extends KeyPairGeneratorSpi {
* @param params the parameter set used to generate the keys.
* @param random the source of randomness.
*
* @exception InvalidAlgorithmParameterException if the given parameters
* @throws InvalidAlgorithmParameterException if the given parameters
* are inappropriate for this key pair generator.
*
* @since 1.2

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

@ -1,5 +1,5 @@
/*
* Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1997, 2019, 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,7 +68,7 @@ public abstract class KeyPairGeneratorSpi {
*
* @param random the source of randomness for this generator.
*
* @exception InvalidParameterException if the {@code keysize} is not
* @throws InvalidParameterException if the {@code keysize} is not
* supported by this KeyPairGeneratorSpi object.
*/
public abstract void initialize(int keysize, SecureRandom random);
@ -90,7 +90,7 @@ public abstract class KeyPairGeneratorSpi {
*
* @param random the source of randomness for this generator.
*
* @exception InvalidAlgorithmParameterException if the given parameters
* @throws InvalidAlgorithmParameterException if the given parameters
* are inappropriate for this key pair generator.
*
* @since 1.2

4
src/java.base/share/classes/java/security/KeyRep.java
View file

@ -121,7 +121,7 @@ public class KeyRep implements Serializable {
* @param encoded the encoded bytes returned from
* {@code Key.getEncoded()}
*
* @exception NullPointerException
* @throws NullPointerException
* if type is {@code null},
* if algorithm is {@code null},
* if format is {@code null},
@ -158,7 +158,7 @@ public class KeyRep implements Serializable {
*
* @return the resolved Key object
*
* @exception ObjectStreamException if the Type/format
* @throws ObjectStreamException if the Type/format
* combination is unrecognized, if the algorithm, key format, or
* encoded key bytes are unrecognized/invalid, of if the
* resolution of the key fails for any reason

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

@ -1,5 +1,5 @@
/*
* Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1997, 2019, 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
@ -296,7 +296,7 @@ public class KeyStore {
* for information about standard encryption algorithm names.
* @param protectionParameters the encryption algorithm parameter
* specification, which may be {@code null}
* @exception NullPointerException if {@code protectionAlgorithm} is
* @throws NullPointerException if {@code protectionAlgorithm} is
* {@code null}
*
* @since 1.8
@ -346,7 +346,7 @@ public class KeyStore {
*
* @see #destroy()
* @return the password, which may be {@code null}
* @exception IllegalStateException if the password has
* @throws IllegalStateException if the password has
* been cleared (destroyed)
*/
public synchronized char[] getPassword() {
@ -359,7 +359,7 @@ public class KeyStore {
/**
* Clears the password.
*
* @exception DestroyFailedException if this method was unable
* @throws DestroyFailedException if this method was unable
* to clear the password
*/
public synchronized void destroy() throws DestroyFailedException {
@ -394,7 +394,7 @@ public class KeyStore {
* CallbackHandler.
*
* @param handler the CallbackHandler
* @exception NullPointerException if handler is null
* @throws NullPointerException if handler is null
*/
public CallbackHandlerProtection(CallbackHandler handler) {
if (handler == null) {
@ -485,10 +485,10 @@ public class KeyStore {
* {@code Certificate} at index 0
* corresponding to the private key.
*
* @exception NullPointerException if
* @throws NullPointerException if
* {@code privateKey} or {@code chain}
* is {@code null}
* @exception IllegalArgumentException if the specified chain has a
* @throws IllegalArgumentException if the specified chain has a
* length of 0, if the specified chain does not contain
* {@code Certificate}s of the same type,
* or if the {@code PrivateKey} algorithm
@ -514,9 +514,9 @@ public class KeyStore {
* corresponding to the private key.
* @param attributes the attributes
*
* @exception NullPointerException if {@code privateKey}, {@code chain}
* @throws NullPointerException if {@code privateKey}, {@code chain}
* or {@code attributes} is {@code null}
* @exception IllegalArgumentException if the specified chain has a
* @throws IllegalArgumentException if the specified chain has a
* length of 0, if the specified chain does not contain
* {@code Certificate}s of the same type,
* or if the {@code PrivateKey} algorithm
@ -651,7 +651,7 @@ public class KeyStore {
*
* @param secretKey the {@code SecretKey}
*
* @exception NullPointerException if {@code secretKey}
* @throws NullPointerException if {@code secretKey}
* is {@code null}
*/
public SecretKeyEntry(SecretKey secretKey) {
@ -672,7 +672,7 @@ public class KeyStore {
* @param secretKey the {@code SecretKey}
* @param attributes the attributes
*
* @exception NullPointerException if {@code secretKey} or
* @throws NullPointerException if {@code secretKey} or
* {@code attributes} is {@code null}
*
* @since 1.8
@ -734,7 +734,7 @@ public class KeyStore {
*
* @param trustedCert the trusted {@code Certificate}
*
* @exception NullPointerException if
* @throws NullPointerException if
* {@code trustedCert} is {@code null}
*/
public TrustedCertificateEntry(Certificate trustedCert) {
@ -755,7 +755,7 @@ public class KeyStore {
* @param trustedCert the trusted {@code Certificate}
* @param attributes the attributes
*
* @exception NullPointerException if {@code trustedCert} or
* @throws NullPointerException if {@code trustedCert} or
* {@code attributes} is {@code null}
*
* @since 1.8
@ -1033,11 +1033,11 @@ public class KeyStore {
* @return the requested key, or null if the given alias does not exist
* or does not identify a key-related entry.
*
* @exception KeyStoreException if the keystore has not been initialized
* @throws KeyStoreException if the keystore has not been initialized
* (loaded).
* @exception NoSuchAlgorithmException if the algorithm for recovering the
* @throws NoSuchAlgorithmException if the algorithm for recovering the
* key cannot be found
* @exception UnrecoverableKeyException if the key cannot be recovered
* @throws UnrecoverableKeyException if the key cannot be recovered
* (e.g., the given password is wrong).
*/
public final Key getKey(String alias, char[] password)
@ -1063,7 +1063,7 @@ public class KeyStore {
* followed by zero or more certificate authorities), or null if the given alias
* does not exist or does not contain a certificate chain
*
* @exception KeyStoreException if the keystore has not been initialized
* @throws KeyStoreException if the keystore has not been initialized
* (loaded).
*/
public final Certificate[] getCertificateChain(String alias)
@ -1096,7 +1096,7 @@ public class KeyStore {
* @return the certificate, or null if the given alias does not exist or
* does not contain a certificate.
*
* @exception KeyStoreException if the keystore has not been initialized
* @throws KeyStoreException if the keystore has not been initialized
* (loaded).
*/
public final Certificate getCertificate(String alias)
@ -1116,7 +1116,7 @@ public class KeyStore {
* @return the creation date of this entry, or null if the given alias does
* not exist
*
* @exception KeyStoreException if the keystore has not been initialized
* @throws KeyStoreException if the keystore has not been initialized
* (loaded).
*/
public final Date getCreationDate(String alias)
@ -1147,7 +1147,7 @@ public class KeyStore {
* key (only required if the given key is of type
* {@code java.security.PrivateKey}).
*
* @exception KeyStoreException if the keystore has not been initialized
* @throws KeyStoreException if the keystore has not been initialized
* (loaded), the given key cannot be protected, or this operation fails
* for some other reason
*/
@ -1188,7 +1188,7 @@ public class KeyStore {
* key (only useful if the protected key is of type
* {@code java.security.PrivateKey}).
*
* @exception KeyStoreException if the keystore has not been initialized
* @throws KeyStoreException if the keystore has not been initialized
* (loaded), or if this operation fails for some other reason.
*/
public final void setKeyEntry(String alias, byte[] key,
@ -1214,7 +1214,7 @@ public class KeyStore {
* @param alias the alias name
* @param cert the certificate
*
* @exception KeyStoreException if the keystore has not been initialized,
* @throws KeyStoreException if the keystore has not been initialized,
* or the given alias already exists and does not identify an
* entry containing a trusted certificate,
* or this operation fails for some other reason.
@ -1233,7 +1233,7 @@ public class KeyStore {
*
* @param alias the alias name
*
* @exception KeyStoreException if the keystore has not been initialized,
* @throws KeyStoreException if the keystore has not been initialized,
* or if the entry cannot be removed.
*/
public final void deleteEntry(String alias)
@ -1250,7 +1250,7 @@ public class KeyStore {
*
* @return enumeration of the alias names
*
* @exception KeyStoreException if the keystore has not been initialized
* @throws KeyStoreException if the keystore has not been initialized
* (loaded).
*/
public final Enumeration<String> aliases()
@ -1269,7 +1269,7 @@ public class KeyStore {
*
* @return true if the alias exists, false otherwise
*
* @exception KeyStoreException if the keystore has not been initialized
* @throws KeyStoreException if the keystore has not been initialized
* (loaded).
*/
public final boolean containsAlias(String alias)
@ -1286,7 +1286,7 @@ public class KeyStore {
*
* @return the number of entries in this keystore
*
* @exception KeyStoreException if the keystore has not been initialized
* @throws KeyStoreException if the keystore has not been initialized
* (loaded).
*/
public final int size()
@ -1309,7 +1309,7 @@ public class KeyStore {
* @return true if the entry identified by the given alias is a
* key-related entry, false otherwise.
*
* @exception KeyStoreException if the keystore has not been initialized
* @throws KeyStoreException if the keystore has not been initialized
* (loaded).
*/
public final boolean isKeyEntry(String alias)
@ -1332,7 +1332,7 @@ public class KeyStore {
* @return true if the entry identified by the given alias contains a
* trusted certificate, false otherwise.
*
* @exception KeyStoreException if the keystore has not been initialized
* @throws KeyStoreException if the keystore has not been initialized
* (loaded).
*/
public final boolean isCertificateEntry(String alias)
@ -1367,7 +1367,7 @@ public class KeyStore {
* @return the alias name of the first entry with a matching certificate,
* or null if no such entry exists in this keystore.
*
* @exception KeyStoreException if the keystore has not been initialized
* @throws KeyStoreException if the keystore has not been initialized
* (loaded).
*/
public final String getCertificateAlias(Certificate cert)
@ -1386,12 +1386,12 @@ public class KeyStore {
* @param stream the output stream to which this keystore is written.
* @param password the password to generate the keystore integrity check
*
* @exception KeyStoreException if the keystore has not been initialized
* @throws KeyStoreException if the keystore has not been initialized
* (loaded).
* @exception IOException if there was an I/O problem with data
* @exception NoSuchAlgorithmException if the appropriate data integrity
* @throws IOException if there was an I/O problem with data
* @throws NoSuchAlgorithmException if the appropriate data integrity
* algorithm could not be found
* @exception CertificateException if any of the certificates included in
* @throws CertificateException if any of the certificates included in
* the keystore data could not be stored
*/
public final void store(OutputStream stream, char[] password)
@ -1411,15 +1411,15 @@ public class KeyStore {
* that specifies how to store the keystore,
* which may be {@code null}
*
* @exception IllegalArgumentException if the given
* @throws IllegalArgumentException if the given
* {@code LoadStoreParameter}
* input is not recognized
* @exception KeyStoreException if the keystore has not been initialized
* @throws KeyStoreException if the keystore has not been initialized
* (loaded)
* @exception IOException if there was an I/O problem with data
* @exception NoSuchAlgorithmException if the appropriate data integrity
* @throws IOException if there was an I/O problem with data
* @throws NoSuchAlgorithmException if the appropriate data integrity
* algorithm could not be found
* @exception CertificateException if any of the certificates included in
* @throws CertificateException if any of the certificates included in
* the keystore data could not be stored
*
* @since 1.5
@ -1455,15 +1455,15 @@ public class KeyStore {
* the keystore, the password used to unlock the keystore,
* or {@code null}
*
* @exception IOException if there is an I/O or format problem with the
* @throws IOException if there is an I/O or format problem with the
* keystore data, if a password is required but not given,
* or if the given password was incorrect. If the error is due to a
* wrong password, the {@link Throwable#getCause cause} of the
* {@code IOException} should be an
* {@code UnrecoverableKeyException}
* @exception NoSuchAlgorithmException if the algorithm used to check
* @throws NoSuchAlgorithmException if the algorithm used to check
* the integrity of the keystore cannot be found
* @exception CertificateException if any of the certificates in the
* @throws CertificateException if any of the certificates in the
* keystore could not be loaded
*/
public final void load(InputStream stream, char[] password)
@ -1483,18 +1483,18 @@ public class KeyStore {
* that specifies how to load the keystore,
* which may be {@code null}
*
* @exception IllegalArgumentException if the given
* @throws IllegalArgumentException if the given
* {@code LoadStoreParameter}
* input is not recognized
* @exception IOException if there is an I/O or format problem with the
* @throws IOException if there is an I/O or format problem with the
* keystore data. If the error is due to an incorrect
* {@code ProtectionParameter} (e.g. wrong password)
* the {@link Throwable#getCause cause} of the
* {@code IOException} should be an
* {@code UnrecoverableKeyException}
* @exception NoSuchAlgorithmException if the algorithm used to check
* @throws NoSuchAlgorithmException if the algorithm used to check
* the integrity of the keystore cannot be found
* @exception CertificateException if any of the certificates in the
* @throws CertificateException if any of the certificates in the
* keystore could not be loaded
*
* @since 1.5
@ -1519,17 +1519,17 @@ public class KeyStore {
* @return the keystore {@code Entry} for the specified alias,
* or {@code null} if there is no such entry
*
* @exception NullPointerException if
* @throws NullPointerException if
* {@code alias} is {@code null}
* @exception NoSuchAlgorithmException if the algorithm for recovering the
* @throws NoSuchAlgorithmException if the algorithm for recovering the
* entry cannot be found
* @exception UnrecoverableEntryException if the specified
* @throws UnrecoverableEntryException if the specified
* {@code protParam} were insufficient or invalid
* @exception UnrecoverableKeyException if the entry is a
* @throws UnrecoverableKeyException if the entry is a
* {@code PrivateKeyEntry} or {@code SecretKeyEntry}
* and the specified {@code protParam} does not contain
* the information needed to recover the key (e.g. wrong password)
* @exception KeyStoreException if the keystore has not been initialized
* @throws KeyStoreException if the keystore has not been initialized
* (loaded).
* @see #setEntry(String, KeyStore.Entry, KeyStore.ProtectionParameter)
*
@ -1562,10 +1562,10 @@ public class KeyStore {
* used to protect the {@code Entry},
* which may be {@code null}
*
* @exception NullPointerException if
* @throws NullPointerException if
* {@code alias} or {@code entry}
* is {@code null}
* @exception KeyStoreException if the keystore has not been initialized
* @throws KeyStoreException if the keystore has not been initialized
* (loaded), or if this operation fails for some other reason
*
* @see #getEntry(String, KeyStore.ProtectionParameter)
@ -1596,10 +1596,10 @@ public class KeyStore {
* {@code alias} is an instance or subclass of the
* specified {@code entryClass}, false otherwise
*
* @exception NullPointerException if
* @throws NullPointerException if
* {@code alias} or {@code entryClass}
* is {@code null}
* @exception KeyStoreException if the keystore has not been
* @throws KeyStoreException if the keystore has not been
* initialized (loaded)
*
* @since 1.5
@ -1841,7 +1841,7 @@ public class KeyStore {
* Returns the KeyStore described by this object.
*
* @return the {@code KeyStore} described by this object
* @exception KeyStoreException if an error occurred during the
* @throws KeyStoreException if an error occurred during the
* operation, for example if the KeyStore could not be
* instantiated or loaded
*/

52
src/java.base/share/classes/java/security/KeyStoreSpi.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1998, 2018, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1998, 2019, 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,9 +66,9 @@ public abstract class KeyStoreSpi {
* @return the requested key, or null if the given alias does not exist
* or does not identify a key-related entry.
*
* @exception NoSuchAlgorithmException if the algorithm for recovering the
* @throws NoSuchAlgorithmException if the algorithm for recovering the
* key cannot be found
* @exception UnrecoverableKeyException if the key cannot be recovered
* @throws UnrecoverableKeyException if the key cannot be recovered
* (e.g., the given password is wrong).
*/
public abstract Key engineGetKey(String alias, char[] password)
@ -141,7 +141,7 @@ public abstract class KeyStoreSpi {
* key (only required if the given key is of type
* {@code java.security.PrivateKey}).
*
* @exception KeyStoreException if the given key cannot be protected, or
* @throws KeyStoreException if the given key cannot be protected, or
* this operation fails for some other reason
*/
public abstract void engineSetKeyEntry(String alias, Key key,
@ -168,7 +168,7 @@ public abstract class KeyStoreSpi {
* key (only useful if the protected key is of type
* {@code java.security.PrivateKey}).
*
* @exception KeyStoreException if this operation fails.
* @throws KeyStoreException if this operation fails.
*/
public abstract void engineSetKeyEntry(String alias, byte[] key,
Certificate[] chain)
@ -187,7 +187,7 @@ public abstract class KeyStoreSpi {
* @param alias the alias name
* @param cert the certificate
*
* @exception KeyStoreException if the given alias already exists and does
* @throws KeyStoreException if the given alias already exists and does
* not identify an entry containing a trusted certificate,
* or this operation fails for some other reason.
*/
@ -200,7 +200,7 @@ public abstract class KeyStoreSpi {
*
* @param alias the alias name
*
* @exception KeyStoreException if the entry cannot be removed.
* @throws KeyStoreException if the entry cannot be removed.
*/
public abstract void engineDeleteEntry(String alias)
throws KeyStoreException;
@ -286,10 +286,10 @@ public abstract class KeyStoreSpi {
* @param stream the output stream to which this keystore is written.
* @param password the password to generate the keystore integrity check
*
* @exception IOException if there was an I/O problem with data
* @exception NoSuchAlgorithmException if the appropriate data integrity
* @throws IOException if there was an I/O problem with data
* @throws NoSuchAlgorithmException if the appropriate data integrity
* algorithm could not be found
* @exception CertificateException if any of the certificates included in
* @throws CertificateException if any of the certificates included in
* the keystore data could not be stored
*/
public abstract void engineStore(OutputStream stream, char[] password)
@ -303,13 +303,13 @@ public abstract class KeyStoreSpi {
* that specifies how to store the keystore,
* which may be {@code null}
*
* @exception IllegalArgumentException if the given
* @throws IllegalArgumentException if the given
* {@code KeyStore.LoadStoreParmeter}
* input is not recognized
* @exception IOException if there was an I/O problem with data
* @exception NoSuchAlgorithmException if the appropriate data integrity
* @throws IOException if there was an I/O problem with data
* @throws NoSuchAlgorithmException if the appropriate data integrity
* algorithm could not be found
* @exception CertificateException if any of the certificates included in
* @throws CertificateException if any of the certificates included in
* the keystore data could not be stored
*
* @since 1.5
@ -335,15 +335,15 @@ public abstract class KeyStoreSpi {
* the keystore, the password used to unlock the keystore,
* or {@code null}
*
* @exception IOException if there is an I/O or format problem with the
* @throws IOException if there is an I/O or format problem with the
* keystore data, if a password is required but not given,
* or if the given password was incorrect. If the error is due to a
* wrong password, the {@link Throwable#getCause cause} of the
* {@code IOException} should be an
* {@code UnrecoverableKeyException}
* @exception NoSuchAlgorithmException if the algorithm used to check
* @throws NoSuchAlgorithmException if the algorithm used to check
* the integrity of the keystore cannot be found
* @exception CertificateException if any of the certificates in the
* @throws CertificateException if any of the certificates in the
* keystore could not be loaded
*/
public abstract void engineLoad(InputStream stream, char[] password)
@ -376,18 +376,18 @@ public abstract class KeyStoreSpi {
* extracted. If the {@code KeyStore.ProtectionParameter} is neither
* of those classes then a {@code NoSuchAlgorithmException} is thrown.
*
* @exception IllegalArgumentException if the given
* @throws IllegalArgumentException if the given
* {@code KeyStore.LoadStoreParameter}
* input is not recognized
* @exception IOException if there is an I/O or format problem with the
* @throws IOException if there is an I/O or format problem with the
* keystore data. If the error is due to an incorrect
* {@code ProtectionParameter} (e.g. wrong password)
* the {@link Throwable#getCause cause} of the
* {@code IOException} should be an
* {@code UnrecoverableKeyException}
* @exception NoSuchAlgorithmException if the algorithm used to check
* @throws NoSuchAlgorithmException if the algorithm used to check
* the integrity of the keystore cannot be found
* @exception CertificateException if any of the certificates in the
* @throws CertificateException if any of the certificates in the
* keystore could not be loaded
*
* @since 1.5
@ -447,12 +447,12 @@ public abstract class KeyStoreSpi {
* @return the {@code KeyStore.Entry} for the specified alias,
* or {@code null} if there is no such entry
*
* @exception KeyStoreException if the operation failed
* @exception NoSuchAlgorithmException if the algorithm for recovering the
* @throws KeyStoreException if the operation failed
* @throws NoSuchAlgorithmException if the algorithm for recovering the
* entry cannot be found
* @exception UnrecoverableEntryException if the specified
* @throws UnrecoverableEntryException if the specified
* {@code protParam} were insufficient or invalid
* @exception UnrecoverableKeyException if the entry is a
* @throws UnrecoverableKeyException if the entry is a
* {@code PrivateKeyEntry} or {@code SecretKeyEntry}
* and the specified {@code protParam} does not contain
* the information needed to recover the key (e.g. wrong password)
@ -518,7 +518,7 @@ public abstract class KeyStoreSpi {
* used to protect the {@code Entry},
* which may be {@code null}
*
* @exception KeyStoreException if this operation fails
* @throws KeyStoreException if this operation fails
*
* @since 1.5
*/

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

@ -1,5 +1,5 @@
/*
* Copyright (c) 1996, 2017, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1996, 2019, 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
@ -399,7 +399,7 @@ public abstract class MessageDigest extends MessageDigestSpi {
*
* @return the number of bytes placed into {@code buf}
*
* @exception DigestException if an error occurs.
* @throws DigestException if an error occurs.
*/
public int digest(byte[] buf, int offset, int len) throws DigestException {
if (buf == null) {
@ -536,7 +536,7 @@ public abstract class MessageDigest extends MessageDigestSpi {
*
* @return a clone if the implementation is cloneable.
*
* @exception CloneNotSupportedException if this is called on an
* @throws CloneNotSupportedException if this is called on an
* implementation that does not support {@code Cloneable}.
*/
public Object clone() throws CloneNotSupportedException {
@ -580,7 +580,7 @@ public abstract class MessageDigest extends MessageDigestSpi {
*
* @return a clone if the delegate is cloneable.
*
* @exception CloneNotSupportedException if this is called on a
* @throws CloneNotSupportedException if this is called on a
* delegate that does not support {@code Cloneable}.
*/
public Object clone() throws CloneNotSupportedException {

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

@ -1,5 +1,5 @@
/*
* Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1997, 2019, 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
@ -167,7 +167,7 @@ public abstract class MessageDigestSpi {
*
* @return the length of the digest stored in the output buffer.
*
* @exception DigestException if an error occurs.
* @throws DigestException if an error occurs.
*
* @since 1.2
*/
@ -194,7 +194,7 @@ public abstract class MessageDigestSpi {
*
* @return a clone if the implementation is cloneable.
*
* @exception CloneNotSupportedException if this is called on an
* @throws CloneNotSupportedException if this is called on an
* implementation that does not support {@code Cloneable}.
*/
public Object clone() throws CloneNotSupportedException {

10
src/java.base/share/classes/java/security/PKCS12Attribute.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2013, 2018, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2013, 2019, 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
@ -64,9 +64,9 @@ public final class PKCS12Attribute implements KeyStore.Entry.Attribute {
* @param name the attribute's identifier
* @param value the attribute's value
*
* @exception NullPointerException if {@code name} or {@code value}
* @throws NullPointerException if {@code name} or {@code value}
* is {@code null}
* @exception IllegalArgumentException if {@code name} or
* @throws IllegalArgumentException if {@code name} or
* {@code value} is incorrectly formatted
*/
public PKCS12Attribute(String name, String value) {
@ -117,9 +117,9 @@ public final class PKCS12Attribute implements KeyStore.Entry.Attribute {
* @param encoded the attribute's ASN.1 DER encoding. It is cloned
* to prevent subsequent modificaion.
*
* @exception NullPointerException if {@code encoded} is
* @throws NullPointerException if {@code encoded} is
* {@code null}
* @exception IllegalArgumentException if {@code encoded} is
* @throws IllegalArgumentException if {@code encoded} is
* incorrectly formatted
*/
public PKCS12Attribute(byte[] encoded) {

4
src/java.base/share/classes/java/security/PermissionCollection.java
View file

@ -107,9 +107,9 @@ public abstract class PermissionCollection implements java.io.Serializable {
*
* @param permission the Permission object to add.
*
* @exception SecurityException - if this PermissionCollection object
* @throws SecurityException - if this PermissionCollection object
* has been marked readonly
* @exception IllegalArgumentException - if this PermissionCollection
* @throws IllegalArgumentException - if this PermissionCollection
* object is a homogeneous collection and the permission
* is not of the correct type.
*/

2
src/java.base/share/classes/java/security/Permissions.java
View file

@ -116,7 +116,7 @@ implements Serializable
*
* @param permission the Permission object to add.
*
* @exception SecurityException if this Permissions object is
* @throws SecurityException if this Permissions object is
* marked as readonly.
*
* @see PermissionCollection#isReadOnly()

2
src/java.base/share/classes/java/security/Policy.java
View file

@ -837,7 +837,7 @@ public abstract class Policy {
*
* @param permission the Permission object to add.
*
* @exception SecurityException - if this PermissionCollection object
* @throws SecurityException - if this PermissionCollection object
* has been marked readonly
*/
@Override public void add(Permission permission) {

2
src/java.base/share/classes/java/security/Provider.java
View file

@ -403,7 +403,7 @@ public abstract class Provider extends Properties {
* Reads a property list (key and element pairs) from the input stream.
*
* @param inStream the input stream.
* @exception IOException if an error occurred when reading from the
* @throws IOException if an error occurred when reading from the
* input stream.
* @see java.util.Properties#load
*/

16
src/java.base/share/classes/java/security/SecureClassLoader.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1997, 2019, 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,7 +68,7 @@ public class SecureClassLoader extends ClassLoader {
* method to ensure creation of a class loader is allowed.
*
* @param parent the parent ClassLoader
* @exception SecurityException if a security manager exists and its
* @throws SecurityException if a security manager exists and its
* {@code checkCreateClassLoader} method doesn't allow
* creation of a class loader.
* @see SecurityManager#checkCreateClassLoader
@ -85,7 +85,7 @@ public class SecureClassLoader extends ClassLoader {
* calls the security manager's {@code checkCreateClassLoader}
* method to ensure creation of a class loader is allowed.
*
* @exception SecurityException if a security manager exists and its
* @throws SecurityException if a security manager exists and its
* {@code checkCreateClassLoader} method doesn't allow
* creation of a class loader.
* @see SecurityManager#checkCreateClassLoader
@ -134,12 +134,12 @@ public class SecureClassLoader extends ClassLoader {
* @param cs the associated CodeSource, or {@code null} if none
* @return the {@code Class} object created from the data,
* and optional CodeSource.
* @exception ClassFormatError if the data did not contain a valid class
* @exception IndexOutOfBoundsException if either {@code off} or
* @throws ClassFormatError if the data did not contain a valid class
* @throws IndexOutOfBoundsException if either {@code off} or
* {@code len} is negative, or if
* {@code off+len} is greater than {@code b.length}.
*
* @exception SecurityException if an attempt is made to add this class
* @throws SecurityException if an attempt is made to add this class
* to a package that contains classes that were signed by
* a different set of certificates than this class, or if
* the class name begins with "java.".
@ -169,8 +169,8 @@ public class SecureClassLoader extends ClassLoader {
* @param cs the associated CodeSource, or {@code null} if none
* @return the {@code Class} object created from the data,
* and optional CodeSource.
* @exception ClassFormatError if the data did not contain a valid class
* @exception SecurityException if an attempt is made to add this class
* @throws ClassFormatError if the data did not contain a valid class
* @throws SecurityException if an attempt is made to add this class
* to a package that contains classes that were signed by
* a different set of certificates than this class, or if
* the class name begins with "java.".

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

@ -498,7 +498,7 @@ public abstract class Signature extends SignatureSpi {
* @param publicKey the public key of the identity whose signature is
* going to be verified.
*
* @exception InvalidKeyException if the key is invalid.
* @throws InvalidKeyException if the key is invalid.
*/
public final void initVerify(PublicKey publicKey)
throws InvalidKeyException {
@ -520,8 +520,8 @@ public abstract class Signature extends SignatureSpi {
* going to be verified.
* @param params the parameters used for verifying this signature.
*
* @exception InvalidKeyException if the key is invalid.
* @exception InvalidAlgorithmParameterException if the params is invalid.
* @throws InvalidKeyException if the key is invalid.
* @throws InvalidAlgorithmParameterException if the params is invalid.
*/
final void initVerify(PublicKey publicKey, AlgorithmParameterSpec params)
throws InvalidKeyException, InvalidAlgorithmParameterException {
@ -571,7 +571,7 @@ public abstract class Signature extends SignatureSpi {
* @param certificate the certificate of the identity whose signature is
* going to be verified.
*
* @exception InvalidKeyException if the public key in the certificate
* @throws InvalidKeyException if the public key in the certificate
* is not encoded properly or does not include required parameter
* information or cannot be used for digital signature purposes.
* @since 1.3
@ -601,10 +601,10 @@ public abstract class Signature extends SignatureSpi {
* going to be verified.
* @param params the parameters used for verifying this signature.
*
* @exception InvalidKeyException if the public key in the certificate
* @throws InvalidKeyException if the public key in the 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.
* @throws InvalidAlgorithmParameterException if the params is invalid.
*
* @since 13
*/
@ -628,7 +628,7 @@ public abstract class Signature extends SignatureSpi {
* @param privateKey the private key of the identity whose signature
* is going to be generated.
*
* @exception InvalidKeyException if the key is invalid.
* @throws InvalidKeyException if the key is invalid.
*/
public final void initSign(PrivateKey privateKey)
throws InvalidKeyException {
@ -651,7 +651,7 @@ public abstract class Signature extends SignatureSpi {
*
* @param random the source of randomness for this signature.
*
* @exception InvalidKeyException if the key is invalid.
* @throws InvalidKeyException if the key is invalid.
*/
public final void initSign(PrivateKey privateKey, SecureRandom random)
throws InvalidKeyException {
@ -674,8 +674,8 @@ public abstract class Signature extends SignatureSpi {
* @param params the parameters used for generating signature.
* @param random the source of randomness for this signature.
*
* @exception InvalidKeyException if the key is invalid.
* @exception InvalidAlgorithmParameterException if the params is invalid
* @throws InvalidKeyException if the key is invalid.
* @throws InvalidAlgorithmParameterException if the params is invalid
*/
final void initSign(PrivateKey privateKey,
AlgorithmParameterSpec params, SecureRandom random)
@ -703,7 +703,7 @@ public abstract class Signature extends SignatureSpi {
*
* @return the signature bytes of the signing operation's result.
*
* @exception SignatureException if this signature object is not
* @throws SignatureException if this signature object is not
* initialized properly or if this signature algorithm is unable to
* process the input data provided.
*/
@ -736,11 +736,11 @@ public abstract class Signature extends SignatureSpi {
*
* @return the number of bytes placed into {@code outbuf}.
*
* @exception SignatureException if this signature object is not
* @throws SignatureException if this signature object is not
* initialized properly, if this signature algorithm is unable to
* process the input data provided, or if {@code len} is less
* than the actual signature length.
* @exception IllegalArgumentException if {@code outbuf} is {@code null},
* @throws IllegalArgumentException if {@code outbuf} is {@code null},
* or {@code offset} or {@code len} is less than 0, or the sum of
* {@code offset} and {@code len} is greater than the length of
* {@code outbuf}.
@ -779,7 +779,7 @@ public abstract class Signature extends SignatureSpi {
*
* @return true if the signature was verified, false if not.
*
* @exception SignatureException if this signature object is not
* @throws SignatureException if this signature object is not
* initialized properly, the passed-in signature is improperly
* encoded or of the wrong type, if this signature algorithm is unable to
* process the input data provided, etc.
@ -809,11 +809,11 @@ public abstract class Signature extends SignatureSpi {
*
* @return true if the signature was verified, false if not.
*
* @exception SignatureException if this signature object is not
* @throws SignatureException if this signature object is not
* initialized properly, the passed-in signature is improperly
* encoded or of the wrong type, if this signature algorithm is unable to
* process the input data provided, etc.
* @exception IllegalArgumentException if the {@code signature}
* @throws IllegalArgumentException if the {@code signature}
* byte array is {@code null}, or the {@code offset} or {@code length}
* is less than 0, or the sum of the {@code offset} and
* {@code length} is greater than the length of the
@ -846,7 +846,7 @@ public abstract class Signature extends SignatureSpi {
*
* @param b the byte to use for the update.
*
* @exception SignatureException if this signature object is not
* @throws SignatureException if this signature object is not
* initialized properly.
*/
public final void update(byte b) throws SignatureException {
@ -864,7 +864,7 @@ public abstract class Signature extends SignatureSpi {
*
* @param data the byte array to use for the update.
*
* @exception SignatureException if this signature object is not
* @throws SignatureException if this signature object is not
* initialized properly.
*/
public final void update(byte[] data) throws SignatureException {
@ -879,9 +879,9 @@ public abstract class Signature extends SignatureSpi {
* @param off the offset to start from in the array of bytes.
* @param len the number of bytes to use, starting at offset.
*
* @exception SignatureException if this signature object is not
* @throws SignatureException if this signature object is not
* initialized properly.
* @exception IllegalArgumentException if {@code data} is {@code null},
* @throws IllegalArgumentException if {@code data} is {@code null},
* or {@code off} or {@code len} is less than 0, or the sum of
* {@code off} and {@code len} is greater than the length of
* {@code data}.
@ -915,7 +915,7 @@ public abstract class Signature extends SignatureSpi {
*
* @param data the ByteBuffer
*
* @exception SignatureException if this signature object is not
* @throws SignatureException if this signature object is not
* initialized properly.
* @since 1.5
*/
@ -976,7 +976,7 @@ public abstract class Signature extends SignatureSpi {
* @param param the string identifier of the parameter.
* @param value the parameter value.
*
* @exception InvalidParameterException if {@code param} is an
* @throws InvalidParameterException if {@code param} is an
* invalid parameter for this signature algorithm engine,
* the parameter is already set
* and cannot be set again, a security exception occurs, and so on.
@ -998,7 +998,7 @@ public abstract class Signature extends SignatureSpi {
*
* @param params the parameters
*
* @exception InvalidAlgorithmParameterException if the given parameters
* @throws InvalidAlgorithmParameterException if the given parameters
* are inappropriate for this signature engine
*
* @see #getParameters
@ -1043,7 +1043,7 @@ public abstract class Signature extends SignatureSpi {
* @return the object that represents the parameter value, or {@code null} if
* there is none.
*
* @exception InvalidParameterException if {@code param} is an invalid
* @throws InvalidParameterException if {@code param} is an invalid
* parameter for this engine, or another exception occurs while
* trying to get this parameter.
*
@ -1062,7 +1062,7 @@ public abstract class Signature extends SignatureSpi {
*
* @return a clone if the implementation is cloneable.
*
* @exception CloneNotSupportedException if this is called
* @throws CloneNotSupportedException if this is called
* on an implementation that does not support {@code Cloneable}.
*/
public Object clone() throws CloneNotSupportedException {
@ -1126,7 +1126,7 @@ public abstract class Signature extends SignatureSpi {
*
* @return a clone if the delegate is cloneable.
*
* @exception CloneNotSupportedException if this is called on a
* @throws CloneNotSupportedException if this is called on a
* delegate that does not support {@code Cloneable}.
*/
public Object clone() throws CloneNotSupportedException {

38
src/java.base/share/classes/java/security/SignatureSpi.java
View file

@ -64,7 +64,7 @@ public abstract class SignatureSpi {
* @param publicKey the public key of the identity whose signature is
* going to be verified.
*
* @exception InvalidKeyException if the key is improperly
* @throws InvalidKeyException if the key is improperly
* encoded, parameters are missing, and so on.
*/
protected abstract void engineInitVerify(PublicKey publicKey)
@ -78,9 +78,9 @@ public abstract class SignatureSpi {
* going to be verified.
* @param params the parameters for generating this signature
*
* @exception InvalidKeyException if the key is improperly
* @throws InvalidKeyException if the key is improperly
* encoded, does not work with the given parameters, and so on.
* @exception InvalidAlgorithmParameterException if the given parameters
* @throws InvalidAlgorithmParameterException if the given parameters
* is invalid.
*/
void engineInitVerify(PublicKey publicKey,
@ -104,7 +104,7 @@ public abstract class SignatureSpi {
* @param privateKey the private key of the identity whose signature
* will be generated.
*
* @exception InvalidKeyException if the key is improperly
* @throws InvalidKeyException if the key is improperly
* encoded, parameters are missing, and so on.
*/
protected abstract void engineInitSign(PrivateKey privateKey)
@ -121,7 +121,7 @@ public abstract class SignatureSpi {
* will be generated.
* @param random the source of randomness
*
* @exception InvalidKeyException if the key is improperly
* @throws InvalidKeyException if the key is improperly
* encoded, parameters are missing, and so on.
*/
protected void engineInitSign(PrivateKey privateKey,
@ -143,9 +143,9 @@ public abstract class SignatureSpi {
* @param params the parameters for generating this signature
* @param random the source of randomness
*
* @exception InvalidKeyException if the key is improperly
* @throws InvalidKeyException if the key is improperly
* encoded, parameters are missing, and so on.
* @exception InvalidAlgorithmParameterException if the parameters is
* @throws InvalidAlgorithmParameterException if the parameters is
* invalid.
*/
void engineInitSign(PrivateKey privateKey,
@ -168,7 +168,7 @@ public abstract class SignatureSpi {
*
* @param b the byte to use for the update.
*
* @exception SignatureException if the engine is not initialized
* @throws SignatureException if the engine is not initialized
* properly.
*/
protected abstract void engineUpdate(byte b) throws SignatureException;
@ -181,7 +181,7 @@ public abstract class SignatureSpi {
* @param off the offset to start from in the array of bytes
* @param len the number of bytes to use, starting at offset
*
* @exception SignatureException if the engine is not initialized
* @throws SignatureException if the engine is not initialized
* properly
*/
protected abstract void engineUpdate(byte[] b, int off, int len)
@ -234,7 +234,7 @@ public abstract class SignatureSpi {
*
* @return the signature bytes of the signing operation's result.
*
* @exception SignatureException if the engine is not
* @throws SignatureException if the engine is not
* initialized properly or if this signature algorithm is unable to
* process the input data provided.
*/
@ -273,7 +273,7 @@ public abstract class SignatureSpi {
*
* @return the number of bytes placed into {@code outbuf}
*
* @exception SignatureException if the engine is not
* @throws SignatureException if the engine is not
* initialized properly, if this signature algorithm is unable to
* process the input data provided, or if {@code len} is less
* than the actual signature length.
@ -303,7 +303,7 @@ public abstract class SignatureSpi {
*
* @return true if the signature was verified, false if not.
*
* @exception SignatureException if the engine is not
* @throws SignatureException if the engine is not
* initialized properly, the passed-in signature is improperly
* encoded or of the wrong type, if this signature algorithm is unable to
* process the input data provided, etc.
@ -324,7 +324,7 @@ public abstract class SignatureSpi {
*
* @return true if the signature was verified, false if not.
*
* @exception SignatureException if the engine is not
* @throws SignatureException if the engine is not
* initialized properly, the passed-in signature is improperly
* encoded or of the wrong type, if this signature algorithm is unable to
* process the input data provided, etc.
@ -352,7 +352,7 @@ public abstract class SignatureSpi {
*
* @param value the parameter value.
*
* @exception InvalidParameterException if {@code param} is an
* @throws InvalidParameterException if {@code param} is an
* invalid parameter for this signature algorithm engine,
* the parameter is already set
* and cannot be set again, a security exception occurs, and so on.
@ -371,10 +371,10 @@ public abstract class SignatureSpi {
*
* @param params the parameters
*
* @exception UnsupportedOperationException if this method is not
* @throws UnsupportedOperationException if this method is not
* overridden by a provider
*
* @exception InvalidAlgorithmParameterException if this method is
* @throws InvalidAlgorithmParameterException if this method is
* overridden by a provider and the given parameters
* are inappropriate for this signature engine
*/
@ -397,7 +397,7 @@ public abstract class SignatureSpi {
*
* @return the parameters used with this signature engine, or {@code null}
*
* @exception UnsupportedOperationException if this method is
* @throws UnsupportedOperationException if this method is
* not overridden by a provider
* @since 1.4
*/
@ -421,7 +421,7 @@ public abstract class SignatureSpi {
* @return the object that represents the parameter value, or {@code null} if
* there is none.
*
* @exception InvalidParameterException if {@code param} is an
* @throws InvalidParameterException if {@code param} is an
* invalid parameter for this engine, or another exception occurs while
* trying to get this parameter.
*
@ -436,7 +436,7 @@ public abstract class SignatureSpi {
*
* @return a clone if the implementation is cloneable.
*
* @exception CloneNotSupportedException if this is called
* @throws CloneNotSupportedException if this is called
* on an implementation that does not support {@code Cloneable}.
*/
public Object clone() throws CloneNotSupportedException {

18
src/java.base/share/classes/java/security/SignedObject.java
View file

@ -140,9 +140,9 @@ public final class SignedObject implements Serializable {
* @param signingKey the private key for signing.
* @param signingEngine the signature signing engine.
*
* @exception IOException if an error occurs during serialization
* @exception InvalidKeyException if the key is invalid.
* @exception SignatureException if signing fails.
* @throws IOException if an error occurs during serialization
* @throws InvalidKeyException if the key is invalid.
* @throws SignatureException if signing fails.
*/
public SignedObject(Serializable object, PrivateKey signingKey,
Signature signingEngine)
@ -168,8 +168,8 @@ public final class SignedObject implements Serializable {
*
* @return the encapsulated object.
*
* @exception IOException if an error occurs during de-serialization
* @exception ClassNotFoundException if an error occurs during
* @throws IOException if an error occurs during de-serialization
* @throws ClassNotFoundException if an error occurs during
* de-serialization
*/
public Object getObject()
@ -212,10 +212,10 @@ public final class SignedObject implements Serializable {
* @param verificationKey the public key for verification.
* @param verificationEngine the signature verification engine.
*
* @exception SignatureException if signature verification failed (an
* @throws SignatureException if signature verification failed (an
* exception prevented the signature verification engine from completing
* normally).
* @exception InvalidKeyException if the verification key is invalid.
* @throws InvalidKeyException if the verification key is invalid.
*
* @return {@code true} if the signature
* is valid, {@code false} otherwise
@ -235,8 +235,8 @@ public final class SignedObject implements Serializable {
* @param signingKey the private key for signing.
* @param signingEngine the signature signing engine.
*
* @exception InvalidKeyException if the key is invalid.
* @exception SignatureException if signing fails.
* @throws InvalidKeyException if the key is invalid.
* @throws SignatureException if signing fails.
*/
private void sign(PrivateKey signingKey, Signature signingEngine)
throws InvalidKeyException, SignatureException {

10
src/java.base/share/classes/java/security/Signer.java
View file

@ -84,7 +84,7 @@ public abstract class Signer extends Identity {
*
* @param scope the scope of the identity.
*
* @exception KeyManagementException if there is already an identity
* @throws KeyManagementException if there is already an identity
* with the same name in the scope.
*/
public Signer(String name, IdentityScope scope)
@ -102,7 +102,7 @@ public abstract class Signer extends Identity {
* @return this signer's private key, or null if the private key has
* not yet been set.
*
* @exception SecurityException if a security manager exists and its
* @throws SecurityException if a security manager exists and its
* {@code checkSecurityAccess} method doesn't allow
* returning the private key.
*
@ -122,11 +122,11 @@ public abstract class Signer extends Identity {
*
* @param pair an initialized key pair.
*
* @exception InvalidParameterException if the key pair is not
* @throws InvalidParameterException if the key pair is not
* properly initialized.
* @exception KeyException if the key pair cannot be set for any
* @throws KeyException if the key pair cannot be set for any
* other reason.
* @exception SecurityException if a security manager exists and its
* @throws SecurityException if a security manager exists and its
* {@code checkSecurityAccess} method doesn't allow
* setting the key pair.
*

4
src/java.base/share/classes/java/security/URIParameter.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2005, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2005, 2019, 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
@ -43,7 +43,7 @@ public class URIParameter implements
*
* @param uri the URI pointing to the data.
*
* @exception NullPointerException if the specified URI is null.
* @throws NullPointerException if the specified URI is null.
*/
public URIParameter(java.net.URI uri) {
if (uri == null) {

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

@ -248,7 +248,7 @@ public abstract class CertPath implements Serializable {
* encoding.
*
* @return the encoded bytes
* @exception CertificateEncodingException if an encoding error occurs
* @throws CertificateEncodingException if an encoding error occurs
*/
public abstract byte[] getEncoded()
throws CertificateEncodingException;
@ -259,7 +259,7 @@ public abstract class CertPath implements Serializable {
*
* @param encoding the name of the encoding to use
* @return the encoded bytes
* @exception CertificateEncodingException if an encoding error occurs or
* @throws CertificateEncodingException if an encoding error occurs or
* the encoding requested is not supported
*/
public abstract byte[] getEncoded(String encoding)

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

@ -1,5 +1,5 @@
/*
* Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2000, 2019, 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
@ -296,9 +296,9 @@ public class CertPathValidator {
* @param certPath the {@code CertPath} to be validated
* @param params the algorithm parameters
* @return the result of the validation algorithm
* @exception CertPathValidatorException if the {@code CertPath}
* @throws CertPathValidatorException if the {@code CertPath}
* does not validate
* @exception InvalidAlgorithmParameterException if the specified
* @throws InvalidAlgorithmParameterException if the specified
* parameters or the type of the specified {@code CertPath} are
* inappropriate for this {@code CertPathValidator}
*/

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

@ -1,5 +1,5 @@
/*
* Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2000, 2019, 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
@ -73,9 +73,9 @@ public abstract class CertPathValidatorSpi {
* @param certPath the {@code CertPath} to be validated
* @param params the algorithm parameters
* @return the result of the validation algorithm
* @exception CertPathValidatorException if the {@code CertPath}
* @throws CertPathValidatorException if the {@code CertPath}
* does not validate
* @exception InvalidAlgorithmParameterException if the specified
* @throws InvalidAlgorithmParameterException if the specified
* parameters or the type of the specified {@code CertPath} are
* inappropriate for this {@code CertPathValidator}
*/

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

@ -148,7 +148,7 @@ public abstract class Certificate implements java.io.Serializable {
*
* @return the encoded form of this certificate
*
* @exception CertificateEncodingException if an encoding error occurs.
* @throws CertificateEncodingException if an encoding error occurs.
*/
public abstract byte[] getEncoded()
throws CertificateEncodingException;
@ -159,12 +159,12 @@ public abstract class Certificate implements java.io.Serializable {
*
* @param key the PublicKey used to carry out the verification.
*
* @exception NoSuchAlgorithmException on unsupported signature
* @throws NoSuchAlgorithmException on unsupported signature
* algorithms.
* @exception InvalidKeyException on incorrect key.
* @exception NoSuchProviderException if there's no default provider.
* @exception SignatureException on signature errors.
* @exception CertificateException on encoding errors.
* @throws InvalidKeyException on incorrect key.
* @throws NoSuchProviderException if there's no default provider.
* @throws SignatureException on signature errors.
* @throws CertificateException on encoding errors.
*/
public abstract void verify(PublicKey key)
throws CertificateException, NoSuchAlgorithmException,
@ -180,12 +180,12 @@ public abstract class Certificate implements java.io.Serializable {
* @param key the PublicKey used to carry out the verification.
* @param sigProvider the name of the signature provider.
*
* @exception NoSuchAlgorithmException on unsupported signature
* @throws NoSuchAlgorithmException on unsupported signature
* algorithms.
* @exception InvalidKeyException on incorrect key.
* @exception NoSuchProviderException on incorrect provider.
* @exception SignatureException on signature errors.
* @exception CertificateException on encoding errors.
* @throws InvalidKeyException on incorrect key.
* @throws NoSuchProviderException on incorrect provider.
* @throws SignatureException on signature errors.
* @throws CertificateException on encoding errors.
*/
public abstract void verify(PublicKey key, String sigProvider)
throws CertificateException, NoSuchAlgorithmException,
@ -207,12 +207,12 @@ public abstract class Certificate implements java.io.Serializable {
* @param key the PublicKey used to carry out the verification.
* @param sigProvider the signature provider.
*
* @exception NoSuchAlgorithmException on unsupported signature
* @throws NoSuchAlgorithmException on unsupported signature
* algorithms.
* @exception InvalidKeyException on incorrect key.
* @exception SignatureException on signature errors.
* @exception CertificateException on encoding errors.
* @exception UnsupportedOperationException if the method is not supported
* @throws InvalidKeyException on incorrect key.
* @throws SignatureException on signature errors.
* @throws CertificateException on encoding errors.
* @throws UnsupportedOperationException if the method is not supported
* @since 1.8
*/
public void verify(PublicKey key, Provider sigProvider)

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

@ -1,5 +1,5 @@
/*
* Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1998, 2019, 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
@ -347,7 +347,7 @@ public class CertificateFactory {
* @return a certificate object initialized with the data
* from the input stream.
*
* @exception CertificateException on parsing errors.
* @throws CertificateException on parsing errors.
*/
public final Certificate generateCertificate(InputStream inStream)
throws CertificateException
@ -385,7 +385,7 @@ public class CertificateFactory {
* @param inStream an {@code InputStream} containing the data
* @return a {@code CertPath} initialized with the data from the
* {@code InputStream}
* @exception CertificateException if an exception occurs while decoding
* @throws CertificateException if an exception occurs while decoding
* @since 1.4
*/
public final CertPath generateCertPath(InputStream inStream)
@ -407,7 +407,7 @@ public class CertificateFactory {
* @param encoding the encoding used for the data
* @return a {@code CertPath} initialized with the data from the
* {@code InputStream}
* @exception CertificateException if an exception occurs while decoding or
* @throws CertificateException if an exception occurs while decoding or
* the encoding requested is not supported
* @since 1.4
*/
@ -428,7 +428,7 @@ public class CertificateFactory {
* @param certificates a {@code List} of {@code Certificate}s
* @return a {@code CertPath} initialized with the supplied list of
* certificates
* @exception CertificateException if an exception occurs
* @throws CertificateException if an exception occurs
* @since 1.4
*/
public final CertPath
@ -471,7 +471,7 @@ public class CertificateFactory {
* java.security.cert.Certificate objects
* initialized with the data from the input stream.
*
* @exception CertificateException on parsing errors.
* @throws CertificateException on parsing errors.
*/
public final Collection<? extends Certificate> generateCertificates
(InputStream inStream) throws CertificateException {
@ -505,7 +505,7 @@ public class CertificateFactory {
* @return a CRL object initialized with the data
* from the input stream.
*
* @exception CRLException on parsing errors.
* @throws CRLException on parsing errors.
*/
public final CRL generateCRL(InputStream inStream)
throws CRLException
@ -544,7 +544,7 @@ public class CertificateFactory {
* java.security.cert.CRL objects initialized with the data from the input
* stream.
*
* @exception CRLException on parsing errors.
* @throws CRLException on parsing errors.
*/
public final Collection<? extends CRL> generateCRLs(InputStream inStream)
throws CRLException {

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

@ -1,5 +1,5 @@
/*
* Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1998, 2019, 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,7 +99,7 @@ public abstract class CertificateFactorySpi {
* @return a certificate object initialized with the data
* from the input stream.
*
* @exception CertificateException on parsing errors.
* @throws CertificateException on parsing errors.
*/
public abstract Certificate engineGenerateCertificate(InputStream inStream)
throws CertificateException;
@ -117,8 +117,8 @@ public abstract class CertificateFactorySpi {
* @param inStream an {@code InputStream} containing the data
* @return a {@code CertPath} initialized with the data from the
* {@code InputStream}
* @exception CertificateException if an exception occurs while decoding
* @exception UnsupportedOperationException if the method is not supported
* @throws CertificateException if an exception occurs while decoding
* @throws UnsupportedOperationException if the method is not supported
* @since 1.4
*/
public CertPath engineGenerateCertPath(InputStream inStream)
@ -141,9 +141,9 @@ public abstract class CertificateFactorySpi {
* @param encoding the encoding used for the data
* @return a {@code CertPath} initialized with the data from the
* {@code InputStream}
* @exception CertificateException if an exception occurs while decoding or
* @throws CertificateException if an exception occurs while decoding or
* the encoding requested is not supported
* @exception UnsupportedOperationException if the method is not supported
* @throws UnsupportedOperationException if the method is not supported
* @since 1.4
*/
public CertPath engineGenerateCertPath(InputStream inStream,
@ -168,8 +168,8 @@ public abstract class CertificateFactorySpi {
* @param certificates a {@code List} of {@code Certificate}s
* @return a {@code CertPath} initialized with the supplied list of
* certificates
* @exception CertificateException if an exception occurs
* @exception UnsupportedOperationException if the method is not supported
* @throws CertificateException if an exception occurs
* @throws UnsupportedOperationException if the method is not supported
* @since 1.4
*/
public CertPath
@ -198,7 +198,7 @@ public abstract class CertificateFactorySpi {
*
* @return an {@code Iterator} over the names of the supported
* {@code CertPath} encodings (as {@code String}s)
* @exception UnsupportedOperationException if the method is not supported
* @throws UnsupportedOperationException if the method is not supported
* @since 1.4
*/
public Iterator<String> engineGetCertPathEncodings() {
@ -239,7 +239,7 @@ public abstract class CertificateFactorySpi {
* java.security.cert.Certificate objects
* initialized with the data from the input stream.
*
* @exception CertificateException on parsing errors.
* @throws CertificateException on parsing errors.
*/
public abstract Collection<? extends Certificate>
engineGenerateCertificates(InputStream inStream)
@ -272,7 +272,7 @@ public abstract class CertificateFactorySpi {
* @return a CRL object initialized with the data
* from the input stream.
*
* @exception CRLException on parsing errors.
* @throws CRLException on parsing errors.
*/
public abstract CRL engineGenerateCRL(InputStream inStream)
throws CRLException;
@ -308,7 +308,7 @@ public abstract class CertificateFactorySpi {
* java.security.cert.CRL objects initialized with the data from the input
* stream.
*
* @exception CRLException on parsing errors.
* @throws CRLException on parsing errors.
*/
public abstract Collection<? extends CRL> engineGenerateCRLs
(InputStream inStream) throws CRLException;

4
src/java.base/share/classes/java/security/cert/CollectionCertStoreParameters.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2000, 2019, 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
@ -80,7 +80,7 @@ public class CollectionCertStoreParameters
*
* @param collection a {@code Collection} of
* {@code Certificate}s and {@code CRL}s
* @exception NullPointerException if {@code collection} is
* @throws NullPointerException if {@code collection} is
* {@code null}
*/
public CollectionCertStoreParameters(Collection<?> collection) {

4
src/java.base/share/classes/java/security/cert/Extension.java
View file

@ -94,8 +94,8 @@ public interface Extension {
* stream.
*
* @param out the output stream
* @exception IOException on encoding or output error.
* @exception NullPointerException if {@code out} is {@code null}.
* @throws IOException on encoding or output error.
* @throws NullPointerException if {@code out} is {@code null}.
*/
void encode(OutputStream out) throws IOException;
}

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

@ -1,5 +1,5 @@
/*
* Copyright (c) 2000, 2015, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2000, 2019, 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,7 +69,7 @@ public class LDAPCertStoreParameters implements CertStoreParameters {
*
* @param serverName the DNS name of the LDAP server
* @param port the port number of the LDAP server
* @exception NullPointerException if {@code serverName} is
* @throws NullPointerException if {@code serverName} is
* {@code null}
*/
public LDAPCertStoreParameters(String serverName, int port) {
@ -84,7 +84,7 @@ public class LDAPCertStoreParameters implements CertStoreParameters {
* specified server name and a default port of 389.
*
* @param serverName the DNS name of the LDAP server
* @exception NullPointerException if {@code serverName} is
* @throws NullPointerException if {@code serverName} is
* {@code null}
*/
public LDAPCertStoreParameters(String serverName) {

4
src/java.base/share/classes/java/security/cert/PKIXCertPathChecker.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2000, 2019, 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
@ -158,7 +158,7 @@ public abstract class PKIXCertPathChecker
* @param cert the {@code Certificate} to be checked
* @param unresolvedCritExts a {@code Collection} of OID strings
* representing the current set of unresolved critical extensions
* @exception CertPathValidatorException if the specified certificate does
* @throws CertPathValidatorException if the specified certificate does
* not pass the check
*/
public abstract void check(Certificate cert,

4
src/java.base/share/classes/java/security/cert/PolicyQualifierInfo.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2000, 2019, 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
@ -94,7 +94,7 @@ public class PolicyQualifierInfo {
* encoded bytes. The encoded byte array is copied on construction.
*
* @param encoded a byte array containing the qualifier in DER encoding
* @exception IOException thrown if the byte array does not represent a
* @throws IOException thrown if the byte array does not represent a
* valid and parsable policy qualifier
*/
public PolicyQualifierInfo(byte[] encoded) throws IOException {

34
src/java.base/share/classes/java/security/cert/X509CRL.java
View file

@ -170,7 +170,7 @@ public abstract class X509CRL extends CRL implements X509Extension {
* Returns the ASN.1 DER-encoded form of this CRL.
*
* @return the encoded form of this certificate
* @exception CRLException if an encoding error occurs.
* @throws CRLException if an encoding error occurs.
*/
public abstract byte[] getEncoded()
throws CRLException;
@ -181,12 +181,12 @@ public abstract class X509CRL extends CRL implements X509Extension {
*
* @param key the PublicKey used to carry out the verification.
*
* @exception NoSuchAlgorithmException on unsupported signature
* @throws NoSuchAlgorithmException on unsupported signature
* algorithms.
* @exception InvalidKeyException on incorrect key.
* @exception NoSuchProviderException if there's no default provider.
* @exception SignatureException on signature errors.
* @exception CRLException on encoding errors.
* @throws InvalidKeyException on incorrect key.
* @throws NoSuchProviderException if there's no default provider.
* @throws SignatureException on signature errors.
* @throws CRLException on encoding errors.
*/
public abstract void verify(PublicKey key)
throws CRLException, NoSuchAlgorithmException,
@ -202,12 +202,12 @@ public abstract class X509CRL extends CRL implements X509Extension {
* @param key the PublicKey used to carry out the verification.
* @param sigProvider the name of the signature provider.
*
* @exception NoSuchAlgorithmException on unsupported signature
* @throws NoSuchAlgorithmException on unsupported signature
* algorithms.
* @exception InvalidKeyException on incorrect key.
* @exception NoSuchProviderException on incorrect provider.
* @exception SignatureException on signature errors.
* @exception CRLException on encoding errors.
* @throws InvalidKeyException on incorrect key.
* @throws NoSuchProviderException on incorrect provider.
* @throws SignatureException on signature errors.
* @throws CRLException on encoding errors.
*/
public abstract void verify(PublicKey key, String sigProvider)
throws CRLException, NoSuchAlgorithmException,
@ -229,11 +229,11 @@ public abstract class X509CRL extends CRL implements X509Extension {
* @param key the PublicKey used to carry out the verification.
* @param sigProvider the signature provider.
*
* @exception NoSuchAlgorithmException on unsupported signature
* @throws NoSuchAlgorithmException on unsupported signature
* algorithms.
* @exception InvalidKeyException on incorrect key.
* @exception SignatureException on signature errors.
* @exception CRLException on encoding errors.
* @throws InvalidKeyException on incorrect key.
* @throws SignatureException on signature errors.
* @throws CRLException on encoding errors.
* @since 1.8
*/
public void verify(PublicKey key, Provider sigProvider)
@ -383,7 +383,7 @@ public abstract class X509CRL extends CRL implements X509Extension {
* up
* @return the entry for the given certificate, or null if no such entry
* exists in this CRL.
* @exception NullPointerException if certificate is null
* @throws NullPointerException if certificate is null
*
* @since 1.5
*/
@ -411,7 +411,7 @@ public abstract class X509CRL extends CRL implements X509Extension {
* This can be used to verify the signature independently.
*
* @return the DER-encoded CRL information.
* @exception CRLException if an encoding error occurs.
* @throws CRLException if an encoding error occurs.
*/
public abstract byte[] getTBSCertList() throws CRLException;

4
src/java.base/share/classes/java/security/cert/X509CRLEntry.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1997, 2019, 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,7 +122,7 @@ public abstract class X509CRLEntry implements X509Extension {
* that is the inner SEQUENCE.
*
* @return the encoded form of this certificate
* @exception CRLException if an encoding error occurs.
* @throws CRLException if an encoding error occurs.
*/
public abstract byte[] getEncoded() throws CRLException;

20
src/java.base/share/classes/java/security/cert/X509Certificate.java
View file

@ -141,8 +141,8 @@ implements X509Extension {
* generalTime GeneralizedTime }
* </pre>
*
* @exception CertificateExpiredException if the certificate has expired.
* @exception CertificateNotYetValidException if the certificate is not
* @throws CertificateExpiredException if the certificate has expired.
* @throws CertificateNotYetValidException if the certificate is not
* yet valid.
*/
public abstract void checkValidity()
@ -156,9 +156,9 @@ implements X509Extension {
* @param date the Date to check against to see if this certificate
* is valid at that date/time.
*
* @exception CertificateExpiredException if the certificate has expired
* @throws CertificateExpiredException if the certificate has expired
* with respect to the {@code date} supplied.
* @exception CertificateNotYetValidException if the certificate is not
* @throws CertificateNotYetValidException if the certificate is not
* yet valid with respect to the {@code date} supplied.
*
* @see #checkValidity()
@ -334,7 +334,7 @@ implements X509Extension {
* This can be used to verify the signature independently.
*
* @return the DER-encoded certificate information.
* @exception CertificateEncodingException if an encoding error occurs.
* @throws CertificateEncodingException if an encoding error occurs.
*/
public abstract byte[] getTBSCertificate()
throws CertificateEncodingException;
@ -666,12 +666,12 @@ implements X509Extension {
* @param key the PublicKey used to carry out the verification.
* @param sigProvider the signature provider.
*
* @exception NoSuchAlgorithmException on unsupported signature
* @throws NoSuchAlgorithmException on unsupported signature
* algorithms.
* @exception InvalidKeyException on incorrect key.
* @exception SignatureException on signature errors.
* @exception CertificateException on encoding errors.
* @exception UnsupportedOperationException if the method is not supported
* @throws InvalidKeyException on incorrect key.
* @throws SignatureException on signature errors.
* @throws CertificateException on encoding errors.
* @throws UnsupportedOperationException if the method is not supported
* @since 1.8
*/
public void verify(PublicKey key, Provider sigProvider)

6
src/java.base/share/classes/java/security/interfaces/DSAKeyPairGenerator.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1997, 2019, 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
@ -85,7 +85,7 @@ public interface DSAKeyPairGenerator {
* @param random the random bit source to use to generate key bits;
* can be null.
*
* @exception InvalidParameterException if the {@code params}
* @throws InvalidParameterException if the {@code params}
* value is invalid, null, or unsupported.
*/
public void initialize(DSAParams params, SecureRandom random)
@ -112,7 +112,7 @@ public interface DSAKeyPairGenerator {
* @param genParams whether or not to generate new parameters for
* the modulus length requested.
*
* @exception InvalidParameterException if {@code modlen} is
* @throws InvalidParameterException if {@code modlen} is
* invalid, or unsupported, or if {@code genParams} is false and there
* are no precomputed parameters for the requested modulus length.
*/

6
src/java.base/share/classes/java/security/spec/DSAGenParameterSpec.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2012, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2012, 2019, 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
@ -46,7 +46,7 @@ public final class DSAGenParameterSpec implements AlgorithmParameterSpec {
* length of the domain parameter seed in bits.
* @param primePLen the desired length of the prime P in bits.
* @param subprimeQLen the desired length of the sub-prime Q in bits.
* @exception IllegalArgumentException if {@code primePLen}
* @throws IllegalArgumentException if {@code primePLen}
* or {@code subprimeQLen} is illegal per the specification of
* FIPS 186-3.
*/
@ -62,7 +62,7 @@ public final class DSAGenParameterSpec implements AlgorithmParameterSpec {
* @param subprimeQLen the desired length of the sub-prime Q in bits.
* @param seedLen the desired length of the domain parameter seed in bits,
* shall be equal to or greater than {@code subprimeQLen}.
* @exception IllegalArgumentException if {@code primePLenLen},
* @throws IllegalArgumentException if {@code primePLenLen},
* {@code subprimeQLen}, or {@code seedLen} is illegal per the
* specification of FIPS 186-3.
*/

12
src/java.base/share/classes/java/security/spec/ECFieldF2m.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2003, 2019, 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
@ -47,7 +47,7 @@ public class ECFieldF2m implements ECField {
* Creates an elliptic curve characteristic 2 finite
* field which has 2^{@code m} elements with normal basis.
* @param m with 2^{@code m} being the number of elements.
* @exception IllegalArgumentException if {@code m}
* @throws IllegalArgumentException if {@code m}
* is not positive.
*/
public ECFieldF2m(int m) {
@ -76,8 +76,8 @@ public class ECFieldF2m implements ECField {
* @param m with 2^{@code m} being the number of elements.
* @param rp the BigInteger whose i-th bit corresponds to
* the i-th coefficient of the reduction polynomial.
* @exception NullPointerException if {@code rp} is null.
* @exception IllegalArgumentException if {@code m}
* @throws NullPointerException if {@code rp} is null.
* @throws IllegalArgumentException if {@code m}
* is not positive, or {@code rp} does not represent
* a valid reduction polynomial.
*/
@ -123,8 +123,8 @@ public class ECFieldF2m implements ECField {
* @param ks the order of the middle term(s) of the
* reduction polynomial. Contents of this array are copied
* to protect against subsequent modification.
* @exception NullPointerException if {@code ks} is null.
* @exception IllegalArgumentException if{@code m}
* @throws NullPointerException if {@code ks} is null.
* @throws IllegalArgumentException if{@code m}
* is not positive, or the length of {@code ks}
* is neither 1 nor 3, or values in {@code ks}
* are not between {@code m}-1 and 1 (inclusive)

6
src/java.base/share/classes/java/security/spec/ECFieldFp.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2003, 2019, 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
@ -45,8 +45,8 @@ public class ECFieldFp implements ECField {
* Creates an elliptic curve prime finite field
* with the specified prime {@code p}.
* @param p the prime.
* @exception NullPointerException if {@code p} is null.
* @exception IllegalArgumentException if {@code p}
* @throws NullPointerException if {@code p} is null.
* @throws IllegalArgumentException if {@code p}
* is not positive.
*/
public ECFieldFp(BigInteger p) {

6
src/java.base/share/classes/java/security/spec/ECParameterSpec.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2003, 2019, 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,9 +51,9 @@ public class ECParameterSpec implements AlgorithmParameterSpec {
* @param g the generator which is also known as the base point.
* @param n the order of the generator {@code g}.
* @param h the cofactor.
* @exception NullPointerException if {@code curve},
* @throws NullPointerException if {@code curve},
* {@code g}, or {@code n} is null.
* @exception IllegalArgumentException if {@code n}
* @throws IllegalArgumentException if {@code n}
* or {@code h} is not positive.
*/
public ECParameterSpec(EllipticCurve curve, ECPoint g,

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

@ -1,5 +1,5 @@
/*
* Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2003, 2019, 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
@ -57,7 +57,7 @@ public class ECPoint {
* {@code x} and affine y-coordinate {@code y}.
* @param x the affine x-coordinate.
* @param y the affine y-coordinate.
* @exception NullPointerException if {@code x} or
* @throws NullPointerException if {@code x} or
* {@code y} is null.
*/
public ECPoint(BigInteger x, BigInteger y) {

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

@ -1,5 +1,5 @@
/*
* Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2003, 2019, 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,7 +48,7 @@ public class ECPrivateKeySpec implements KeySpec {
* @param s the private value.
* @param params the associated elliptic curve domain
* parameters.
* @exception NullPointerException if {@code s}
* @throws NullPointerException if {@code s}
* or {@code params} is null.
*/
public ECPrivateKeySpec(BigInteger s, ECParameterSpec params) {

6
src/java.base/share/classes/java/security/spec/ECPublicKeySpec.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2003, 2019, 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
@ -47,9 +47,9 @@ public class ECPublicKeySpec implements KeySpec {
* @param w the public point.
* @param params the associated elliptic curve domain
* parameters.
* @exception NullPointerException if {@code w}
* @throws NullPointerException if {@code w}
* or {@code params} is null.
* @exception IllegalArgumentException if {@code w}
* @throws IllegalArgumentException if {@code w}
* is point at infinity, i.e. ECPoint.POINT_INFINITY
*/
public ECPublicKeySpec(ECPoint w, ECParameterSpec params) {

10
src/java.base/share/classes/java/security/spec/EllipticCurve.java
View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2003, 2019, 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
@ -73,9 +73,9 @@ public class EllipticCurve {
* @param field the finite field that this elliptic curve is over.
* @param a the first coefficient of this elliptic curve.
* @param b the second coefficient of this elliptic curve.
* @exception NullPointerException if {@code field},
* @throws NullPointerException if {@code field},
* {@code a}, or {@code b} is null.
* @exception IllegalArgumentException if {@code a}
* @throws IllegalArgumentException if {@code a}
* or {@code b} is not null and not in {@code field}.
*/
public EllipticCurve(ECField field, BigInteger a,
@ -93,9 +93,9 @@ public class EllipticCurve {
* @param seed the bytes used during curve generation for later
* validation. Contents of this array are copied to protect against
* subsequent modification.
* @exception NullPointerException if {@code field},
* @throws NullPointerException if {@code field},
* {@code a}, or {@code b} is null.
* @exception IllegalArgumentException if {@code a}
* @throws IllegalArgumentException if {@code a}
* or {@code b} is not null and not in {@code field}.
*/
public EllipticCurve(ECField field, BigInteger a,

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

@ -1,5 +1,5 @@
/*
* Copyright (c) 2003, 2018, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2003, 2019, 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
@ -116,7 +116,7 @@ public class MGF1ParameterSpec implements AlgorithmParameterSpec {
*
* @param mdName the algorithm name for the message digest
* used in this mask generation function MGF1.
* @exception NullPointerException if {@code mdName} is null.
* @throws NullPointerException if {@code mdName} is null.
*/
public MGF1ParameterSpec(String mdName) {
if (mdName == null) {

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

@ -128,9 +128,9 @@ public class PSSParameterSpec implements AlgorithmParameterSpec {
* getMGFParameters().
* @param saltLen the length of salt
* @param trailerField the value of the trailer field
* @exception NullPointerException if {@code mdName}, or {@code mgfName}
* @throws NullPointerException if {@code mdName}, or {@code mgfName}
* is null
* @exception IllegalArgumentException if {@code saltLen} or
* @throws IllegalArgumentException if {@code saltLen} or
* {@code trailerField} is less than 0
* @since 1.5
*/
@ -161,7 +161,7 @@ public class PSSParameterSpec implements AlgorithmParameterSpec {
*
* @param saltLen the length of salt in bytes to be used in PKCS#1
* PSS encoding
* @exception IllegalArgumentException if {@code saltLen} is
* @throws IllegalArgumentException if {@code saltLen} is
* less than 0
*/
public PSSParameterSpec(int saltLen) {

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

@ -1,5 +1,5 @@
/*
* Copyright (c) 2001, 2018, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2001, 2019, 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
@ -67,7 +67,7 @@ public class RSAOtherPrimeInfo {
* @param primeExponent the exponent.
* @param crtCoefficient the Chinese Remainder Theorem
* coefficient.
* @exception NullPointerException if any of the parameters, i.e.
* @throws NullPointerException if any of the parameters, i.e.
* {@code prime}, {@code primeExponent},
* {@code crtCoefficient}, is null.
*