TrackerClient (Javadocs [I2P+ 2.13.0+]

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

All Implemented Interfaces:
Runnable
```
public class TrackerClient
extends Object
implements Runnable
```
Handles communication with BitTorrent trackers and DHT to discover new peers.
This class manages tracker announcements and peer discovery by:
- Announcing torrent status to HTTP/HTTPS trackers
- Processing tracker responses and extracting peer information
- Managing UDP tracker communication
- Integrating with DHT for trackerless peer discovery
- Handling Peer Exchange (PEX) when available
- Managing announcement intervals and retry logic
- Processing various tracker events (started, completed, stopped)
Threading Model: The start() method creates a thread that runs one complete announcement cycle through all trackers, PEX, and DHT, then queues a new timed event and exits. This approach prevents thread accumulation while ensuring regular announcements.
The client can be restarted after halt() and handles various tracker responses including registration failures and error conditions.

Field Summary
Fields
Modifier and Type Field and Description
static int PORT
Default BitTorrent tracker port.

Fields
Modifier and Type	Field and Description
`static int`	`PORT` Default BitTorrent tracker port.

Constructor Summary
Constructors
Constructor and Description
TrackerClient(I2PSnarkUtil util, MetaInfo meta, String additionalTrackerURL, PeerCoordinator coordinator, Snark snark)
Call start() to start it.

Constructors
Constructor and Description
`TrackerClient(I2PSnarkUtil util, MetaInfo meta, String additionalTrackerURL, PeerCoordinator coordinator, Snark snark)` Call start() to start it.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`halt(boolean fast)` Interrupts this Thread to stop it.
`boolean`	`halted()` Check if this tracker client has been halted.
`static boolean`	`isValidAnnounce(String ann)`
`void`	`reinitialize()` Call after editing torrent
`void`	`run()` run.
`void`	`start()` Start the tracker client thread.
`boolean`	`started()` Check if this tracker client has been started.
`static String`	`urlencode(byte[] bs)` Very lazy byte[] to URL encoder.

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

- Field Detail
  - PORT
```
public static final int PORT
```
    Default BitTorrent tracker port.
    See Also:
    Constant Field Values
- Constructor Detail
  - TrackerClient
```
public TrackerClient(I2PSnarkUtil util,
                     MetaInfo meta,
                     String additionalTrackerURL,
                     PeerCoordinator coordinator,
                     Snark snark)
```
    Call start() to start it.
    Parameters:
    meta - null if in magnet mode
    additionalTrackerURL - may be null, from the ?tr= param in magnet mode, otherwise ignored
- Method Detail
  - halt
```
public void halt(boolean fast)
```
    Interrupts this Thread to stop it.
    Parameters:
    fast - if true, limit the life of the unannounce threads
  - halted
```
public boolean halted()
```
    Check if this tracker client has been halted.
    Returns:
    true if halted
  - isValidAnnounce
```
public static boolean isValidAnnounce(String ann)
```
    Parameters:
    ann - an announce URL, may be null, returns false if null
    Returns:
    true for i2p hosts only
  - reinitialize
```
public void reinitialize()
```
    Call after editing torrent
  - run
```
public void run()
```
    run.
    Specified by:
    run in interface Runnable
  - start
```
public void start()
```
    Start the tracker client thread.
  - started
```
public boolean started()
```
    Check if this tracker client has been started.
    Returns:
    true if started
  - urlencode
```
public static String urlencode(byte[] bs)
```
    Very lazy byte[] to URL encoder. Just encodes almost everything, even some "normal" chars. By not encoding about 1/4 of the chars, we make random data like hashes about 16% smaller.
    RFC1738: 0-9a-zA-Z$-_.+!*'(), Us: 0-9a-zA-Z
    Parameters:
    bs - the bytes to encode
    Returns:
    the URL-encoded string

Class TrackerClient

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

PORT

Constructor Detail

TrackerClient

Method Detail

halt

halted

isValidAnnounce

reinitialize

run

start

started

urlencode