Class PluginInterfaceImpl

java.lang.Object

com.biglybt.pifimpl.local.PluginInterfaceImpl

All Implemented Interfaces:

CoreComponent, PluginInterface

public final class PluginInterfaceImpl
extends Object
implements PluginInterface, CoreComponent

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected class	PluginInterfaceImpl.propertyWrapper

Field Summary

Fields

Modifier and Type	Field	Description
protected List	children
protected ClassLoader	class_loader
private PluginConfigImpl	config
private CopyOnWriteList<PluginEventListener>	event_listeners
private String	given_plugin_id	This is the plugin ID value we were given when we were created.
private Set<PluginListener>	init_complete_fired_set
private PluginInitializer	initialiser
private Object	initialiser_key
private IPCInterfaceImpl	ipc_interface
private String	key
private CopyOnWriteList<PluginListener>	listeners
private Logger	logger
private static final LogIDs	LOGID
private Plugin	plugin
private String	plugin_id_to_use	We store this value as soon as someone calls getPluginID(), meaning we will return a consistent value for the plugin's lifetime.
private String	plugin_version
private String	pluginConfigKey
private String	pluginDir
private Properties	props
private final PluginStateImpl	state

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	PluginInterfaceImpl(Plugin _plugin, PluginInitializer _initialiser, Object _initialiser_key, ClassLoader _class_loader, List<File> _verified_files, String _key, Properties _props, String _pluginDir, String _plugin_id, String _plugin_version)

Method Summary

