文本序列化器(Text Serializer)
ComponentSerializer 提供了一个便利的方式来进行序列化和反序列化 Component 实例,它有三种适用格式:
无格式字符串 - PlainComponentSerializer
旧的
&
或§
格式 - LegacyComponentSerializerMinecraft JSON - GsonComponentSerializer
关于每个序列化器的完整文档,请参阅 Adventure 文档』 文本序列化器 部分。
序列化文本
要序列化一个 Component
对象,只需使用 ComponentSerializer#serialize(Component) 方法,提供唯一的参数。 这个方法将返回一个表示 Component
的序列化特定对象。例如,ConfigurateComponentSerializer 将返回一个 ConfigurationNode
对象。
反序列化文本
如果我们想要反序列化一个 String
到它对应的 Component
对象,我们只需使用 ComponentSerializer#deserialize(String) 方法,并传入一个 String
为唯一的参数。如果输入格式不正确,将抛出一个异常。另外,我们也可以使用 ComponentSerializer#deserializeOr(R, Component) 方法,通过这一方法反序列化不会抛出任何异常。如果有错误,第二个参数将作为备选返回。