Package net.kyori.adventure.nbt

Class BinaryTagIO

java.lang.Object
net.kyori.adventure.nbt.BinaryTagIO
public final class BinaryTagIO
extends Object
Serialization operations for binary tags.
Since:
4.0.0

  • Method Details

    • unlimitedReader

      public static @NonNull BinaryTagIO.Reader unlimitedReader()
      Returns BinaryTagIO.Reader, used to read binary tags.

      There is a maximum depth of 512 nested tags allowed, but no limit for the amount of containe data.

      Returns:
      binary tag reader
      Since:
      4.4.0

    • reader

      public static @NonNull BinaryTagIO.Reader reader()
      Returns BinaryTagIO.Reader, used to read binary tags.

      This reader has a size limit for the estimated number of data bytes for a tag.

      Returns:
      binary tag reader
      Since:
      4.4.0

    • reader

      public static @NonNull BinaryTagIO.Reader reader​(long sizeLimitBytes)
      Returns BinaryTagIO.Reader, used to read binary tags.

      This reader will limit the number of bytes read to the approximate size limit indicated.

      Returns:
      binary tag reader
      Since:
      4.4.0

    • writer

      public static @NonNull BinaryTagIO.Writer writer()
      Returns BinaryTagIO.Writer, used to write binary tags.
      Returns:
      binary tag writer
      Since:
      4.4.0

    • readPath

      @Deprecated public static @NonNull CompoundBinaryTag readPath​(@NonNull Path path) throws IOException
      Deprecated.
      since 4.4.0, use reader()
      Reads a compound tag from path.
      Parameters:
      path - the path
      Returns:
      the compound tag
      Throws:
      IOException - if an exception was encountered while reading a compound tag
      Since:
      4.0.0

    • readInputStream

      @Deprecated public static @NonNull CompoundBinaryTag readInputStream​(@NonNull InputStream input) throws IOException
      Deprecated.
      since 4.4.0, use reader()
      Reads a compound tag from an input stream. The stream is not closed afterwards.
      Parameters:
      input - the input stream
      Returns:
      the compound tag
      Throws:
      IOException - if an exception was encountered while reading a compound tag
      Since:
      4.0.0

    • readCompressedPath

      @Deprecated public static @NonNull CompoundBinaryTag readCompressedPath​(@NonNull Path path) throws IOException
      Deprecated.
      since 4.4.0, use reader()
      Reads a compound tag from path using GZIP decompression.
      Parameters:
      path - the path
      Returns:
      the compound tag
      Throws:
      IOException - if an exception was encountered while reading a compound tag
      Since:
      4.0.0

    • readCompressedInputStream

      @Deprecated public static @NonNull CompoundBinaryTag readCompressedInputStream​(@NonNull InputStream input) throws IOException
      Deprecated.
      since 4.4.0, use reader()
      Reads a compound tag from an input stream using GZIP decompression. The stream is not closed afterwards.
      Parameters:
      input - the input stream
      Returns:
      the compound tag
      Throws:
      IOException - if an exception was encountered while reading a compound tag
      Since:
      4.0.0

    • readDataInput

      @Deprecated public static @NonNull CompoundBinaryTag readDataInput​(@NonNull DataInput input) throws IOException
      Deprecated.
      since 4.4.0, use reader()
      Reads a compound tag from input.
      Parameters:
      input - the input
      Returns:
      the compound tag
      Throws:
      IOException - if an exception was encountered while reading a compound tag
      Since:
      4.0.0

    • writePath

      @Deprecated public static void writePath​(@NonNull CompoundBinaryTag tag, @NonNull Path path) throws IOException
      Deprecated.
      since 4.4.0, use writer()
      Writes a compound tag to path.
      Parameters:
      tag - the compound tag
      path - the path
      Throws:
      IOException - if an exception was encountered while writing the compound tag
      Since:
      4.0.0

    • writeOutputStream

      @Deprecated public static void writeOutputStream​(@NonNull CompoundBinaryTag tag, @NonNull OutputStream output) throws IOException
      Deprecated.
      since 4.4.0, use writer()
      Writes a compound tag to an output stream. The output stream will not be closed.
      Parameters:
      tag - the compound tag
      output - the output stream
      Throws:
      IOException - if an exception was encountered while writing the compound tag
      Since:
      4.0.0

    • writeCompressedPath

      @Deprecated public static void writeCompressedPath​(@NonNull CompoundBinaryTag tag, @NonNull Path path) throws IOException
      Deprecated.
      since 4.4.0, use writer()
      Writes a compound tag to path using GZIP compression.
      Parameters:
      tag - the compound tag
      path - the path
      Throws:
      IOException - if an exception was encountered while writing the compound tag
      Since:
      4.0.0

    • writeCompressedOutputStream

      @Deprecated public static void writeCompressedOutputStream​(@NonNull CompoundBinaryTag tag, @NonNull OutputStream output) throws IOException
      Deprecated.
      since 4.4.0, use writer()
      Writes a compound tag to an output stream using GZIP compression. The output stream is not closed afterwards.
      Parameters:
      tag - the compound tag
      output - the output stream
      Throws:
      IOException - if an exception was encountered while writing the compound tag
      Since:
      4.0.0

    • writeDataOutput

      @Deprecated public static void writeDataOutput​(@NonNull CompoundBinaryTag tag, @NonNull DataOutput output) throws IOException
      Deprecated.
      since 4.4.0, use writer()
      Writes a compound tag to output.
      Parameters:
      tag - the compound tag
      output - the output
      Throws:
      IOException - if an exception was encountered while writing the compound tag
      Since:
      4.0.0