org.gudy.azureus2.plugins
Class PluginManager

java.lang.Object
  org.gudy.azureus2.plugins.PluginManager

public abstract class PluginManager
extends java.lang.Object

This class allows Azureus to be started as an embedded component and also allows plugins to be dynamically registered

Author:

parg

Field Summary

static java.lang.String	PR_MULTI_INSTANCE Property Key: Allow multiple instances.
static int	UI_NONE No user interface
static int	UI_SWT SWT user inferface

Constructor Summary

PluginManager()

Method Summary

abstract void	firePluginEvent(int event_type)
abstract PluginInterface	getDefaultPluginInterface() returns the default plugin interface that can be used to access plugin functionality without an explicit plugin
static PluginManagerDefaults	getDefaults()
abstract PluginInstaller	getPluginInstaller()
abstract PluginInterface	getPluginInterfaceByClass(java.lang.Class c)
abstract PluginInterface	getPluginInterfaceByClass(java.lang.String class_name)
abstract PluginInterface	getPluginInterfaceByID(java.lang.String id) returns the plugin interface with a given id, or null if not found
abstract PluginInterface[]	getPluginInterfaces() Gets the current set of registered plugins.
abstract PluginInterface[]	getPlugins() Gets the current set of registered plugins.
abstract boolean	isSilentRestartEnabled()
abstract void	refreshPluginList()
static void	registerPlugin(java.lang.Class plugin_class) Programatic plugin registration interface
static void	registerPlugin(Plugin plugin, java.lang.String id)
static void	restartAzureus() restarts azureus and performs any Update actions defined via the plugin "update" interface.
static PluginManager	startAzureus(int ui_type, java.util.Properties properties) Runs Azureus
static void	stopAzureus() Shuts down Azureus

Methods inherited from class java.lang.Object

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

Field Detail

UI_NONE

public static final int UI_NONE

No user interface

Since:

2.0.8.0

See Also:

Constant Field Values

UI_SWT

public static final int UI_SWT

SWT user inferface

Since:

2.0.6.0

See Also:

Constant Field Values

PR_MULTI_INSTANCE

public static final java.lang.String PR_MULTI_INSTANCE

Property Key: Allow multiple instances. Normally Azureus will only permit a single instance to run per machine. Values for this key are: "true" or "false"

Since:

2.0.7.0

See Also:

Constant Field Values

Constructor Detail

PluginManager

public PluginManager()

Method Detail

getDefaults

public static PluginManagerDefaults getDefaults()

startAzureus

public static PluginManager startAzureus(int ui_type,
                                         java.util.Properties properties)

Runs Azureus

Parameters:

ui_type - Type of user interface to provide. See UI_* Constants

properties - A list of properties to pass Azureus. See PR_* constants.

Since:

2.0.6.0

stopAzureus

public static void stopAzureus()
                        throws PluginException

Shuts down Azureus

Throws:

PluginException

Since:

2.0.8.0

restartAzureus

public static void restartAzureus()
                           throws PluginException

restarts azureus and performs any Update actions defined via the plugin "update" interface. Currently only works for SWT UIs.

Throws:

PluginException

Since:

2.1.0.0

registerPlugin

public static void registerPlugin(java.lang.Class plugin_class)

Programatic plugin registration interface

Parameters:

plugin_class - this must implement Plugin

Since:

2.0.6.0

registerPlugin

public static void registerPlugin(Plugin plugin,
                                  java.lang.String id)

getPluginInterfaceByID

public abstract PluginInterface getPluginInterfaceByID(java.lang.String id)

returns the plugin interface with a given id, or null if not found

Parameters:

id -

Returns:

Since:

2.1.0.0

getPluginInterfaceByClass

public abstract PluginInterface getPluginInterfaceByClass(java.lang.String class_name)

Since:

2.1.0.0

getPluginInterfaceByClass

public abstract PluginInterface getPluginInterfaceByClass(java.lang.Class c)

getPluginInterfaces

public abstract PluginInterface[] getPluginInterfaces()

Gets the current set of registered plugins. During initialisation this will probably give partial results as plugin initialisation is non-deterministic.

Returns:

Since:

2.1.0.0

getDefaultPluginInterface

public abstract PluginInterface getDefaultPluginInterface()

returns the default plugin interface that can be used to access plugin functionality without an explicit plugin

Returns:

null if unavailable

getPlugins

public abstract PluginInterface[] getPlugins()

Gets the current set of registered plugins. During initialisation this will probably give partial results as plugin initialisation is non-deterministic.

Returns:

Since:

2.1.0.0

firePluginEvent

public abstract void firePluginEvent(int event_type)

getPluginInstaller

public abstract PluginInstaller getPluginInstaller()

refreshPluginList

public abstract void refreshPluginList()

isSilentRestartEnabled

public abstract boolean isSilentRestartEnabled()