org.apache.hadoop.hdfs

クラス ReplicaAccessor

java.lang.Object

org.apache.hadoop.hdfs.ReplicaAccessor

@InterfaceAudience.Public
 @InterfaceStability.Stable
public abstract class ReplicaAccessor
extends Object

The public API for ReplicaAccessor objects.

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
ReplicaAccessor()

メソッドのサマリー

修飾子とタイプ	メソッドと説明
abstract void	close() Release the resources associated with the ReplicaAccessor.
int	getNetworkDistance() Return the network distance between local machine and the remote machine.
abstract boolean	isLocal() Return true if bytes read via this accessor should count towards the local byte count statistics.
abstract boolean	isShortCircuit() Return true if bytes read via this accessor should count towards the short-circuit byte count statistics.
abstract int	read(long pos, byte[] buf, int off, int len) Read bytes from the replica.
abstract int	read(long pos, ByteBuffer buf) Read bytes from the replica.

クラスから継承されたメソッド java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

ReplicaAccessor

public ReplicaAccessor()

メソッドの詳細

read

public abstract int read(long pos,
                         byte[] buf,
                         int off,
                         int len)
                  throws IOException

Read bytes from the replica.

パラメータ:

pos - The position in the replica to start reading at. Must not be negative.

buf - The byte array to read into.

off - The offset within buf to start reading into.

len - The maximum length to read.

戻り値:

The number of bytes read. If the read extends past the end of the replica, a short read count will be returned. We will should return -1 if EOF is reached and no bytes can be returned. We will never return a short read count unless EOF is reached.

例外:

IOException

read

public abstract int read(long pos,
                         ByteBuffer buf)
                  throws IOException

Read bytes from the replica.

パラメータ:

pos - The position in the replica to start reading at. Must not be negative.

buf - The byte buffer to read into. The amount to read will be dictated by the remaining bytes between the current position and the limit. The ByteBuffer may or may not be direct.

戻り値:

The number of bytes read. If the read extends past the end of the replica, a short read count will be returned. We should return -1 if EOF is reached and no bytes can be returned. We will never return a short read count unless EOF is reached.

例外:

IOException

close

public abstract void close()
                    throws IOException

Release the resources associated with the ReplicaAccessor. It is recommended that implementations never throw an IOException. The method is declared as throwing IOException in order to remain compatible with java.io.Closeable. If an exception is thrown, the ReplicaAccessor must still be closed when the function returns in order to prevent a resource leak.

例外:

IOException

isLocal

public abstract boolean isLocal()

Return true if bytes read via this accessor should count towards the local byte count statistics.

isShortCircuit

public abstract boolean isShortCircuit()

Return true if bytes read via this accessor should count towards the short-circuit byte count statistics.

getNetworkDistance

public int getNetworkDistance()

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