Package org.apache.hadoop.hdfs.server.datanode

Interface ReplicaInPipeline

All Superinterfaces:

Replica

All Known Implementing Classes:

LocalReplicaInPipeline, ReplicaBeingWritten

public interface ReplicaInPipeline
extends Replica

This defines the interface of a replica in Pipeline that's being written to

Method Summary

Modifier and Type	Method	Description
boolean	attemptToSetWriter(java.lang.Thread prevWriter, java.lang.Thread newWriter)	Attempt to set the writer to a new value.
java.io.OutputStream	createRestartMetaStream()	Create an output stream to write restart metadata in case of datanode shutting down for quick restart.
ReplicaOutputStreams	createStreams(boolean isCreate, org.apache.hadoop.util.DataChecksum requestedChecksum)	Create output streams for writing to this replica, one for block file and one for CRC file
long	getBytesAcked()	Get the number of bytes acked
ChunkChecksum	getLastChecksumAndDataLen()	gets the last chunk checksum and the length of the block corresponding to that checksum
ReplicaInfo	getReplicaInfo()
void	interruptThread()
void	releaseAllBytesReserved()	Release any disk space reserved for this replica.
void	releaseReplicaInfoBytesReserved()	Release the reserved space from the ReplicaInfo.
void	setBytesAcked(long bytesAcked)	Set the number bytes that have acked
void	setLastChecksumAndDataLen(long dataLength, byte[] lastChecksum)	store the checksum for the last chunk along with the data length
void	setNumBytes(long bytesReceived)	Set the number of bytes received
void	setWriter(java.lang.Thread writer)	Set the thread that is writing to this replica
void	stopWriter(long xceiverStopTimeout)	Interrupt the writing thread and wait until it dies.
void	waitForMinLength(long minLength, long time, java.util.concurrent.TimeUnit unit)	Causes the current thread to wait until a minimum length is reached, the thread is interrupted, or the specified waiting time elapses.

Methods inherited from interface org.apache.hadoop.hdfs.server.datanode.Replica

getBlockId, getBytesOnDisk, getGenerationStamp, getNumBytes, getState, getStorageUuid, getVisibleLength, getVolume, isOnTransientStorage

Method Detail

setNumBytes

void setNumBytes(long bytesReceived)

Set the number of bytes received

Parameters:

bytesReceived - number of bytes received

getBytesAcked

long getBytesAcked()

Get the number of bytes acked

Returns:

the number of bytes acked

setBytesAcked

void setBytesAcked(long bytesAcked)

Set the number bytes that have acked

Parameters:

bytesAcked - number bytes acked

releaseAllBytesReserved

void releaseAllBytesReserved()

Release any disk space reserved for this replica.

releaseReplicaInfoBytesReserved

void releaseReplicaInfoBytesReserved()

Release the reserved space from the ReplicaInfo.

setLastChecksumAndDataLen

void setLastChecksumAndDataLen(long dataLength,
                               byte[] lastChecksum)

store the checksum for the last chunk along with the data length

Parameters:

dataLength - number of bytes on disk

lastChecksum - - checksum bytes for the last chunk

getLastChecksumAndDataLen

ChunkChecksum getLastChecksumAndDataLen()

gets the last chunk checksum and the length of the block corresponding to that checksum

createStreams

ReplicaOutputStreams createStreams(boolean isCreate,
                                   org.apache.hadoop.util.DataChecksum requestedChecksum)
                            throws java.io.IOException

Create output streams for writing to this replica, one for block file and one for CRC file

Parameters:

isCreate - if it is for creation

requestedChecksum - the checksum the writer would prefer to use

Returns:

output streams for writing

Throws:

java.io.IOException - if any error occurs

createRestartMetaStream

java.io.OutputStream createRestartMetaStream()
                                      throws java.io.IOException

Create an output stream to write restart metadata in case of datanode shutting down for quick restart.

Returns:

output stream for writing.

Throws:

java.io.IOException - if any error occurs

getReplicaInfo

ReplicaInfo getReplicaInfo()

setWriter

void setWriter(java.lang.Thread writer)

Set the thread that is writing to this replica

Parameters:

writer - a thread writing to this replica

interruptThread

void interruptThread()

attemptToSetWriter

boolean attemptToSetWriter(java.lang.Thread prevWriter,
                           java.lang.Thread newWriter)

Attempt to set the writer to a new value.

stopWriter

void stopWriter(long xceiverStopTimeout)
         throws java.io.IOException

Interrupt the writing thread and wait until it dies.

Throws:

java.io.IOException - the waiting is interrupted

waitForMinLength

void waitForMinLength(long minLength,
                      long time,
                      java.util.concurrent.TimeUnit unit)
               throws java.io.IOException

Causes the current thread to wait until a minimum length is reached, the thread is interrupted, or the specified waiting time elapses.

Parameters:

minLength - The minimum length to achieve

time - the maximum time to wait

unit - the time unit of the time argument

Throws:

java.io.IOException - if the current thread is interrupted or the minimum length is not achieved within the time allowed.