archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-27 06:45:07 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8294377: Prepare to stop auto-inheriting documentation for subclasses of exceptions whose documentation is inherited

Browse source 
Reviewed-by: jjg
This commit is contained in:
Pavel Rappo 2022-10-10 16:54:57 +00:00
parent 4df4a1f8e2
commit eb90c4fc04
14 changed files with 320 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

24
src/java.base/share/classes/java/nio/channels/FileChannel.java
View file

@ -372,6 +372,10 @@ public abstract class FileChannel
* then the file position is updated with the number of bytes actually
* read. Otherwise this method behaves exactly as specified in the {@link
* ReadableByteChannel} interface. </p>
*
* @throws ClosedChannelException {@inheritDoc}
* @throws AsynchronousCloseException {@inheritDoc}
* @throws ClosedByInterruptException {@inheritDoc}
*/
public abstract int read(ByteBuffer dst) throws IOException;
@ -383,6 +387,10 @@ public abstract class FileChannel
* then the file position is updated with the number of bytes actually
* read. Otherwise this method behaves exactly as specified in the {@link
* ScatteringByteChannel} interface. </p>
*
* @throws ClosedChannelException {@inheritDoc}
* @throws AsynchronousCloseException {@inheritDoc}
* @throws ClosedByInterruptException {@inheritDoc}
*/
public abstract long read(ByteBuffer[] dsts, int offset, int length)
throws IOException;
@ -394,6 +402,10 @@ public abstract class FileChannel
* then the file position is updated with the number of bytes actually
* read. Otherwise this method behaves exactly as specified in the {@link
* ScatteringByteChannel} interface. </p>
*
* @throws ClosedChannelException {@inheritDoc}
* @throws AsynchronousCloseException {@inheritDoc}
* @throws ClosedByInterruptException {@inheritDoc}
*/
public final long read(ByteBuffer[] dsts) throws IOException {
return read(dsts, 0, dsts.length);
@ -412,6 +424,10 @@ public abstract class FileChannel
*
* @throws NonWritableChannelException
* If this channel was not opened for writing
*
* @throws ClosedChannelException {@inheritDoc}
* @throws AsynchronousCloseException {@inheritDoc}
* @throws ClosedByInterruptException {@inheritDoc}
*/
public abstract int write(ByteBuffer src) throws IOException;
@ -429,6 +445,10 @@ public abstract class FileChannel
*
* @throws NonWritableChannelException
* If this channel was not opened for writing
*
* @throws ClosedChannelException {@inheritDoc}
* @throws AsynchronousCloseException {@inheritDoc}
* @throws ClosedByInterruptException {@inheritDoc}
*/
public abstract long write(ByteBuffer[] srcs, int offset, int length)
throws IOException;
@ -446,6 +466,10 @@ public abstract class FileChannel
*
* @throws NonWritableChannelException
* If this channel was not opened for writing
*
* @throws ClosedChannelException {@inheritDoc}
* @throws AsynchronousCloseException {@inheritDoc}
* @throws ClosedByInterruptException {@inheritDoc}
*/
public final long write(ByteBuffer[] srcs) throws IOException {
return write(srcs, 0, srcs.length);