2020-03-01 16:55:58 +08:00
|
|
|
/*
|
|
|
|
|
* Copyright 2020 Mamoe Technologies and contributors.
|
|
|
|
|
*
|
|
|
|
|
* 此源代码的使用受 GNU AFFERO GENERAL PUBLIC LICENSE version 3 许可证的约束, 可以在以下链接找到该许可证.
|
|
|
|
|
* Use of this source code is governed by the GNU AGPLv3 license that can be found through the following link.
|
|
|
|
|
*
|
|
|
|
|
* https://github.com/mamoe/mirai/blob/master/LICENSE
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
package net.mamoe.mirai
|
|
|
|
|
|
2020-03-01 17:10:55 +08:00
|
|
|
import net.mamoe.mirai.utils.MiraiInternalAPI
|
2020-03-01 16:55:58 +08:00
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 表明这个 API 是为了让 Java 使用者调用更方便.
|
2020-04-10 11:35:05 +08:00
|
|
|
* 一般有一定的性能损失, 且不能在 JVM/Android 以外平台使用. 不要在 Kotlin 调用它.
|
2020-03-01 16:55:58 +08:00
|
|
|
*/
|
2020-03-01 17:10:55 +08:00
|
|
|
@MiraiInternalAPI
|
2020-03-08 00:44:43 +08:00
|
|
|
@RequiresOptIn(level = RequiresOptIn.Level.ERROR)
|
2020-03-01 20:13:52 +08:00
|
|
|
@Target(AnnotationTarget.PROPERTY, AnnotationTarget.FUNCTION, AnnotationTarget.TYPE, AnnotationTarget.CLASS)
|
2020-03-24 16:39:06 +08:00
|
|
|
annotation class JavaFriendlyAPI
|
2020-03-01 16:55:58 +08:00
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* [Bot] 中为了让 Java 使用者调用更方便的 API 列表.
|
2020-03-01 18:09:16 +08:00
|
|
|
*/
|
2020-03-01 17:10:55 +08:00
|
|
|
@MiraiInternalAPI
|
2020-03-01 16:55:58 +08:00
|
|
|
@Suppress("FunctionName", "INAPPLICABLE_JVM_NAME", "unused")
|
2020-03-24 16:39:06 +08:00
|
|
|
expect abstract class BotJavaFriendlyAPI() { // 不要使用 interface, 会无法添加默认实现
|
2020-03-01 18:09:16 +08:00
|
|
|
}
|
2020-03-01 16:55:58 +08:00
|
|
|
|
2020-03-01 18:09:16 +08:00
|
|
|
// 保留多平台结构, 以避免在 Android 和 JVM 都定义这个类 ---- 这会造成代码重复.
|
|
|
|
|
// 待 https://youtrack.jetbrains.com/issue/KT-27801 实现后修改为 hierarchical MPP 架构
|
2020-03-01 17:10:55 +08:00
|
|
|
|
2020-03-01 18:09:16 +08:00
|
|
|
// 待 https://youtrack.jetbrains.com/issue/KT-36740 修复后添加 Future 相关 API 到 hierarchical MPP 架构中
|
