8164993: (ch) ReadableByteChannel should note a possible ReadOnlyBufferException

[Brian Burkhalter]

With respect to [1], if for the destination buffer dst.isReadOnly() is true, then in fact an IllegalArgumentException is thrown. This should probably be documented [2].

Thanks,

Brian

[1] https://bugs.openjdk.java.net/browse/JDK-8164993 <https://bugs.openjdk.java.net/browse/JDK-8164993>
[2] 

--- a/src/java.base/share/classes/java/nio/channels/ReadableByteChannel.java
+++ b/src/java.base/share/classes/java/nio/channels/ReadableByteChannel.java
@@ -90,6 +90,10 @@
      * @throws  ClosedChannelException
      *          If this channel is closed
      *
+     * @throws  IllegalArgumentException
+     *          If the destination buffer is {@link
+     *          java.nio.Buffer#isReadOnly() read-only}
+     *
      * @throws  AsynchronousCloseException
      *          If another thread closes this channel
      *          while the read operation is in progress
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.java.net/pipermail/nio-dev/attachments/20191118/da52cb2e/attachment-0001.html>