Piece (Javadocs [I2P+ 2.13.0+] - API Version 0.9.70+)

java.lang.Object
- org.klomp.snark.Piece

All Implemented Interfaces:
Comparable<Piece>
```
class Piece
extends Object
implements Comparable<Piece>
```
Represents a torrent piece and tracks which peers have it and are requesting it.
This class is used internally by PeerCoordinator to manage piece selection and distribution strategies. It maintains:
- The piece identifier within the torrent
- Set of peers that have this piece available
- Set of peers currently requesting this piece
- Priority level for piece selection
Pieces are sorted by priority (highest first) and then by rarity (fewest peers having it first) to optimize download performance.
Thread Safety: This class is not thread-safe. Callers must synchronize on access to most methods.

Constructor Summary
Constructors
Constructor and Description
Piece(int id)
Creates a new Piece with the given ID.

Constructors
Constructor and Description
`Piece(int id)` Creates a new Piece with the given ID.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`addPeer(Peer peer)` Adds a peer to the set of peers that have this piece.
`void`	`clear()` Clear all knowledge of peers Caller must synchronize
`int`	`compareTo(Piece op)` Compares by highest priority first, then by rarest first.
`boolean`	`equals(Object o)`
`int`	`getId()` Returns the piece index within the torrent.
`int`	`getPeerCount()` How many peers have this piece? Caller must synchronize.
`int`	`getPriority()` Gets the current priority level for this piece.
`int`	`getRequestCount()` How many peers are requesting this piece? Caller must synchronize.
`int`	`hashCode()`
`boolean`	`isDisabled()` Checks if this piece is disabled (should not be downloaded).
`boolean`	`isRequested()` Checks if any peer is currently requesting this piece.
`boolean`	`isRequestedBy(Peer peer)` Checks if the given peer is currently requesting this piece.
`boolean`	`removePeer(Peer peer)` Removes a peer from those that have this piece.
`void`	`setDisabled()` Disables this piece so it will not be downloaded.
`void`	`setPriority(int p)` Sets the priority level for this piece.
`void`	`setRequested(Peer peer, boolean requested)` Marks a peer as requesting or no longer requesting this piece.
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - Piece
```
public Piece(int id)
```
    Creates a new Piece with the given ID.
    Parameters:
    id - the piece index within the torrent
- Method Detail
  - addPeer
```
public boolean addPeer(Peer peer)
```
    Adds a peer to the set of peers that have this piece. Caller must synchronize.
    Parameters:
    peer - the peer
    Returns:
    true if the peer was added, false if already present
  - clear
```
public void clear()
```
    Clear all knowledge of peers Caller must synchronize
  - compareTo
```
public int compareTo(Piece op)
```
    Compares by highest priority first, then by rarest first.
    Specified by:
    compareTo in interface Comparable<Piece>
    Parameters:
    op - the other Piece to compare to
    Returns:
    negative if this piece has higher priority, positive if lower
  - equals
```
public boolean equals(Object o)
```
    Overrides:
    equals in class Object
  - getId
```
public int getId()
```
    Returns the piece index within the torrent.
    Returns:
    the piece ID
  - getPeerCount
```
public int getPeerCount()
```
    How many peers have this piece? Caller must synchronize.
    Returns:
    number of peers that have this piece
  - getPriority
```
public int getPriority()
```
    Gets the current priority level for this piece.
    Returns:
    priority value (negative values indicate disabled/skipped pieces)
  - getRequestCount
```
public int getRequestCount()
```
    How many peers are requesting this piece? Caller must synchronize.
    Returns:
    number of peers requesting this piece
  - hashCode
```
public int hashCode()
```
    Overrides:
    hashCode in class Object
  - isDisabled
```
public boolean isDisabled()
```
    Checks if this piece is disabled (should not be downloaded).
    Returns:
    true if disabled (priority < 0), false otherwise
  - isRequested
```
public boolean isRequested()
```
    Checks if any peer is currently requesting this piece. Caller must synchronize.
    Returns:
    true if at least one peer is requesting this piece
  - isRequestedBy
```
public boolean isRequestedBy(Peer peer)
```
    Checks if the given peer is currently requesting this piece. Caller must synchronize.
    Parameters:
    peer - the peer
    Returns:
    true if peer is requesting, false otherwise
  - removePeer
```
public boolean removePeer(Peer peer)
```
    Removes a peer from those that have this piece. Caller must synchronize.
    Parameters:
    peer - the peer
    Returns:
    true if removed
  - setDisabled
```
public void setDisabled()
```
    Disables this piece so it will not be downloaded. Sets priority to -1.
  - setPriority
```
public void setPriority(int p)
```
    Sets the priority level for this piece.
    Parameters:
    p - priority value (negative to disable, 0 or positive for normal priority)
  - setRequested
```
public void setRequested(Peer peer,
                         boolean requested)
```
    Marks a peer as requesting or no longer requesting this piece. Used to avoid deadlocks when querying each peer. Caller must synchronize.
    Parameters:
    peer - the peer
    requested - true to mark as requested, false to unmark
  - toString
```
public String toString()
```
    Overrides:
    toString in class Object

Class Piece

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Piece

Method Detail

addPeer

clear

compareTo

equals

getId

getPeerCount

getPriority

getRequestCount

hashCode

isDisabled

isRequested

isRequestedBy

removePeer

setDisabled

setPriority

setRequested

toString