org.bukkit.plugin
Interface PluginLoader

All Known Implementing Classes:

JavaPluginLoader

public interface PluginLoader

Represents a plugin loader, which handles direct access to specific types of plugins

Method Summary

Map<Class<? extends Event>,Set<RegisteredListener>>	createRegisteredListeners(Listener listener, Plugin plugin) Creates and returns registered listeners for the event classes used in this listener
void	disablePlugin(Plugin plugin) Disables the specified plugin
void	enablePlugin(Plugin plugin) Enables the specified plugin
PluginDescriptionFile	getPluginDescription(File file) Loads a PluginDescriptionFile from the specified file
Pattern[]	getPluginFileFilters() Returns a list of all filename filters expected by this PluginLoader
Plugin	loadPlugin(File file) Loads the plugin contained in the specified file

Method Detail

loadPlugin

Plugin loadPlugin(File file)
                  throws InvalidPluginException,
                         UnknownDependencyException

Loads the plugin contained in the specified file

Parameters:

file - File to attempt to load

Returns:

Plugin that was contained in the specified file, or null if unsuccessful

Throws:

InvalidPluginException - Thrown when the specified file is not a plugin

UnknownDependencyException - If a required dependency could not be found

getPluginDescription

PluginDescriptionFile getPluginDescription(File file)
                                           throws InvalidDescriptionException

Loads a PluginDescriptionFile from the specified file

Parameters:

file - File to attempt to load from

Returns:

A new PluginDescriptionFile loaded from the plugin.yml in the specified file

Throws:

InvalidDescriptionException - If the plugin description file could not be created

getPluginFileFilters

Pattern[] getPluginFileFilters()

Returns a list of all filename filters expected by this PluginLoader

Returns:

The filters

createRegisteredListeners

Map<Class<? extends Event>,Set<RegisteredListener>> createRegisteredListeners(Listener listener,
                                                                              Plugin plugin)

Creates and returns registered listeners for the event classes used in this listener

Parameters:

listener - The object that will handle the eventual call back

plugin - The plugin to use when creating registered listeners

Returns:

The registered listeners.

enablePlugin

void enablePlugin(Plugin plugin)

Enables the specified plugin

Attempting to enable a plugin that is already enabled will have no effect

Parameters:

plugin - Plugin to enable

disablePlugin

void disablePlugin(Plugin plugin)

Disables the specified plugin

Attempting to disable a plugin that is not enabled will have no effect

Parameters:

plugin - Plugin to disable