com.frostwire.jlibtorrent

Class SessionManager

java.lang.Object

com.frostwire.jlibtorrent.SessionManager

public class SessionManager
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SessionManager.MutableItem

Constructor Summary

Constructors

Constructor and Description
SessionManager()
SessionManager(boolean logging)

Method Summary

Modifier and Type	Method and Description
void	addListener(AlertListener listener)
void	applySettings(SettingsPack sp)
void	dhtAnnounce(Sha1Hash sha1)
void	dhtAnnounce(Sha1Hash sha1, int port, int flags)
SessionManager.MutableItem	dhtGetItem(byte[] key, byte[] salt, int timeout)
Entry	dhtGetItem(Sha1Hash sha1, int timeout)
java.util.ArrayList<TcpEndpoint>	dhtGetPeers(Sha1Hash sha1, int timeout)
long	dhtNodes()
void	dhtPutItem(byte[] publicKey, byte[] privateKey, Entry entry, byte[] salt)
Sha1Hash	dhtPutItem(Entry entry)
void	download(java.lang.String magnetUri, java.io.File saveDir) Downloads a magnet uri.
void	download(TorrentInfo ti, java.io.File saveDir)
void	download(TorrentInfo ti, java.io.File saveDir, java.io.File resumeFile, Priority[] priorities, java.util.List<TcpEndpoint> peers)
long	downloadRate()
int	downloadRateLimit()
void	downloadRateLimit(int limit)
java.lang.String	externalAddress()
byte[]	fetchMagnet(java.lang.String uri, int timeout) Similar to call fetchMagnet(String, int, boolean) with a maximum extra = false.
byte[]	fetchMagnet(java.lang.String uri, int timeout, boolean extra) Similar to call fetchMagnet(String, int, boolean, int) with a maximum size of 2MB.
byte[]	fetchMagnet(java.lang.String uri, int timeout, boolean extra, int maxSize)
protected void	finalize()
TorrentHandle	find(Sha1Hash sha1)
boolean	isDhtRunning()
boolean	isFirewalled()
boolean	isPaused()
boolean	isRunning()
java.lang.Throwable	lastAlertError() This methods return the last error recorded calling the alert listeners.
java.util.List<java.lang.String>	listenEndpoints()
java.lang.String	listenInterfaces()
void	listenInterfaces(java.lang.String value)
void	loadState(byte[] data)
java.lang.String	magnetPeers()
int	maxActiveDownloads()
void	maxActiveDownloads(int limit)
int	maxActiveSeeds()
void	maxActiveSeeds(int limit)
int	maxConnections()
void	maxConnections(int limit)
int	maxPeers()
void	maxPeers(int limit)
void	moveStorage(java.io.File dir)
protected void	onAfterStart()
protected void	onAfterStop()
protected void	onApplySettings(SettingsPack sp)
protected void	onBeforeStart()
protected void	onBeforeStop()
void	pause()
void	postDhtStats() This will cause a DhtStatsAlert to be posted.
void	postSessionStats() This function will post a SessionStatsAlert object, containing a snapshot of the performance counters from the internals of libtorrent.
void	postTorrentUpdates() This functions instructs the session to post the StateUpdateAlert, containing the status of all torrents whose state changed since the last time this function was called.
void	remove(TorrentHandle th)
void	remove(TorrentHandle th, remove_flags_t options)
void	removeListener(AlertListener listener)
void	reopenNetworkSockets() Instructs the session to reopen all listen and outgoing sockets.
void	restart() This method blocks for at least a second plus the time needed to destroy the native session, don't call it from the UI thread.
void	resume()
byte[]	saveState()
SettingsPack	settings() Returns a setting pack with all the settings the current session is working with.
void	start()
void	start(SessionParams params)
void	startDht()
SessionStats	stats()
void	stop() This method blocks during the destruction of the native session, it could take some time, don't call this from the UI thread or other sensitive multithreaded code.
void	stopDht()
session	swig()
long	totalDownload()
long	totalUpload()
long	uploadRate()
int	uploadRateLimit()
void	uploadRateLimit(int limit)

Methods inherited from class java.lang.Object

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

Constructor Detail

SessionManager

public SessionManager(boolean logging)

SessionManager

public SessionManager()

Method Detail

swig

public session swig()

addListener

public void addListener(AlertListener listener)

removeListener

public void removeListener(AlertListener listener)

start

public void start(SessionParams params)

start

public void start()

stop

public void stop()

This method blocks during the destruction of the native session, it could take some time, don't call this from the UI thread or other sensitive multithreaded code.

restart

public void restart()

This method blocks for at least a second plus the time needed to destroy the native session, don't call it from the UI thread.

isRunning

public boolean isRunning()

pause

public void pause()

resume

public void resume()

isPaused

public boolean isPaused()

stats

public SessionStats stats()

downloadRate

public long downloadRate()

uploadRate

public long uploadRate()

totalDownload

public long totalDownload()

totalUpload

public long totalUpload()

dhtNodes

public long dhtNodes()

isFirewalled

public boolean isFirewalled()

externalAddress

public java.lang.String externalAddress()

listenEndpoints

public java.util.List<java.lang.String> listenEndpoints()

settings

public SettingsPack settings()

