Serializatory tekstu
ComponentSerializer-y dostarczają sposób na serializowanie i deserializowanie instancji Component. Istnieją ich cztery formaty:
Niesformatowany string - PlainComponentSerializer
Starsze formatowanie
&
lub§
- LegacyComponentSerializerWęzły konfiguracyjne - ConfigurateComponentSerializer
Minecraft JSON - GsonComponentSerializer
Aby uzyskać pełną dokumentację każdego serializera, zobacz sekcje Text Serializers w dokumentacji Adventure.
Serializowanie tekstu
Aby zserializować obiekt Component
, użyj metody ComponentSerializer#serialize(Component), podając jej Component
jako jedyny argument. Metoda ta zwróci obiekt specyficzny dla danego serializera reprezentujący Component
. Na przykład, ConfigurateComponentSerializer zwróci obiekt ConfigurationNode
.
Deserializowanie do tekstu
Aby zdeserializować String
lub inny zserializowany obiekt do odpowiadającemu mu obiektowi Component
, użyj metody ComponentSerializer#deserialize(R), przekazując zerializowany obiekt jako jedyny argument. Jeśli dane wejściowe będą niepoprawne, zostanie rzucony wyjątek. Alternatywnie, użyj metody ComponentSerializer#deserializeOr(R, Component) aby zdeserializować bez żadnych wyjątków. W przypadku błędu zostanie zwrócony drugi argument.