Class DiskManagerPieceImpl

java.lang.Object

com.biglybt.core.disk.impl.DiskManagerPieceImpl

All Implemented Interfaces:

DiskManagerPiece

public class DiskManagerPieceImpl
extends Object
implements DiskManagerPiece

Field Summary

Fields

Modifier and Type	Field	Description
private final DiskManagerHelper	diskManager
private boolean	done
private final short	nbBlocks	the number of blocks in this piece: can be short as this gives up to .5GB piece sizes with 16K blocks
private static final byte	PIECE_STATUS_CHECKING
private static final byte	PIECE_STATUS_MASK_DOWNLOADABLE
private static final byte	PIECE_STATUS_MASK_NEEDS_CHECK
private static final byte	PIECE_STATUS_NEEDED
private static final byte	PIECE_STATUS_WRITTEN
private static final byte	PIECE_STATUS2_MERGE_READ
private static final byte	PIECE_STATUS2_MERGE_WRITE
private final int	pieceNumber
private short	read_count	it's *very* important to accurately maintain the "done" state of a piece.
private byte	statusFlags
private byte	statusFlags2
protected boolean[]	written

Constructor Summary

Constructors

Constructor	Description
DiskManagerPieceImpl(DiskManagerHelper _disk_manager, int pieceIndex, int length)

Method Summary

Modifier and Type	Method	Description
boolean	calcDone()
boolean	calcNeeded()
void	clearNeeded()
void	clearWritten(int blockNumber)
int	getBlockSize(int blockNumber)
int	getLength()
DiskManager	getManager()
int	getNbBlocks()
int	getNbWritten()
DMPieceList	getPieceList()
int	getPieceNumber()
short	getReadCount()
int	getRemaining()
String	getString()
boolean[]	getWritten()	written[] can be null, in which case if the piece is Done, all blocks are complete otherwise no blocks are complete
boolean	isChecking()
boolean	isDone()
boolean	isDownloadable()	This must not be used to qualify pieces in End Game Mode.
boolean	isInteresting()
boolean	isMergeRead()
boolean	isMergeWrite()
boolean	isNeeded()
boolean	isNeedsCheck()
boolean	isSkipped()	returns true if all the files that the piece spans are skipped
boolean	isWritten()
boolean	isWritten(int blockNumber)
void	reDownloadBlock(int blockNumber)
void	reset()
void	setChecking()
void	setDone(boolean b)
void	setDoneSupport(boolean b)	this is ONLY used by the disk manager to update the done state while synchronized i.e.
void	setDownloadable()
void	setMergeRead()
void	setMergeWrite()
void	setNeeded()
void	setNeeded(boolean b)
void	setReadCount(short c)
void	setWritten(int blockNumber)
boolean	spansFiles()

Methods inherited from class Object

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

Field Details

PIECE_STATUS_NEEDED

private static final byte PIECE_STATUS_NEEDED

See Also:

• Constant Field Values

PIECE_STATUS_WRITTEN

private static final byte PIECE_STATUS_WRITTEN

See Also:

• Constant Field Values

PIECE_STATUS_CHECKING

private static final byte PIECE_STATUS_CHECKING

See Also:

• Constant Field Values

PIECE_STATUS2_MERGE_READ

private static final byte PIECE_STATUS2_MERGE_READ

See Also:

• Constant Field Values

PIECE_STATUS2_MERGE_WRITE

private static final byte PIECE_STATUS2_MERGE_WRITE

See Also:

• Constant Field Values

PIECE_STATUS_MASK_DOWNLOADABLE

private static final byte PIECE_STATUS_MASK_DOWNLOADABLE

See Also:

• Constant Field Values

PIECE_STATUS_MASK_NEEDS_CHECK

private static final byte PIECE_STATUS_MASK_NEEDS_CHECK

See Also:

• Constant Field Values

diskManager

private final DiskManagerHelper diskManager

pieceNumber

private final int pieceNumber

nbBlocks

private final short nbBlocks

the number of blocks in this piece: can be short as this gives up to .5GB piece sizes with 16K blocks

written

protected volatile boolean[] written

statusFlags

private byte statusFlags

statusFlags2

private byte statusFlags2

read_count

private short read_count

it's *very* important to accurately maintain the "done" state of a piece. Currently the statusFlags are updated in a non-thread-safe manner so a 'done' field is maintained separately. Synchronizing access to statusFlags or done would cause a tremendous performance hit.

done

private boolean done

Constructor Details

DiskManagerPieceImpl

public DiskManagerPieceImpl(DiskManagerHelper _disk_manager,
 int pieceIndex,
 int length)

Method Details

getManager

public DiskManager getManager()

Specified by:

getManager in interface DiskManagerPiece

getPieceNumber

public int getPieceNumber()

Specified by:

getPieceNumber in interface DiskManagerPiece

getLength

