feat(platform): 优化部分顶层 platform 函数，使用缓存

Bkm016 · Bkm016 · commit 53a542fa158c · 2025-11-18T01:15:10.000+08:00
diff --git a/common-platform-api/src/main/kotlin/taboolib/common/platform/function/Adapter.kt b/common-platform-api/src/main/kotlin/taboolib/common/platform/function/Adapter.kt
@@ -5,34 +5,37 @@ import taboolib.common.platform.ProxyCommandSender
 import taboolib.common.platform.ProxyPlayer
 import taboolib.common.platform.service.PlatformAdapter
 import taboolib.common.util.Location
+import taboolib.common.util.unsafeLazy
 import java.util.*
 
+val adapterService by unsafeLazy { PlatformFactory.getService<PlatformAdapter>() }
+
 /**
  * 获取控制台
  */
 fun console(): ProxyCommandSender {
-    return PlatformFactory.getService<PlatformAdapter>().console()
+    return adapterService.console()
 }
 
 /**
  * 将平台实现转换为跨平台实现
  */
 fun adaptCommandSender(any: Any): ProxyCommandSender {
-    return PlatformFactory.getService<PlatformAdapter>().adaptCommandSender(any)
+    return adapterService.adaptCommandSender(any)
 }
 
 /**
  * 获取所有在线玩家
  */
 fun onlinePlayers(): List<ProxyPlayer> {
-    return PlatformFactory.getService<PlatformAdapter>().onlinePlayers()
+    return adapterService.onlinePlayers()
 }
 
 /**
  * 将平台实现转换为跨平台实现
  */
 fun adaptPlayer(any: Any): ProxyPlayer {
-    return PlatformFactory.getService<PlatformAdapter>().adaptPlayer(any)
+    return adapterService.adaptPlayer(any)
 }
 
 /**
@@ -53,20 +56,20 @@ fun getProxyPlayer(uuid: UUID): ProxyPlayer? {
  * 将平台实现转换为跨平台实现
  */
 fun adaptLocation(any: Any): Location {
-    return PlatformFactory.getService<PlatformAdapter>().adaptLocation(any)
+    return adapterService.adaptLocation(any)
 }
 
 /**
  * 将跨平台实现转换为平台实现
  */
 @Suppress("UNCHECKED_CAST")
 fun <T> platformLocation(location: Location): T {
-    return PlatformFactory.getService<PlatformAdapter>().platformLocation(location) as T
+    return adapterService.platformLocation(location) as T
 }
 
 /**
  * 获取所有世界
  */
 fun allWorlds(): List<String> {
-    return PlatformFactory.getService<PlatformAdapter>().allWorlds()
+    return adapterService.allWorlds()
 }
diff --git a/common-platform-api/src/main/kotlin/taboolib/common/platform/function/Command.kt b/common-platform-api/src/main/kotlin/taboolib/common/platform/function/Command.kt
@@ -6,6 +6,9 @@ import taboolib.common.platform.command.CommandExecutor
 import taboolib.common.platform.command.CommandStructure
 import taboolib.common.platform.command.component.CommandBase
 import taboolib.common.platform.service.PlatformCommand
+import taboolib.common.util.unsafeLazy
+
+val commandService by unsafeLazy { PlatformFactory.getService<PlatformCommand>() }
 
 /**
  *  注册一个命令
@@ -16,7 +19,7 @@ import taboolib.common.platform.service.PlatformCommand
  *  @param commandBuilder 命令构建器
  */
 fun registerCommand(command: CommandStructure, executor: CommandExecutor, completer: CommandCompleter, commandBuilder: CommandBase.() -> Unit) {
-    PlatformFactory.getService<PlatformCommand>().registerCommand(command, executor, completer, commandBuilder)
+    commandService.registerCommand(command, executor, completer, commandBuilder)
 }
 
 /**
@@ -35,12 +38,12 @@ fun unregisterCommand(command: CommandStructure) {
  * @param command 命令名称
  */
 fun unregisterCommand(command: String) {
-    PlatformFactory.getService<PlatformCommand>().unregisterCommand(command)
+    commandService.unregisterCommand(command)
 }
 
 /**
  * 注销所有命令
  */
 fun unregisterCommands() {
-    PlatformFactory.getService<PlatformCommand>().unregisterCommands()
+    commandService.unregisterCommands()
 }
