依赖注入

TabooLib 使用 侵入式 依赖注入（Dependency Injection）的方式向插件提供服务，指 TabooLib 会主动的向插件中的所有单例（object）或伴生类（companion object）中进行检查和注入工作。例如绑定一些方法或赋值 API 实例。

package io.github.username.project

import taboolib.common.platform.*
import taboolib.module.configuration.Config
import taboolib.module.configuration.SecuredFile
import org.bukkit.event.player.PlayerJoinEvent

object Example {

    @Config
    lateinit var conf: SecuredFile
        private set

    @Awake(LifeCycle.ENABLE)
    fun enable() {
        println("Successfully running ExamplePlugin!")
    }

    @SubscriptEvent
    fun fun(PlayerJoinEvent e) {
        // ...
    }
}

Warning

使用 class 是无法完成注入工作的，包括方法绑定。

package io.github.username.project

import taboolib.common.platform.*
import org.bukkit.event.player.PlayerJoinEvent

// 错误的写法
class Example {

    @SubscriptEvent
    fun fun(PlayerJoinEvent e) {
        // ...
    }
}