RFR: 8267068: Incomplete @throws javadoc for various javax.crypto.spec classes

[Valerie Peng]

On Tue, 21 Jan 2025 15:53:35 GMT, Sean Mullan <mullan at openjdk.org> wrote:

>> [JDK-8267068](https://bugs.openjdk.org/browse/JDK-8267068)
>
> src/java.base/share/classes/javax/crypto/spec/IvParameterSpec.java line 73:
> 
>> 71:      * or {@code (iv.length - offset < len)}
>> 72:      * @throws ArrayIndexOutOfBoundsException if {@code offset}
>> 73:      * or {@code len} index bytes outside the {@code iv}.
> 
> can you fix this grammatical issue while you are changing this:
> 
> s/outside/are outside/

Maybe we should just state that ArrayIndexOutOfBoundsException is thrown if `offset` or `len` is negative? The current wording for AIOOBE seems to suggest that it covers the case when `offset` or `len` is too large. But that is covered by the IAE.

-------------

PR Review Comment: https://git.openjdk.org/jdk/pull/23188#discussion_r1953210851