diff --git a/common-platform-api/src/main/kotlin/taboolib/common/platform/function/Executor.kt b/common-platform-api/src/main/kotlin/taboolib/common/platform/function/Executor.kt
@@ -2,20 +2,23 @@ package taboolib.common.platform.function
 
 import taboolib.common.platform.PlatformFactory
 import taboolib.common.platform.service.PlatformExecutor
+import taboolib.common.util.unsafeLazy
+
+val executorService by unsafeLazy { PlatformFactory.getService<PlatformExecutor>() }
 
 /**
  * 释放在预备阶段的调度器计划
  * 这个方法只能执行一次且必须执行
  */
 fun startExecutor() {
-    PlatformFactory.getService<PlatformExecutor>().start()
+    executorService.start()
 }
 
 /**
  * 执行一个任务
  */
 fun runTask(executor: Runnable): PlatformExecutor.PlatformTask {
-    return PlatformFactory.getService<PlatformExecutor>().submit(PlatformExecutor.PlatformRunnable(now = false, async = false, delay = 0, period = 0) { executor.run() })
+    return executorService.submit(PlatformExecutor.PlatformRunnable(now = false, async = false, delay = 0, period = 0) { executor.run() })
 }
 
 /**
@@ -35,7 +38,7 @@ fun submit(
     period: Long = 0,
     executor: PlatformExecutor.PlatformTask.() -> Unit,
 ): PlatformExecutor.PlatformTask {
-    return PlatformFactory.getService<PlatformExecutor>().submit(PlatformExecutor.PlatformRunnable(now, async, delay, period, executor))
+    return executorService.submit(PlatformExecutor.PlatformRunnable(now, async, delay, period, executor))
 }
 
 /**
@@ -53,5 +56,5 @@ fun submitAsync(
     period: Long = 0,
     executor: PlatformExecutor.PlatformTask.() -> Unit,
 ): PlatformExecutor.PlatformTask {
-    return PlatformFactory.getService<PlatformExecutor>().submit(PlatformExecutor.PlatformRunnable(now, true, delay, period, executor))
+    return executorService.submit(PlatformExecutor.PlatformRunnable(now, true, delay, period, executor))
 }
diff --git a/common-platform-api/src/main/kotlin/taboolib/common/platform/function/IO.kt b/common-platform-api/src/main/kotlin/taboolib/common/platform/function/IO.kt
@@ -6,15 +6,19 @@ import taboolib.common.io.newFile
 import taboolib.common.io.runningResources
 import taboolib.common.platform.PlatformFactory
 import taboolib.common.platform.service.PlatformIO
+import taboolib.common.util.unsafeLazy
 import java.io.File
 
+val ioService by unsafeLazy { PlatformFactory.getService<PlatformIO>() }
+val ioServiceOrNull by unsafeLazy { PlatformFactory.getServiceOrNull<PlatformIO>() }
+
 /**
  * 获取控制台对象
  * 例如：
  * server<ConsoleCommandSender>()
  */
 fun <T> server(): T {
-    return PlatformFactory.getService<PlatformIO>().server()
+    return ioService.server()
 }
 
 /**
@@ -32,7 +36,7 @@ fun debug(vararg message: Any?) {
  * @param message 日志内容
  */
 fun info(vararg message: Any?) {
-    val service = PlatformFactory.getServiceOrNull<PlatformIO>()
+    val service = ioServiceOrNull
     if (service != null) {
         service.info(*message)
     } else {
@@ -46,7 +50,7 @@ fun info(vararg message: Any?) {
  * @param message 日志内容
  */
 fun severe(vararg message: Any?) {
-    val service = PlatformFactory.getServiceOrNull<PlatformIO>()
+    val service = ioServiceOrNull
     if (service != null) {
         service.severe(*message)
     } else {
@@ -60,7 +64,7 @@ fun severe(vararg message: Any?) {
  * @param message 日志内容
  */
 fun warning(vararg message: Any?) {
-    val service = PlatformFactory.getServiceOrNull<PlatformIO>()
+    val service = ioServiceOrNull
     if (service != null) {
         service.warning(*message)
     } else {
@@ -76,7 +80,7 @@ fun warning(vararg message: Any?) {
  * @param target 资源文件目标路径
  */
 fun releaseResourceFile(source: String, replace: Boolean = false, target: String = source): File {
-    return PlatformFactory.getService<PlatformIO>().releaseResourceFile(source, target, replace)
+    return ioService.releaseResourceFile(source, target, replace)
 }
 
 /**
@@ -101,21 +105,21 @@ fun releaseResourceFolder(prefix: String, replace: Boolean = false) {
  * 获取当前插件的 Jar 文件对象
  */
 fun getJarFile(): File {
-    return PlatformFactory.getService<PlatformIO>().getJarFile()
+    return ioService.getJarFile()
 }
 
 /**
  * 获取当前插件的配置文件目录
  * 可能不存在，需要手动调用 mkdirs 方法创建
  */
 fun getDataFolder(): File {
-    return PlatformFactory.getService<PlatformIO>().getDataFolder()
+    return ioService.getDataFolder()
 }
 
 /**
  * 获取当前平台的信息
  * 用于 BStats 统计，无实际用途
  */
 fun getPlatformData(): Map<String, Any> {
-    return PlatformFactory.getService<PlatformIO>().getPlatformData()
+    return ioService.getPlatformData()
 }
diff --git a/common-platform-api/src/main/kotlin/taboolib/common/platform/function/OpenContainer.kt b/common-platform-api/src/main/kotlin/taboolib/common/platform/function/OpenContainer.kt
@@ -3,12 +3,15 @@ package taboolib.common.platform.function
 import taboolib.common.OpenContainer
 import taboolib.common.platform.PlatformFactory
 import taboolib.common.platform.service.PlatformOpenContainer
+import taboolib.common.util.unsafeLazy
+
+val openContainerService by unsafeLazy { PlatformFactory.getService<PlatformOpenContainer>() }
 
 /**
  * 获取当前服务端中运行的所有开放接口
  */
 fun getOpenContainers(): List<OpenContainer> {
-    return PlatformFactory.getService<PlatformOpenContainer>().getOpenContainers()
+    return openContainerService.getOpenContainers()
 }
 
 /**
@@ -17,5 +20,5 @@ fun getOpenContainers(): List<OpenContainer> {
  * @param name 接口名称
  */
 fun getOpenContainer(name: String): OpenContainer? {
-    return PlatformFactory.getService<PlatformOpenContainer>().getOpenContainers().firstOrNull { it.name == name }
+    return openContainerService.getOpenContainers(name)
 }
diff --git a/common-platform-api/src/main/kotlin/taboolib/common/platform/function/Plugin.kt b/common-platform-api/src/main/kotlin/taboolib/common/platform/function/Plugin.kt
@@ -1,22 +1,19 @@
 package taboolib.common.platform.function
 
-import taboolib.common.platform.PlatformFactory
-import taboolib.common.platform.service.PlatformIO
+import taboolib.common.util.unsafeLazy
 
 /**
  * 获取当前插件名称
  */
-inline val pluginId: String
-    get() = PlatformFactory.getService<PlatformIO>().pluginId
+val pluginId by unsafeLazy { ioService.pluginId }
 
 /**
  * 获取当前插件版本
  */
-inline val pluginVersion: String
-    get() = PlatformFactory.getService<PlatformIO>().pluginVersion
+val pluginVersion by unsafeLazy { ioService.pluginVersion }
 
 /**
  * 当前是否在主线程中运行
  */
 inline val isPrimaryThread: Boolean
-    get() = PlatformFactory.getService<PlatformIO>().isPrimaryThread
+    get() = ioService.isPrimaryThread
diff --git a/common-platform-api/src/main/kotlin/taboolib/common/platform/service/PlatformOpenContainer.kt b/common-platform-api/src/main/kotlin/taboolib/common/platform/service/PlatformOpenContainer.kt
@@ -9,4 +9,6 @@ import taboolib.common.platform.PlatformService
 interface PlatformOpenContainer {
 
     fun getOpenContainers(): List<OpenContainer>
+
+    fun getOpenContainers(name: String): OpenContainer?
 }
diff --git a/platform/platform-afybroker/src/main/kotlin/taboolib/platform/AfyBrokerOpenContainer.kt b/platform/platform-afybroker/src/main/kotlin/taboolib/platform/AfyBrokerOpenContainer.kt
@@ -9,6 +9,7 @@ import taboolib.common.platform.PlatformSide
 import taboolib.common.platform.function.pluginId
 import taboolib.common.platform.service.PlatformOpenContainer
 import taboolib.platform.type.AfyBrokerContainer
+import java.util.concurrent.ConcurrentHashMap
 
 /**
  * TabooLib
@@ -22,13 +23,26 @@ import taboolib.platform.type.AfyBrokerContainer
 @PlatformSide(Platform.AFYBROKER)
 class AfyBrokerOpenContainer : PlatformOpenContainer {
 
-    val pluginContainer = HashMap<String, OpenContainer>()
+    val pluginContainer = ConcurrentHashMap<String, OpenContainer>()
 
     override fun getOpenContainers(): List<OpenContainer> {
         return Broker.getPluginManager().plugins.filter { it.javaClass.name.endsWith("platform.AfyBrokerPlugin") && it.description.name != pluginId }.mapNotNull {
-            pluginContainer.getOrPut(it.description.name) { AfyBrokerContainer(it) }
+            pluginContainer.computeIfAbsent(it.description.name) { _ -> AfyBrokerContainer(it) }
         }.filter {
             it.isValid
         }
     }
+
+    override fun getOpenContainers(name: String): OpenContainer? {
+        if (pluginContainer.containsKey(name)) {
+            return pluginContainer[name]
+        }
+        val plugin = Broker.getPluginManager().getPlugin(name)
+        if (plugin != null && plugin.javaClass.name.endsWith("platform.AfyBrokerPlugin")) {
+            val container = AfyBrokerContainer(plugin)
+            pluginContainer[name] = container
+            return container
+        }
+        return null
+    }
 }
diff --git a/platform/platform-bukkit-impl/src/main/kotlin/taboolib/platform/BukkitOpenContainer.kt b/platform/platform-bukkit-impl/src/main/kotlin/taboolib/platform/BukkitOpenContainer.kt
@@ -9,6 +9,7 @@ import taboolib.common.platform.PlatformSide
 import taboolib.common.platform.function.pluginId
 import taboolib.common.platform.service.PlatformOpenContainer
 import taboolib.platform.type.BukkitContainer
+import java.util.concurrent.ConcurrentHashMap
 
 /**
  * TabooLib
@@ -22,13 +23,26 @@ import taboolib.platform.type.BukkitContainer
 @PlatformSide(Platform.BUKKIT)
 class BukkitOpenContainer : PlatformOpenContainer {
 
-    val pluginContainer = HashMap<String, OpenContainer>()
+    val pluginContainer = ConcurrentHashMap<String, OpenContainer>()
 
     override fun getOpenContainers(): List<OpenContainer> {
         return Bukkit.getPluginManager().plugins.filter { it.javaClass.name.endsWith("platform.BukkitPlugin") && it.name != pluginId }.mapNotNull {
-            pluginContainer.getOrPut(it.name) { BukkitContainer(it) }
+            pluginContainer.computeIfAbsent(it.name) { _ -> BukkitContainer(it) }
         }.filter {
             it.isValid
         }
     }
+
+    override fun getOpenContainers(name: String): OpenContainer? {
+        if (pluginContainer.containsKey(name)) {
+            return pluginContainer[name]
+        }
+        val plugin = Bukkit.getPluginManager().getPlugin(name)
+        if (plugin != null && plugin.javaClass.name.endsWith("platform.BukkitPlugin")) {
+            val container = BukkitContainer(plugin)
+            pluginContainer[name] = container
+            return container
+        }
+        return null
+    }
 }
diff --git a/platform/platform-bungee-impl/src/main/kotlin/taboolib/platform/BungeeOpenContainer.kt b/platform/platform-bungee-impl/src/main/kotlin/taboolib/platform/BungeeOpenContainer.kt
diff --git a/platform/platform-velocity-impl/src/main/kotlin/taboolib/platform/VelocityOpenContainer.kt b/platform/platform-velocity-impl/src/main/kotlin/taboolib/platform/VelocityOpenContainer.kt

Original file line number	Diff line number	Diff line change
`@@ -9,4 +9,6 @@ import taboolib.common.platform.PlatformService`
`9`	`9`	`interface PlatformOpenContainer {`
`10`	`10`
`11`	`11`	`fun getOpenContainers(): List<OpenContainer>`
	`12`	`+`
	`13`	`+ fun getOpenContainers(name: String): OpenContainer?`
`12`	`14`	`}`