插件管理器

警告

这些文档是为 SpongeAPI 7 编写的,可能已经过时。 如果你觉得你可以帮助更新它们,请提交一个 PR!

插件管理器是你的插件在启动时被服务器加载后得到的。服务器加载你的插件,并找到它的由 Plugin 注解的主类,并提供一个新的实例到管理器。然后管理器将该实例保存在自己的集合中。你可以查看它并使用它自身提供的方法,从而允许你轻松地与另一个已加载的插件进行交互(如果你愿意的话)。

PluginManager 类

PluginManager 里面的公共方法用于获取加载的插件的当前集合以及它们的实例的信息。插件存储在一个 PluginContainer (下一节会提到)中,以允许我们可以方便地获取有关特定插件的一些信息。例如,你可以使用插件管理器( PluginManager )与另一个插件通信,抓取它的实例,并通过调用插件提供的方法提供可扩展性或扩展的特性。

获取插件管理器

你有数种不同的获得服务器的 PluginManager 实例的方法。

一:依赖注入

小技巧

参阅 依赖注入 页面来学习使用依赖注入。

PluginManager 是加载时注入到主类中的少数几个 API 实例之一。若要获取对它的引用,你可以创建一个新的字段来保存 PluginManager 实例,并使用 @Inject 注解。

import com.google.inject.Inject;
import org.spongepowered.api.plugin.PluginManager;

@Inject
private PluginManager pluginManager;

二:服务管理器

小技巧

请参阅 服务 以了解更多关于服务管理器(Service Manager)的完整指南。

服务管理器还包含服务器的 PluginManager 实例。使用 ServiceManager#provide(Class) 方法来获得这个实例,请传入 PluginManager.class 作为参数。

private PluginManager pluginManager = serviceManager.provideUnchecked(PluginManager.class);

三:Game 类的实例

小技巧

请参阅 Game 的 JavaDocs 以了解关于 Game 类的详细信息,包括其所有方法的使用方法。

为方便起见,一个 Game 的实例也可以提供服务端的 PluginManager 实例。

private PluginManager pluginManager = game.getPluginManager();

现在你已经有了一个插件管理器的实例了,让我们开始使用它。

四:使用 Sponge 类

Sponge 类和 Game 类的使用方式类似,唯一的区别是 Sponge 类包含了一些调用 Game 类的静态方法。而 Sponge 类随时都可以访问到,所以说你其实也可以不用存储 Game 类的实例而去调用其方法。

import org.spongepowered.api.Sponge;

private PluginManager pluginManager = Sponge.pluginManager();

使用插件管理器

插件管理器提供了若干个方法用于处理插件。

有很多方法获取一个插件的信息,在下一节中我们就会讲到使用方式。显而易见,插件容器(Plugin Container)就是一个用于存储插件主类实例的“Container”。

使用插件管理器,我们可以获取已加载的所有插件:

import org.spongepowered.plugin.PluginContainer;

import java.util.Collection;

private Collection<PluginContainer> plugins = pluginManager.getPlugins();

当然,我们也可以直接获取到一个插件的插件容器的实例,如下所示:

private PluginContainer myOtherPlugin = pluginManager.getPlugin("myOtherPluginId").orElse(null);

PluginContainer 类

当我们从一个 PluginManager 中获取到插件容器的实例时,你会很快地注意到这并不是一个真正的插件主类的实例。也就是说你获取到的插件容器仅仅是 PluginContainer 的实例,其中包含了插件主类的 @Plugin 注解提供的信息,当然也有插件主类的实例。

一个 PluginContainer 将保存由其相应的开发人员设置的插件的任何通用信息。你可以使用这些信息,而不是通过你支持的插件的硬编码而获悉。一个示例场景是,如果开发人员更改了插件的名称,那么在支持插件中对后者的引用不会因为这一更改而产生错误,前提是您已使用 PluginContainer#getName() 方法来获得它的名字。

private PluginContainer myOtherPlugin = pluginManager.getPlugin("myOtherPluginId").orElse(null);
private MyOtherPlugin pluginInstance = (MyOtherPlugin) myOtherPlugin.getInstance().orElse(null);

备注

PluginContainer#getInstance() 方法将返回一个 Object ,你需要在获取到它后将其手动强制类型转换为目标插件的主类。