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

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 {