int read(ByteBuffer buf) throws IOException
After a successful call,
buf.position() will be advanced by the
number of bytes read and
buf.limit() will be unchanged.
In the case of an exception, the state of the buffer (the contents of the
buf.limit(), etc.) is
undefined, and callers should be prepared to recover from this
Callers should use
StreamCapabilities.READBYTEBUFFER to check if the underlying
stream supports this interface, otherwise they might get a
Implementations should treat 0-length requests as legitimate, and must not signal an error upon their receipt.
buf- the ByteBuffer to receive the results of the read operation.
IOException- if there is some error performing the read
Copyright © 2021 Apache Software Foundation. All rights reserved.