Summary

Update specification of java.nio.channels.DatagramChannel methods connect and disconnect to indicate that they may block.

Problem

The DatagramChannel methods connect and disconnect may block if a read or write operation is in progress on the channel when they are invoked, but the specification does not state that this is the case.

Solution

Modify verbiage in DatagramChannel.connect and DatagramChannel.disconnect to indicate that they may block if a read or write operation is in progress at the moment they are invoked.

Specification

• connect

Add this verbiage:

Datagrams in the channel's {@linkplain java.net.StandardSocketOptions#SO_RCVBUF socket receive buffer}, which have not been {@linkplain #receive(ByteBuffer) received} before invoking this method, may be discarded.

If another thread has already initiated a read or write operation upon this channel, then an invocation of this method will block until any such operation is complete.

Remove this verbiage:

It will not have any effect on read or write operations that are already in progress at the moment that it is invoked.

• disconnect

Add this sentence:

If another thread has already initiated a read or write operation upon this channel, then an invocation of this method may block until any such operation is complete.

Remove this verbiage:

It will not have any effect on read or write operations that are already in progress at the moment that it is invoked.

Please also refer to the (newest) attached webrev webrev-8146298.zip.