Package org.apache.hadoop.hdfs

Interface BlockReader

All Superinterfaces:

java.lang.AutoCloseable, org.apache.hadoop.fs.ByteBufferReadable, java.io.Closeable

All Known Implementing Classes:

BlockReaderRemote, ExternalBlockReader

@Private
public interface BlockReader
extends org.apache.hadoop.fs.ByteBufferReadable, java.io.Closeable

A BlockReader is responsible for reading a single block from a single datanode.

Method Summary

Modifier and Type	Method	Description
int	available()	Returns an estimate of the number of bytes that can be read (or skipped over) from this input stream without performing network I/O.
void	close()	Close the block reader.
ClientMmap	getClientMmap(java.util.EnumSet<org.apache.hadoop.fs.ReadOption> opts)	Get a ClientMmap object for this BlockReader.
org.apache.hadoop.util.DataChecksum	getDataChecksum()
int	getNetworkDistance()	Return the network distance between local machine and the remote machine.
boolean	isShortCircuit()
int	read(byte[] buf, int off, int len)
int	readAll(byte[] buf, int offset, int len)	Similar to readFully(byte[], int, int) except that it will not throw an exception on EOF.
void	readFully(byte[] buf, int readOffset, int amtToRead)	Read exactly the given amount of data, throwing an exception if EOF is reached before that amount
long	skip(long n)	Skip the given number of bytes

Methods inherited from interface org.apache.hadoop.fs.ByteBufferReadable

read

Method Detail

read

int read(byte[] buf,
         int off,
         int len)
  throws java.io.IOException

Throws:

java.io.IOException

skip

long skip(long n)
   throws java.io.IOException

Skip the given number of bytes

Throws:

java.io.IOException

available

int available()

Returns an estimate of the number of bytes that can be read (or skipped over) from this input stream without performing network I/O. This may return more than what is actually present in the block.

close

void close()
    throws java.io.IOException

Close the block reader.

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Throws:

java.io.IOException

readFully

void readFully(byte[] buf,
               int readOffset,
               int amtToRead)
        throws java.io.IOException

Read exactly the given amount of data, throwing an exception if EOF is reached before that amount

Throws:

java.io.IOException

readAll

int readAll(byte[] buf,
            int offset,
            int len)
     throws java.io.IOException

Similar to readFully(byte[], int, int) except that it will not throw an exception on EOF. However, it differs from the simple read(byte[], int, int) call in that it is guaranteed to read the data if it is available. In other words, if this call does not throw an exception, then either the buffer has been filled or the next call will return EOF.

Throws:

java.io.IOException

isShortCircuit

boolean isShortCircuit()

Returns:

true only if this is a short-circuit read. All short-circuit reads are also local.

getClientMmap

ClientMmap getClientMmap(java.util.EnumSet<org.apache.hadoop.fs.ReadOption> opts)

Get a ClientMmap object for this BlockReader.

Parameters:

opts - The read options to use.

Returns:

The ClientMmap object, or null if mmap is not supported.

getDataChecksum

org.apache.hadoop.util.DataChecksum getDataChecksum()

Returns:

The DataChecksum used by the read block

getNetworkDistance

int getNetworkDistance()

Return the network distance between local machine and the remote machine.