Package top.focess.qq.api.plugin

Class Plugin

java.lang.Object

top.focess.qq.api.plugin.Plugin

Direct Known Subclasses:

FocessQQ.MainPlugin, LazyPlugin

public abstract class Plugin
extends Object

Represent a Plugin class that can be load, enable and disable. Also, provide plenty of API for the plugin to get better with this framework. You should declare PluginType to this class.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Plugin()	Provide a constructor to help PluginType design.
	Plugin(String name, String author, Version version)	Initialize a Plugin instance by its name.

Method Summary

Modifier and Type	Method	Description
abstract void	disable()	Used to save some data of the plugin
abstract void	enable()	Used to initialize the plugin
boolean	equals(@Nullable Object o)
String	getAuthor()
DefaultConfig	getDefaultConfig()
@NonNull File	getDefaultFolder()
LangConfig	getLangConfig()
@NonNull String	getName()
static @Nullable Plugin	getPlugin(Class<? extends Plugin> plugin)	Get Plugin instance by the class instance
static @Nullable Plugin	getPlugin(String name)	Get Plugin instance by the name
PluginDescription	getPluginDescription()
Version	getVersion()
int	hashCode()
boolean	isEnabled()
@Nullable InputStream	loadResource(String path)
void	onDisable()
void	onEnable()
void	registerBuffer(DataConverter<?> dataConverter, DataCollection.BufferGetter bufferGetter)	Register the getter of the buffer
void	registerCommand(Command command)	Register the command
void	registerListener(Listener listener)	Register the listener into the Event chain
void	registerSpecialArgumentHandler(String name, SpecialArgumentComplexHandler handler)	Register the special argument handler
static @Nullable Plugin	thisPlugin()
void	unload()	Used to unload this plugin during enabling process This should be called in the enable() method

Methods inherited from class java.lang.Object

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

Constructor Detail

Plugin

public Plugin(String name,
              String author,
              Version version)

Initialize a Plugin instance by its name. Never instance it! It will be instanced when bot bootstraps automatically.

Parameters:

name - the plugin name

author - the plugin author

version - the plugin version

Throws:

PluginLoaderException - if the classloader of the plugin is not PluginClassLoader

Plugin

protected Plugin()

Provide a constructor to help PluginType design. Never instance it! It will be instanced when bot bootstraps automatically.

Method Detail

getPlugin

public static @Nullable Plugin getPlugin(Class<? extends Plugin> plugin)

Get Plugin instance by the class instance

Parameters:

plugin - the class instance of the plugin

Returns:

the plugin instance

See Also:

PluginClassLoader.getPlugin(Class)

getPlugin

public static @Nullable Plugin getPlugin(String name)

Get Plugin instance by the name

Parameters:

name - the name of the plugin

Returns:

the plugin instance

See Also:

PluginClassLoader.getPlugin(String)

thisPlugin

public static @Nullable Plugin thisPlugin()

getName

public final @NonNull String getName()

enable

public abstract void enable()

Used to initialize the plugin

disable

public abstract void disable()

Used to save some data of the plugin

onEnable

public final void onEnable()

onDisable

public final void onDisable()

getDefaultFolder

public final @NonNull File getDefaultFolder()

equals

public boolean equals(@Nullable Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

registerListener

public final void registerListener(Listener listener)

Register the listener into the Event chain

Parameters:

listener - the listener need to be registered

registerCommand

public final void registerCommand(Command command)

Register the command

Parameters:

command - the command need to be registered

See Also:

Command.register(Plugin, Command)

registerBuffer

public final void registerBuffer(DataConverter<?> dataConverter,
                                 DataCollection.BufferGetter bufferGetter)

Register the getter of the buffer

Parameters:

dataConverter - the buffer data converter

bufferGetter - the getter of the buffer

See Also:

DataCollection.register(Plugin, DataConverter, DataCollection.BufferGetter)

getAuthor

public final String getAuthor()

getVersion

public final Version getVersion()

getLangConfig

public final LangConfig getLangConfig()

getDefaultConfig

public final DefaultConfig getDefaultConfig()

getPluginDescription

public final PluginDescription getPluginDescription()

loadResource

public final @Nullable InputStream loadResource(String path)

isEnabled

public final boolean isEnabled()

unload

public final void unload()

Used to unload this plugin during enabling process This should be called in the enable() method

registerSpecialArgumentHandler

public final void registerSpecialArgumentHandler(String name,
                                                 SpecialArgumentComplexHandler handler)

Register the special argument handler

Parameters:

name - the name of the special argument handler

handler - the special argument handler

See Also:

CommandLine.register(Plugin, String, SpecialArgumentComplexHandler)