com.frostwire.jlibtorrent

Class AnnounceEndpoint

java.lang.Object

com.frostwire.jlibtorrent.AnnounceEndpoint

public class AnnounceEndpoint
extends java.lang.Object

Announces are sent to each tracker using every listen socket, this class holds information about one listen socket for one tracker.

This class is a lightweight version of the native announce_endpoint, and only carries a subset of all the information. However, it's completely open for custom use or optimization to accommodate client necessities.

Field Summary

Fields

Modifier and Type	Field and Description
protected int	fails
protected boolean	isWorking
protected ErrorCode	lastError
protected java.lang.String	localEndpoint
protected java.lang.String	message
protected long	minAnnounce
protected long	nextAnnounce
protected int	scrapeComplete
protected int	scrapeDownloaded
protected int	scrapeIncomplete
protected boolean	updating

Constructor Summary

Constructors

Constructor and Description
AnnounceEndpoint(announce_endpoint e)

Method Summary

Modifier and Type	Method and Description
int	fails() The number of times in a row we have failed to announce to this tracker.
protected void	init(announce_endpoint e) NOTE: use this with care and only if necessary.
boolean	isWorking() Returns true if the last time we tried to announce to this tracker succeeded, or if we haven't tried yet.
ErrorCode	lastError() If this tracker failed the last time it was contacted this error code specifies what error occurred.
java.lang.String	localEndpoint() The local endpoint of the listen interface associated with this endpoint.
java.lang.String	message() If this tracker has returned an error or warning message that message is stored here.
long	minAnnounce() No announces before this time.
long	nextAnnounce() The time of next tracker announce in milliseconds.
int	scrapeComplete() This is either -1 or the scrape information this tracker last responded with.
int	scrapeDownloaded() This is either -1 or the scrape information this tracker last responded with.
int	scrapeIncomplete() This is either -1 or the scrape information this tracker last responded with.
boolean	updating() True while we're waiting for a response from the tracker.

Methods inherited from class java.lang.Object

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

Field Detail

message

protected java.lang.String message

lastError

protected ErrorCode lastError

localEndpoint

protected java.lang.String localEndpoint

nextAnnounce

protected long nextAnnounce

minAnnounce

protected long minAnnounce

scrapeIncomplete

protected int scrapeIncomplete

scrapeComplete

protected int scrapeComplete

scrapeDownloaded

protected int scrapeDownloaded

fails

protected int fails

updating

protected boolean updating

isWorking

protected boolean isWorking

Constructor Detail

AnnounceEndpoint

public AnnounceEndpoint(announce_endpoint e)

Parameters:

e - the native object

Method Detail

message

public java.lang.String message()

If this tracker has returned an error or warning message that message is stored here.

Returns:

the error or warning message

lastError

public ErrorCode lastError()

If this tracker failed the last time it was contacted this error code specifies what error occurred.

Returns:

the last error code

localEndpoint

public java.lang.String localEndpoint()

The local endpoint of the listen interface associated with this endpoint.

Returns:

the local endpoint

nextAnnounce

public long nextAnnounce()

The time of next tracker announce in milliseconds.

Returns:

the time of next tracker announce in milliseconds

minAnnounce

public long minAnnounce()

No announces before this time.

scrapeIncomplete

public int scrapeIncomplete()

This is either -1 or the scrape information this tracker last responded with. Incomplete is the current number of downloaders in the swarm.

If this tracker has returned scrape data, these fields are filled in with valid numbers. Otherwise they are set to -1.

Returns:

the number of current downloaders

scrapeComplete

public int scrapeComplete()

This is either -1 or the scrape information this tracker last responded with. Complete is the current number of seeds in the swarm.

If this tracker has returned scrape data, these fields are filled in with valid numbers. Otherwise they are set to -1.

Returns:

the current number of seeds

scrapeDownloaded

public int scrapeDownloaded()

This is either -1 or the scrape information this tracker last responded with. Downloaded is the cumulative number of completed downloads of this torrent, since the beginning of time (from this tracker's point of view).

If this tracker has returned scrape data, these fields are filled in with valid numbers. Otherwise they are set to -1.

Returns:

the cumulative number of completed downloads

fails

public int fails()

The number of times in a row we have failed to announce to this tracker.

Returns:

the number of fails

updating

public boolean updating()

True while we're waiting for a response from the tracker.

isWorking

public boolean isWorking()

Returns true if the last time we tried to announce to this tracker succeeded, or if we haven't tried yet.

init

protected void init(announce_endpoint e)

NOTE: use this with care and only if necessary.

Parameters:

e - the native object