reference
获取当前消息内容中有关 消息引用 的消息元素。
reference 在明确不支持或直接通过 messages 寻找获取时,不会发生挂起。 否则当需要通过网络查询结果时会产生挂起。
reference 所得结果不一定是 messages 中的元素。 如上所述,如果需要通过网络查询才能得到结果,则 reference 的结果不会包含在 messages 中。
如果实现者尚未针对性地实现此API,则默认逻辑为: 从 messages 中寻找第一个类型为 MessageReference 的元素。
如果实现者的所属平台不存在、不支持 消息引用 的概念,则可能始终得到
null
。如果实现者的所属平台有明确的 消息引用 概念,但是无法通过 MessageReference 这个类型进行表述, 则使用 reference 时应当抛出信息明确的 UnsupportedOperationException 异常。
Since
4.5.0
Throws
如果实现者的所属平台有明确的 消息引用 概念, 但是无法通过 MessageReference 这个类型进行表述。
可能在获取引用的过程中产生的异常。这通常来自进行挂起查询的过程(如果有的话)。