文本序列化器(Text Serializer)

ComponentSerializer 提供了一个便利的方式来进行序列化和反序列化 Component 实例,它有三种适用格式:

关于每个序列化器的完整文档,请参阅 Adventure 文档』 文本序列化器 部分。

序列化文本

要序列化一个 Component 对象,只需使用 ComponentSerializer#serialize(Component) 方法,提供唯一的参数。 这个方法将返回一个表示 Component 的序列化特定对象。例如,ConfigurateComponentSerializer 将返回一个 ConfigurationNode 对象。

反序列化文本

如果我们想要反序列化一个 String 到它对应的 Component 对象,我们只需使用 ComponentSerializer#deserialize(String) 方法,并传入一个 String 为唯一的参数。如果输入格式不正确,将抛出一个异常。另外,我们也可以使用 ComponentSerializer#deserializeOr(R, Component) 方法,通过这一方法反序列化不会抛出任何异常。如果有错误,第二个参数将作为备选返回。