stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

8164993: (ch) ReadableByteChannel should note a possible IllegalArgumentException

Browse Source 
Reviewed-by: alanb, darcy
This commit is contained in:
Brian Burkhalter 2019-11-22 09:00:16 -08:00
parent 8a5e087ed8
commit adf0d4eae8
4 changed files with 16 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
src/java.base/share/classes/java/nio/channels/DatagramChannel.java
View File

@ -403,6 +403,9 @@ public abstract class DatagramChannel
* or {@code null} if this channel is in non-blocking mode
* and no datagram was immediately available
*
* @throws IllegalArgumentException
* If the buffer is read-only
*
* @throws ClosedChannelException
* If this channel is closed
*

4
src/java.base/share/classes/java/nio/channels/FileChannel.java
View File

@ -1,5 +1,5 @@
/*
* Copyright (c) 2000, 2018, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -719,7 +719,7 @@ public abstract class FileChannel
* size
*
* @throws IllegalArgumentException
* If the position is negative
* If the position is negative or the buffer is read-only
*
* @throws NonReadableChannelException
* If this channel was not opened for reading

5
src/java.base/share/classes/java/nio/channels/ReadableByteChannel.java
View File

@ -1,5 +1,5 @@
/*
* Copyright (c) 2000, 2001, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -84,6 +84,9 @@ public interface ReadableByteChannel extends Channel {
* @return The number of bytes read, possibly zero, or {@code -1} if the
* channel has reached end-of-stream
*
* @throws IllegalArgumentException
* If the buffer is read-only
*
* @throws NonReadableChannelException
* If this channel was not opened for reading
*

8
src/java.base/share/classes/java/nio/channels/ScatteringByteChannel.java
View File

@ -1,5 +1,5 @@
/*
* Copyright (c) 2000, 2006, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -101,6 +101,9 @@ public interface ScatteringByteChannel
* If the preconditions on the {@code offset} and {@code length}
* parameters do not hold
*
* @throws IllegalArgumentException
* If any of the buffers is read-only
*
* @throws NonReadableChannelException
* If this channel was not opened for reading
*
@ -138,6 +141,9 @@ public interface ScatteringByteChannel
* @return The number of bytes read, possibly zero,
* or {@code -1} if the channel has reached end-of-stream
*
* @throws IllegalArgumentException
* If any of the buffers is read-only
*
* @throws NonReadableChannelException
* If this channel was not opened for reading
*