public int getLength()

Specified by:

getLength in interface DiskManagerPiece

Returns:

int number of bytes in the piece

getNbBlocks

public int getNbBlocks()

Specified by:

getNbBlocks in interface DiskManagerPiece

getReadCount

public short getReadCount()

Specified by:

getReadCount in interface DiskManagerPiece

setReadCount

public void setReadCount(short c)

Specified by:

setReadCount in interface DiskManagerPiece

getBlockSize

public int getBlockSize(int blockNumber)

Specified by:

getBlockSize in interface DiskManagerPiece

isSkipped

public boolean isSkipped()

Description copied from interface: DiskManagerPiece

returns true if all the files that the piece spans are skipped

Specified by:

isSkipped in interface DiskManagerPiece

Returns:

isNeeded

public boolean isNeeded()

Specified by:

isNeeded in interface DiskManagerPiece

Returns:

true if any file the piece covers is neither Do Not Download nor Delete. This is not a real-time indicator. Also, the results are not reliable for pieces that are Done. Use calcNeeded() for guaranteed correct and up to date results

calcNeeded

public boolean calcNeeded()

Specified by:

calcNeeded in interface DiskManagerPiece

spansFiles

public boolean spansFiles()

Specified by:

spansFiles in interface DiskManagerPiece

getPieceList

public DMPieceList getPieceList()

Specified by:

getPieceList in interface DiskManagerPiece

clearNeeded

public void clearNeeded()

Specified by:

clearNeeded in interface DiskManagerPiece

setNeeded

public void setNeeded()

Specified by:

setNeeded in interface DiskManagerPiece

setNeeded

public void setNeeded(boolean b)

Specified by:

setNeeded in interface DiskManagerPiece

isWritten

public boolean isWritten()

Specified by:

isWritten in interface DiskManagerPiece

getWritten

public boolean[] getWritten()

written[] can be null, in which case if the piece is Done, all blocks are complete otherwise no blocks are complete

Specified by:

getWritten in interface DiskManagerPiece

isWritten

public boolean isWritten(int blockNumber)

Specified by:

isWritten in interface DiskManagerPiece

Parameters:

blockNumber - int

Returns:

true if the given blockNumber has already been written to disk

getNbWritten

public int getNbWritten()

Specified by:

getNbWritten in interface DiskManagerPiece

setWritten

public void setWritten(int blockNumber)

Specified by:

setWritten in interface DiskManagerPiece

clearWritten

public void clearWritten(int blockNumber)

Specified by:

clearWritten in interface DiskManagerPiece

isChecking

public boolean isChecking()

Specified by:

isChecking in interface DiskManagerPiece

setChecking

public void setChecking()

Specified by:

setChecking in interface DiskManagerPiece

isNeedsCheck

public boolean isNeedsCheck()

Specified by:

isNeedsCheck in interface DiskManagerPiece

calcDone

public boolean calcDone()

Specified by:

calcDone in interface DiskManagerPiece

isDone

public boolean isDone()

Specified by:

isDone in interface DiskManagerPiece

Returns:

true when the hash check has passed and the DiskManager has asynchronously updated the Done status. There is nothing further to be done regarding downloading for pieces that are Done.

setDone

public void setDone(boolean b)

Specified by:

setDone in interface DiskManagerPiece

setDoneSupport

public void setDoneSupport(boolean b)

this is ONLY used by the disk manager to update the done state while synchronized i.e. don't use it else where!

Parameters:

b -

setDownloadable

public void setDownloadable()

Specified by:

setDownloadable in interface DiskManagerPiece

isDownloadable

public boolean isDownloadable()

Description copied from interface: DiskManagerPiece

This must not be used to qualify pieces in End Game Mode.

Specified by:

isDownloadable in interface DiskManagerPiece

Returns:

true if a piece is Needed but is not fully; Requested, Downloaded, Written, Checking, or Done.

isInteresting

public boolean isInteresting()

Specified by:

isInteresting in interface DiskManagerPiece

Returns:

true if the piece is Needed and not Done

getRemaining

public int getRemaining()

Specified by:

getRemaining in interface DiskManagerPiece

reset

public void reset()

Specified by:

reset in interface DiskManagerPiece

reDownloadBlock

public void reDownloadBlock(int blockNumber)

Specified by:

reDownloadBlock in interface DiskManagerPiece

setMergeRead

public void setMergeRead()

Specified by:

setMergeRead in interface DiskManagerPiece

isMergeRead

public boolean isMergeRead()

Specified by:

isMergeRead in interface DiskManagerPiece

setMergeWrite

public void setMergeWrite()

Specified by:

setMergeWrite in interface DiskManagerPiece

isMergeWrite

public boolean isMergeWrite()

Specified by:

isMergeWrite in interface DiskManagerPiece

getString

public String getString()

Specified by:

getString in interface DiskManagerPiece