On Fri, 12 Aug 2022 18:47:21 GMT, Valerie Peng <[email protected]> wrote:
>> add @exception message to indicate an NPE might be thrown when the input
>> parameter is null
>
> src/java.base/share/classes/javax/crypto/MacSpi.java line 105:
>
>> 103: * @param input the ByteBuffer
>> 104: *
>> 105: * @exception NullPointerException if {@code input} is null
>
> nit: I recall @throws is preferred.
>
> How about the update(...) methods in javax.crypto.Mac class? Perhaps the NPE
> there should be documented as well?
@valeriepeng I totally agree about `@throws`. I was just going for consistency
within the file. There are other `@exception` appearances.
Yes, I do agree about the `update(ByteBuffer)` in Mac as well; however this one
throws `IllegalArgumentException` if the parameter is null. Or were you
referring to another version of the `update` method?
-------------
PR: https://git.openjdk.org/jdk/pull/9859