Deprecate NullMessageChain

This commit is contained in:
Him188 2020-04-05 18:21:29 +08:00
parent 8fe13e0ae7
commit b362c637cd

View File

@ -13,10 +13,9 @@
package net.mamoe.mirai.message.data
import net.mamoe.mirai.message.data.NullMessageChain.equals
import net.mamoe.mirai.message.data.NullMessageChain.toString
import net.mamoe.mirai.utils.MiraiExperimentalAPI
import net.mamoe.mirai.utils.MiraiInternalAPI
import net.mamoe.mirai.utils.PlannedRemoval
import net.mamoe.mirai.utils.SinceMirai
import kotlin.js.JsName
import kotlin.jvm.JvmMultifileClass
@ -25,10 +24,7 @@ import kotlin.jvm.JvmSynthetic
import kotlin.reflect.KProperty
/**
* 消息链.
* 它的一般实现为 [MessageChainImplByCollection] [MessageChainImplBySequence],
* 替代 `null` 情况的实现为 [NullMessageChain],
* 空的实现为 [EmptyMessageChain]
* 消息链. 空的实现为 [EmptyMessageChain]
*
* 要获取更多信息, 请查看 [Message]
*
@ -419,9 +415,9 @@ object EmptyMessageChain : MessageChain, Iterator<SingleMessage> {
/**
* Null [MessageChain].
* 它不包含任何元素, 也没有创建任何 list.
*
* [toString] [equals] , 其他方法均 [error]
*/
@PlannedRemoval("1.0.0")
@Deprecated("ambiguous. use `null` or EmptyMessageChain instead", level = DeprecationLevel.ERROR)
object NullMessageChain : MessageChain {
override fun toString(): String = "NullMessageChain"
override fun contentToString(): String = ""