RFR: 7113208: Incorrect javadoc on java.net.DatagramPacket.setLength() [v2]

Alan Bateman alanb at openjdk.org
Tue Aug 30 11:43:00 UTC 2022


On Fri, 26 Aug 2022 09:55:11 GMT, Jaikiran Pai <jpai at openjdk.org> wrote:

>> Can I please get a review of this javadoc only change for `DatagramPacket#setLength()` method? This addresses https://bugs.openjdk.org/browse/JDK-7113208.
>> 
>> I haven't create a CSR because the javadoc was already stating the correct behaviour in the `@throws` documentation as follows:
>> 
>>> @throws  IllegalArgumentException    if the length is negative,
>>      *          or if the length plus the offset is greater than the
>>      *          length of the packet's data buffer.
>> 
>> This commit merely fixes the main part of the javadoc.
>
> Jaikiran Pai has updated the pull request incrementally with one additional commit since the last revision:
> 
>   implement review comment

src/java.base/share/classes/java/net/DatagramPacket.java line 401:

> 399:      * will be used for receiving data. The {@code length} plus the
> 400:      * {@link #getOffset() offset} must be lesser or equal to the
> 401:      * length of the packet's data buffer.

The javadoc update looks okay.

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

PR: https://git.openjdk.org/jdk/pull/10037


More information about the net-dev mailing list