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

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.
*