Modifier and Type	Method	Description
void	addEventListener(PluginEventListener l)
void	addListener(PluginListener l)
protected void	closedownComplete()
protected void	closedownInitiated()
protected void	destroy()
protected void	fireInitComplete(PluginListener listener)
void	firePluginEvent(PluginEvent event)	Fire a plugin-specific event.
protected void	firePluginEventSupport(PluginEvent event)
protected void	generateEvidence(IndentWriter writer)
String	getApplicationName()	Returns the name of the application that the user sees - if you need to display the name of the program, you should use this method.
String	getApplicationVersion()	Retrieve the Application's version as a string.
String	getAzureusName()	Retrieve the name of the application.
ClientIDManager	getClientIDManager()
ConnectionManager	getConnectionManager()	Get the connection manager.
DistributedDatabase	getDistributedDatabase()	Get the distributed database
DownloadManager	getDownloadManager()	Gives access to the download manager
Object	getInitializerKey()
IPCInterfaceImpl	getIPC()	Get the inter-plugin-communications interface for this plugin
IPFilter	getIPFilter()	Gives access to the IP filter
PluginInterface	getLocalPluginInterface(Class plugin_class, String id)	Returns an initialised plugin instance with its own scope (e.g.
Logger	getLogger()	Gives access to the logger
MainlineDHTManager	getMainlineDHTManager()	Returns the manager object for registering plugins that connect to the Mainline DHT.
MessageManager	getMessageManager()	Get the peer messaging manager.
String	getPerUserPluginDirectoryName()	gives access to the per-user plugin directory.
PlatformManager	getPlatformManager()	Gets the platform manager that gives access to native functionality
Plugin	getPlugin()	Gives access to the plugin itself
ClassLoader	getPluginClassLoader()	gives access to the ClassLoader used to load the plugin
PluginConfig	getPluginconfig()	Gives access to the plugin config interface
String	getPluginConfigKey()
String	getPluginDirectoryName()	Gives access to the plugin installation path - note, if you want to use this path to store data files in, it would be better for you to use PluginConfig.getPluginUserFile(String) instead.
String	getPluginID()	Returns an identifier used to identify this particular plugin
PluginManager	getPluginManager()	gives access to the plugin manager
String	getPluginName()	Returns the value of "plugin.name" if it exists in the properties file, otherwise the directory name is returned.
Properties	getPluginProperties()	gives access to the plugin properties
PluginState	getPluginState()	Returns an object that provides information the current state of the plugin, and provides various mechanisms to query and control plugins and their integration with the client at a low-level.
(package private) PluginStateImpl	getPluginStateImpl()
String	getPluginVersion()	Returns the version number of the plugin it if can be deduced from either the name of the jar file it is loaded from or the properties file.
ShareManager	getShareManager()	Gives access to the sharing functionality
ShortCuts	getShortCuts()	access to a set of convenience routines for doing things in a quicker, although less structured, fashion
TorrentManager	getTorrentManager()	Gives access to the torrent manager
Tracker	getTracker()	Gives access to the tracker functionality
UIManager	getUIManager()	access to UI extension features
UpdateManager	getUpdateManager()	access to the update manager used to update plugins.
Utilities	getUtilities()	access to various utility functions
protected void	initialisationComplete()
boolean	isInitialisationThread()	Indicates whether or not the current thread is the one responsible for running plugin initialisation
void	removeEventListener(PluginEventListener l)
void	removeListener(PluginListener l)
(package private) void	setAsFailed()
void	setPluginDirectoryName(String name)
void	setPluginName(String name)
void	setPluginVersion(String version)
protected void	unloadSupport()

Methods inherited from class Object

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

Field Details

LOGID

private static final LogIDs LOGID

plugin

private Plugin plugin

initialiser

private PluginInitializer initialiser

initialiser_key

private Object initialiser_key

class_loader

protected ClassLoader class_loader

listeners

private CopyOnWriteList<PluginListener> listeners

init_complete_fired_set

private Set<PluginListener> init_complete_fired_set

event_listeners

private CopyOnWriteList<PluginEventListener> event_listeners

key

private String key

pluginConfigKey

private String pluginConfigKey

props

private Properties props

pluginDir

private String pluginDir

config

private PluginConfigImpl config

plugin_version

private String plugin_version

logger

private Logger logger

ipc_interface

private IPCInterfaceImpl ipc_interface

children

protected List children

state

private final PluginStateImpl state

given_plugin_id

private String given_plugin_id

This is the plugin ID value we were given when we were created. We might use it, but it depends what value is the plugins properties (which will override this value).

plugin_id_to_use

private String plugin_id_to_use

We store this value as soon as someone calls getPluginID(), meaning we will return a consistent value for the plugin's lifetime.

Constructor Details

PluginInterfaceImpl

protected PluginInterfaceImpl(Plugin _plugin,
 PluginInitializer _initialiser,
 Object _initialiser_key,
 ClassLoader _class_loader,
 List<File> _verified_files,
 String _key,
 Properties _props,
 String _pluginDir,
 String _plugin_id,
 String _plugin_version)
                       throws PluginException

Throws:

PluginException

Method Details

getPlugin

public Plugin getPlugin()

Description copied from interface: PluginInterface

Gives access to the plugin itself

Specified by:

getPlugin in interface PluginInterface

getInitializerKey

public Object getInitializerKey()

getPluginManager

public PluginManager getPluginManager()

Description copied from interface: PluginInterface

gives access to the plugin manager

Specified by:

getPluginManager in interface PluginInterface

getApplicationName

public String getApplicationName()

Description copied from interface: PluginInterface

Returns the name of the application that the user sees - if you need to display the name of the program, you should use this method.

Specified by:

getApplicationName in interface PluginInterface

getAzureusName

public String getAzureusName()

Description copied from interface: PluginInterface

Retrieve the name of the application.

Specified by:

getAzureusName in interface PluginInterface

Returns:

the Application's name

getApplicationVersion

public String getApplicationVersion()

Description copied from interface: PluginInterface

Retrieve the Application's version as a string.

Specified by:

getApplicationVersion in interface PluginInterface

Returns:

Application's version. Typically in the following formats (regexp):
[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+
[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+_CVS
[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+_B[0-9]+

setPluginName

public void setPluginName(String name)

getPluginName

public String getPluginName()

Description copied from interface: PluginInterface

Returns the value of "plugin.name" if it exists in the properties file, otherwise the directory name is returned.

Specified by:

getPluginName in interface PluginInterface

setPluginVersion

public void setPluginVersion(String version)

getPluginVersion

public String getPluginVersion()

Description copied from interface: PluginInterface

Returns the version number of the plugin it if can be deduced from either the name of the jar file it is loaded from or the properties file. null otherwise

Specified by:

getPluginVersion in interface PluginInterface

Returns:

Version number as a string, or null

getPluginID

public String getPluginID()

Description copied from interface: PluginInterface

Returns an identifier used to identify this particular plugin

Specified by:

getPluginID in interface PluginInterface

getPluginProperties

public Properties getPluginProperties()

Description copied from interface: PluginInterface

gives access to the plugin properties

Specified by:

getPluginProperties in interface PluginInterface

Returns:

the properties from the file plugin.properties

getPluginDirectoryName

public String getPluginDirectoryName()

Description copied from interface: PluginInterface

Gives access to the plugin installation path - note, if you want to use this path to store data files in, it would be better for you to use PluginConfig.getPluginUserFile(String) instead.

Specified by:

getPluginDirectoryName in interface PluginInterface

Returns:

the full path the plugin is installed in

getPerUserPluginDirectoryName

public String getPerUserPluginDirectoryName()

Description copied from interface: PluginInterface

gives access to the per-user plugin directory. Useful for shared plugins that need to store per-user state. Will be same as getPluginDirectoryName for per-user installed plugins directory may not yet exist

Specified by:

getPerUserPluginDirectoryName in interface PluginInterface

setPluginDirectoryName

public void setPluginDirectoryName(String name)

getPluginconfig

public PluginConfig getPluginconfig()

Description copied from interface: PluginInterface

Gives access to the plugin config interface

Specified by:

getPluginconfig in interface PluginInterface

Returns:

the PluginConfig object associated with this plugin

getPluginConfigKey

public String getPluginConfigKey()

getTracker

public Tracker getTracker()

Description copied from interface: PluginInterface

Gives access to the tracker functionality

Specified by:

getTracker in interface PluginInterface

Returns:

The tracker

getShareManager

public ShareManager getShareManager()
                             throws ShareException

Description copied from interface: PluginInterface

Gives access to the sharing functionality

Specified by:

getShareManager in interface PluginInterface

Throws:

ShareException

getDownloadManager

public DownloadManager getDownloadManager()

Description copied from interface: PluginInterface

Gives access to the download manager

Specified by:

getDownloadManager in interface PluginInterface

Returns:

An object that allows management of downloads

getMainlineDHTManager

public MainlineDHTManager getMainlineDHTManager()

Description copied from interface: PluginInterface

Returns the manager object for registering plugins that connect to the Mainline DHT.

Specified by:

getMainlineDHTManager in interface PluginInterface

getTorrentManager

public TorrentManager getTorrentManager()

Description copied from interface: PluginInterface

Gives access to the torrent manager

Specified by:

getTorrentManager in interface PluginInterface

Returns:

An object to manage torrents

getLogger

public Logger getLogger()

Description copied from interface: PluginInterface

Gives access to the logger

Specified by:

getLogger in interface PluginInterface

Returns:

The logger

getIPFilter

public IPFilter getIPFilter()

Description copied from interface: PluginInterface

Gives access to the IP filter

Specified by:

getIPFilter in interface PluginInterface

Returns:

An object that allows access to IP Filtering

getUtilities

public Utilities getUtilities()

Description copied from interface: PluginInterface

access to various utility functions

Specified by:

getUtilities in interface PluginInterface

getShortCuts

public ShortCuts getShortCuts()

Description copied from interface: PluginInterface

access to a set of convenience routines for doing things in a quicker, although less structured, fashion

Specified by:

getShortCuts in interface PluginInterface

getUIManager

public UIManager getUIManager()

Description copied from interface: PluginInterface

access to UI extension features

Specified by:

getUIManager in interface PluginInterface

getUpdateManager

public UpdateManager getUpdateManager()

Description copied from interface: PluginInterface

access to the update manager used to update plugins. required for non-Azureus SF hosted plugins (SF ones are managed automatically)

Specified by:

getUpdateManager in interface PluginInterface

unloadSupport

protected void unloadSupport()

isInitialisationThread

public boolean isInitialisationThread()

Description copied from interface: PluginInterface

Indicates whether or not the current thread is the one responsible for running plugin initialisation

Specified by:

isInitialisationThread in interface PluginInterface

getClientIDManager

public ClientIDManager getClientIDManager()

Specified by:

getClientIDManager in interface PluginInterface

getConnectionManager

public ConnectionManager getConnectionManager()

Description copied from interface: PluginInterface

Get the connection manager.

Specified by:

getConnectionManager in interface PluginInterface

Returns:

manager

getMessageManager

public MessageManager getMessageManager()

Description copied from interface: PluginInterface

Get the peer messaging manager.

Specified by:

getMessageManager in interface PluginInterface

Returns:

manager

getDistributedDatabase

public DistributedDatabase getDistributedDatabase()

Description copied from interface: PluginInterface

Get the distributed database

Specified by:

getDistributedDatabase in interface PluginInterface

getPlatformManager

public PlatformManager getPlatformManager()

Description copied from interface: PluginInterface

Gets the platform manager that gives access to native functionality

Specified by:

getPlatformManager in interface PluginInterface

initialisationComplete

protected void initialisationComplete()

fireInitComplete

protected void fireInitComplete(PluginListener listener)

closedownInitiated

protected void closedownInitiated()

closedownComplete

protected void closedownComplete()

getPluginClassLoader

public ClassLoader getPluginClassLoader()

Description copied from interface: PluginInterface

gives access to the ClassLoader used to load the plugin

Specified by:

getPluginClassLoader in interface PluginInterface

getLocalPluginInterface

public PluginInterface getLocalPluginInterface(Class plugin_class,
 String id)
                                        throws PluginException

Description copied from interface: PluginInterface

Returns an initialised plugin instance with its own scope (e.g. for config params). Designed for loading secondary plugins directly from a primary one. Note - ensure that the bundled secondary plugins do *not* contain a plugin.properties as this will cause no end of problems.

Specified by:

getLocalPluginInterface in interface PluginInterface

Parameters:

plugin_class - must implement Plugin

id - the unique id of this plugin (used to scope config params etc)

Throws:

PluginException

getIPC

public IPCInterfaceImpl getIPC()

Description copied from interface: PluginInterface

Get the inter-plugin-communications interface for this plugin

Specified by:

getIPC in interface PluginInterface

setAsFailed

void setAsFailed()

destroy

protected void destroy()

addListener

public void addListener(PluginListener l)

Specified by:

addListener in interface PluginInterface

removeListener

public void removeListener(PluginListener l)

Specified by:

removeListener in interface PluginInterface

addEventListener

public void addEventListener(PluginEventListener l)

Specified by:

addEventListener in interface PluginInterface

removeEventListener

public void removeEventListener(PluginEventListener l)

Specified by:

removeEventListener in interface PluginInterface

firePluginEvent

public void firePluginEvent(PluginEvent event)

Description copied from interface: PluginInterface

Fire a plugin-specific event. See PluginEvent for details of type values to use

Specified by:

firePluginEvent in interface PluginInterface

Parameters:

event - plugin event

firePluginEventSupport

protected void firePluginEventSupport(PluginEvent event)

generateEvidence

protected void generateEvidence(IndentWriter writer)

getPluginState

public PluginState getPluginState()

Description copied from interface: PluginInterface

Returns an object that provides information the current state of the plugin, and provides various mechanisms to query and control plugins and their integration with the client at a low-level.

Specified by:

getPluginState in interface PluginInterface

getPluginStateImpl

PluginStateImpl getPluginStateImpl()