Class BinaryTagIO


  • public final class BinaryTagIO
    extends Object
    Serialization operations for binary tags.
    Since:
    4.0.0
    • Method Detail

      • 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
      • 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