com.atlassian.plugin
Interface PluginController

All Known Subinterfaces:

PluginManager

All Known Implementing Classes:

DefaultPluginManager, DefaultPluginManager

public interface PluginController

Interface to control the state of the plugin system

Method Summary

void	disablePlugin(java.lang.String key) Disables the plugin with the given key.
void	disablePluginModule(java.lang.String completeKey) Disable a plugin module by key.
void	disablePluginWithoutPersisting(java.lang.String key) Disables the plugin with the given key without persisting the disabled state.
void	enablePlugin(java.lang.String key) Enable a plugin by key.
void	enablePluginModule(java.lang.String completeKey) Enable a plugin module by key.
java.lang.String	installPlugin(PluginArtifact pluginArtifact) Deprecated. Since 2.3.0, use installPlugins(PluginArtifact[]) instead
java.util.Set<java.lang.String>	installPlugins(PluginArtifact... pluginArtifacts) Installs multiple plugins and returns the list of plugin keys.
int	scanForNewPlugins() Search all loaders and add any new plugins you find.
void	uninstall(Plugin plugin) Uninstall the plugin, disabling it first.

Method Detail

enablePlugin

void enablePlugin(java.lang.String key)

Enable a plugin by key.

Parameters:

key - The plugin key.

disablePlugin

void disablePlugin(java.lang.String key)

Disables the plugin with the given key.

Calling this method will persist the disabled state so that the plugin will also be disabled on next startup. This would normally be used when a user manually disables a plugin.

If you extend DefaultPluginManager and override this method, you will also need to override disablePluginWithoutPersisting(String).

Parameters:

key - The plugin key.

See Also:

disablePluginWithoutPersisting(String)

disablePluginWithoutPersisting

void disablePluginWithoutPersisting(java.lang.String key)

Disables the plugin with the given key without persisting the disabled state.

Calling this method will NOT persist the disabled state so that the framework will try to enable the plugin on next startup. This is used when a plugin has errors on startup.

If you extend DefaultPluginManager and override disablePlugin(String), you will also need to override this method.

Parameters:

key - The plugin key.

Since:

2.3.0

See Also:

disablePlugin(String)

enablePluginModule

void enablePluginModule(java.lang.String completeKey)

Enable a plugin module by key.

Parameters:

completeKey - The "complete key" of the plugin module.

disablePluginModule

void disablePluginModule(java.lang.String completeKey)

Disable a plugin module by key.

Parameters:

completeKey - The "complete key" of the plugin module.

installPlugin

java.lang.String installPlugin(PluginArtifact pluginArtifact)
                               throws PluginParseException

Deprecated. Since 2.3.0, use installPlugins(PluginArtifact[]) instead

Installs a plugin and returns the plugin key

Parameters:

pluginArtifact - The plugin artifact to install

Returns:

The plugin key

Throws:

PluginParseException - if the plugin is not a valid plugin

installPlugins

java.util.Set<java.lang.String> installPlugins(PluginArtifact... pluginArtifacts)
                                               throws PluginParseException

Installs multiple plugins and returns the list of plugin keys. All plugin artifacts must be for valid plugins or none will be installed.

Parameters:

pluginArtifacts - The list of plugin artifacts to install

Returns:

A list of plugin keys

Throws:

PluginParseException - if any plugin is not a valid plugin

Since:

2.3.0

uninstall

void uninstall(Plugin plugin)
               throws PluginException

Uninstall the plugin, disabling it first.

Parameters:

plugin - The plugin.

Throws:

PluginException - if there was some problem uninstalling the plugin.

scanForNewPlugins

int scanForNewPlugins()
                      throws PluginParseException

Search all loaders and add any new plugins you find.

Returns:

The number of new plugins found.

Throws:

PluginParseException