org.apache.hadoop.fs

インタフェース ByteBufferReadable

既知の実装クラスのリスト:

FSDataInputStream, HdfsDataInputStream

@InterfaceAudience.Public
 @InterfaceStability.Evolving
public interface ByteBufferReadable

Implementers of this interface provide a read API that writes to a ByteBuffer, not a byte[].

メソッドのサマリー

修飾子とタイプ	メソッドと説明
int	read(ByteBuffer buf) Reads up to buf.remaining() bytes into buf.

メソッドの詳細

read

int read(ByteBuffer buf)
  throws IOException

Reads up to buf.remaining() bytes into buf. Callers should use buf.limit(..) to control the size of the desired read.

After a successful call, buf.position() will be advanced by the number of bytes read and buf.limit() should be unchanged.

In the case of an exception, the values of buf.position() and buf.limit() are undefined, and callers should be prepared to recover from this eventuality.

Many implementations will throw UnsupportedOperationException, so callers that are not confident in support for this method from the underlying filesystem should be prepared to handle that exception.

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.

戻り値:

the number of bytes read, possibly zero, or -1 if reach end-of-stream

例外:

IOException - if there is some error performing the read