Returns a setting pack with all the settings the current session is working with.

If the current internal session is null, returns null.

Returns:

applySettings

public void applySettings(SettingsPack sp)

downloadRateLimit

public int downloadRateLimit()

downloadRateLimit

public void downloadRateLimit(int limit)

uploadRateLimit

public int uploadRateLimit()

uploadRateLimit

public void uploadRateLimit(int limit)

maxActiveDownloads

public int maxActiveDownloads()

maxActiveDownloads

public void maxActiveDownloads(int limit)

maxActiveSeeds

public int maxActiveSeeds()

maxActiveSeeds

public void maxActiveSeeds(int limit)

maxConnections

public int maxConnections()

maxConnections

public void maxConnections(int limit)

maxPeers

public int maxPeers()

maxPeers

public void maxPeers(int limit)

listenInterfaces

public java.lang.String listenInterfaces()

listenInterfaces

public void listenInterfaces(java.lang.String value)

postSessionStats

public void postSessionStats()

This function will post a SessionStatsAlert object, containing a snapshot of the performance counters from the internals of libtorrent.

postDhtStats

public void postDhtStats()

This will cause a DhtStatsAlert to be posted.

postTorrentUpdates

public void postTorrentUpdates()

This functions instructs the session to post the StateUpdateAlert, containing the status of all torrents whose state changed since the last time this function was called.

Only torrents who has the state subscription flag set will be included.

isDhtRunning

public boolean isDhtRunning()

startDht

public void startDht()

stopDht

public void stopDht()

find

public TorrentHandle find(Sha1Hash sha1)

download

public void download(TorrentInfo ti,
                     java.io.File saveDir,
                     java.io.File resumeFile,
                     Priority[] priorities,
                     java.util.List<TcpEndpoint> peers)

Parameters:

ti - the torrent info to download

saveDir - the path to save the downloaded files

resumeFile - the file with the resume file

priorities - the initial file priorities

download

public void download(java.lang.String magnetUri,
                     java.io.File saveDir)

Downloads a magnet uri.

Parameters:

magnetUri - the magnet uri to download

saveDir - the path to save the downloaded files

download

public void download(TorrentInfo ti,
                     java.io.File saveDir)

Parameters:

ti -

saveDir -

remove

public void remove(TorrentHandle th,
                   remove_flags_t options)

remove

public void remove(TorrentHandle th)

fetchMagnet

public byte[] fetchMagnet(java.lang.String uri,
                          int timeout,
                          boolean extra,
                          int maxSize)

Parameters:

uri - magnet uri

timeout - in seconds

maxSize - in bytes

extra - if extra data is included

Returns:

the bencoded info or null

fetchMagnet

public byte[] fetchMagnet(java.lang.String uri,
                          int timeout,
                          boolean extra)

Similar to call fetchMagnet(String, int, boolean, int) with a maximum size of 2MB.

Parameters:

uri - magnet uri

timeout - in seconds

extra - if extra data is included

Returns:

the bencoded info or null

fetchMagnet

public byte[] fetchMagnet(java.lang.String uri,
                          int timeout)

Similar to call fetchMagnet(String, int, boolean) with a maximum extra = false.

Parameters:

uri -

timeout -

Returns:

the bencoded info or null

dhtGetItem

public Entry dhtGetItem(Sha1Hash sha1,
                        int timeout)

Parameters:

sha1 -

timeout - in seconds

Returns:

the item

dhtPutItem

public Sha1Hash dhtPutItem(Entry entry)

Parameters:

entry - the data

Returns:

the target key

dhtGetItem

public SessionManager.MutableItem dhtGetItem(byte[] key,
                                             byte[] salt,
                                             int timeout)

dhtPutItem

public void dhtPutItem(byte[] publicKey,
                       byte[] privateKey,
                       Entry entry,
                       byte[] salt)

dhtGetPeers

public java.util.ArrayList<TcpEndpoint> dhtGetPeers(Sha1Hash sha1,
                                                    int timeout)

Parameters:

sha1 -

timeout - in seconds

Returns:

the peer list or an empty list

dhtAnnounce

public void dhtAnnounce(Sha1Hash sha1,
                        int port,
                        int flags)

dhtAnnounce

public void dhtAnnounce(Sha1Hash sha1)

moveStorage

public void moveStorage(java.io.File dir)

Parameters:

dir -

saveState

public byte[] saveState()

loadState

public void loadState(byte[] data)

reopenNetworkSockets

public void reopenNetworkSockets()

Instructs the session to reopen all listen and outgoing sockets.

It's useful in the case your platform doesn't support the built in IP notifier mechanism, or if you have a better more reliable way to detect changes in the IP routing table.

magnetPeers

public java.lang.String magnetPeers()

lastAlertError

public java.lang.Throwable lastAlertError()

This methods return the last error recorded calling the alert listeners.

Returns:

the last alert listener exception registered (or null)

onBeforeStart

protected void onBeforeStart()

onAfterStart

protected void onAfterStart()

onBeforeStop

protected void onBeforeStop()

onAfterStop

protected void onAfterStop()

onApplySettings

protected void onApplySettings(SettingsPack sp)

finalize

protected void finalize()
                 throws java.lang.Throwable

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable