com.jivesoftware.base.plugin
Interface Plugin<T>

public interface Plugin<T>

Plugin interface. Plugins enhance the functionality of Openfire. They can:

Plugins live in the plugins directory of home. Plugins that are packaged as JAR files will be automatically expanded into directories. A plugin directory should have the following structure:

[pluginDir]
    |-- plugin.xml
    |-- classes/
    |-- lib/

The classes and lib directory are optional. Any files in the classes directory will be added to the classpath of the plugin, as well as any JAR files in the lib directory. The plugin.xml file is required, and specifies the className of the Plugin implementation. The XML file should resemble the following XML:

 <?xml version="1.0" encoding="UTF-8"?>
 <plugin>
     <class>org.example.YourPlugin</class>
     <name>Example Plugin</name>
     <description>This is an example plugin.</description>
     <author>Foo Inc.</author>
     <version>1.0</version>
     <minServerVersion>3.0.0</minServerVersion>
     <licenseType>gpl</licenseType>
 </plugin>

Each plugin will be loaded in its own class loader, unless the plugin is configured with a parent plugin.

Please see the Plugin Developer Guide (available with the Clearspace documentation) for additional details about plugin development.

Method Summary

void	destroyPlugin() Destroys the plugin.
void	initializePlugin(PluginManager manager, com.jivesoftware.base.plugin.PluginMetaData pluginData) Initializes the plugin.

Method Detail

initializePlugin

void initializePlugin(PluginManager manager,
                      com.jivesoftware.base.plugin.PluginMetaData pluginData)

Initializes the plugin.

Parameters:

manager - the plugin manager.

pluginData - Information about the plugin.

destroyPlugin

void destroyPlugin()

Destroys the plugin.

Implementations of this method must release all resources held by the plugin such as file handles, database or network connections, and references to core Openfire classes. In other words, a garbage collection executed after this method is called must be able to clean up all plugin classes.