Class LZFFileInputStream

  • All Implemented Interfaces:
    java.io.Closeable, java.lang.AutoCloseable

    public class LZFFileInputStream
    extends java.io.FileInputStream
    Helper class that allows use of LZF compression even if a library requires use of FileInputStream.

    Note that use of this class is not recommended unless you absolutely must use a FileInputStream instance; otherwise basic LZFInputStream (which uses aggregation for underlying streams) is more appropriate

    Implementation note: much of the code is just copied from LZFInputStream, so care must be taken to keep implementations in sync if there are fixes.

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description
      private class  LZFFileInputStream.Wrapper
      This simple wrapper is needed to re-route read calls so that they will use "raw" reads
    • Field Summary

      Fields 
      Modifier and Type Field Description
      protected int _bufferLength
      Length of the current uncompressed bytes buffer
      protected int _bufferPosition
      The current position (next char to output) in the uncompressed bytes buffer.
      protected boolean _cfgFullReads
      Flag that indicates whether we force full reads (reading of as many bytes as requested), or 'optimal' reads (up to as many as available, but at least one).
      protected byte[] _decodedBytes
      the buffer of uncompressed bytes from which content is read
      protected ChunkDecoder _decompressor
      Underlying decoder in use.
      protected byte[] _inputBuffer
      the current buffer of compressed bytes (from which to decode)
      protected boolean _inputStreamClosed
      Flag that indicates if we have already called 'inputStream.close()' (to avoid calling it multiple times)
      protected BufferRecycler _recycler
      Object that handles details of buffer recycling
      protected LZFFileInputStream.Wrapper _wrapper
      Wrapper object we use to allow decoder to read directly from the stream, without ending in infinite loop...
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      int available()  
      void close()  
      int read()  
      int read​(byte[] b)  
      int read​(byte[] buffer, int offset, int length)  
      int readAndWrite​(java.io.OutputStream out)
      Convenience method that will read and uncompress all data available, and write it using given OutputStream.
      protected int readRaw​(byte[] buffer, int offset, int length)  
      protected boolean readyBuffer()
      Fill the uncompressed bytes buffer by reading the underlying inputStream.
      void setUseFullReads​(boolean b)
      Method that can be used define whether reads should be "full" or "optimal": former means that full compressed blocks are read right away as needed, optimal that only smaller chunks are read at a time, more being read as needed.
      long skip​(long n)
      Overridden to implement efficient skipping by skipping full chunks whenever possible.
      protected long skipRaw​(long amount)  
      • Methods inherited from class java.io.FileInputStream

        finalize, getChannel, getFD
      • Methods inherited from class java.io.InputStream

        mark, markSupported, nullInputStream, readAllBytes, readNBytes, readNBytes, reset, transferTo
      • Methods inherited from class java.lang.Object

        clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • _decompressor

        protected final ChunkDecoder _decompressor
        Underlying decoder in use.
      • _recycler

        protected final BufferRecycler _recycler
        Object that handles details of buffer recycling
      • _inputStreamClosed

        protected boolean _inputStreamClosed
        Flag that indicates if we have already called 'inputStream.close()' (to avoid calling it multiple times)
      • _cfgFullReads

        protected boolean _cfgFullReads
        Flag that indicates whether we force full reads (reading of as many bytes as requested), or 'optimal' reads (up to as many as available, but at least one). Default is false, meaning that 'optimal' read is used.
      • _inputBuffer

        protected byte[] _inputBuffer
        the current buffer of compressed bytes (from which to decode)
      • _decodedBytes

        protected byte[] _decodedBytes
        the buffer of uncompressed bytes from which content is read
      • _bufferPosition

        protected int _bufferPosition
        The current position (next char to output) in the uncompressed bytes buffer.
      • _bufferLength

        protected int _bufferLength
        Length of the current uncompressed bytes buffer
      • _wrapper

        protected final LZFFileInputStream.Wrapper _wrapper
        Wrapper object we use to allow decoder to read directly from the stream, without ending in infinite loop...
    • Constructor Detail

      • LZFFileInputStream

        public LZFFileInputStream​(java.io.File file)
                           throws java.io.FileNotFoundException
        Throws:
        java.io.FileNotFoundException
      • LZFFileInputStream

        public LZFFileInputStream​(java.io.FileDescriptor fdObj)
      • LZFFileInputStream

        public LZFFileInputStream​(java.lang.String name)
                           throws java.io.FileNotFoundException
        Throws:
        java.io.FileNotFoundException
      • LZFFileInputStream

        public LZFFileInputStream​(java.io.File file,
                                  ChunkDecoder decompressor)
                           throws java.io.FileNotFoundException
        Throws:
        java.io.FileNotFoundException
      • LZFFileInputStream

        public LZFFileInputStream​(java.io.FileDescriptor fdObj,
                                  ChunkDecoder decompressor)
      • LZFFileInputStream

        public LZFFileInputStream​(java.lang.String name,
                                  ChunkDecoder decompressor)
                           throws java.io.FileNotFoundException
        Throws:
        java.io.FileNotFoundException
      • LZFFileInputStream

        public LZFFileInputStream​(java.io.File file,
                                  ChunkDecoder decompressor,
                                  BufferRecycler bufferRecycler)
                           throws java.io.FileNotFoundException
        Throws:
        java.io.FileNotFoundException
      • LZFFileInputStream

        public LZFFileInputStream​(java.io.FileDescriptor fdObj,
                                  ChunkDecoder decompressor,
                                  BufferRecycler bufferRecycler)
      • LZFFileInputStream

        public LZFFileInputStream​(java.lang.String name,
                                  ChunkDecoder decompressor,
                                  BufferRecycler bufferRecycler)
                           throws java.io.FileNotFoundException
        Throws:
        java.io.FileNotFoundException
    • Method Detail

      • setUseFullReads

        public void setUseFullReads​(boolean b)
        Method that can be used define whether reads should be "full" or "optimal": former means that full compressed blocks are read right away as needed, optimal that only smaller chunks are read at a time, more being read as needed.
      • available

        public int available()
        Overrides:
        available in class java.io.FileInputStream
      • close

        public void close()
                   throws java.io.IOException
        Specified by:
        close in interface java.lang.AutoCloseable
        Specified by:
        close in interface java.io.Closeable
        Overrides:
        close in class java.io.FileInputStream
        Throws:
        java.io.IOException
      • read

        public int read()
                 throws java.io.IOException
        Overrides:
        read in class java.io.FileInputStream
        Throws:
        java.io.IOException
      • read

        public int read​(byte[] b)
                 throws java.io.IOException
        Overrides:
        read in class java.io.FileInputStream
        Throws:
        java.io.IOException
      • read

        public int read​(byte[] buffer,
                        int offset,
                        int length)
                 throws java.io.IOException
        Overrides:
        read in class java.io.FileInputStream
        Throws:
        java.io.IOException
      • skip

        public long skip​(long n)
                  throws java.io.IOException
        Overridden to implement efficient skipping by skipping full chunks whenever possible.
        Overrides:
        skip in class java.io.FileInputStream
        Throws:
        java.io.IOException
      • readAndWrite

        public int readAndWrite​(java.io.OutputStream out)
                         throws java.io.IOException
        Convenience method that will read and uncompress all data available, and write it using given OutputStream. This avoids having to make an intermediate copy of uncompressed data which would be needed when doing the same manually.
        Parameters:
        out - OutputStream to use for writing content
        Returns:
        Number of bytes written (uncompressed)
        Throws:
        java.io.IOException
      • readyBuffer

        protected boolean readyBuffer()
                               throws java.io.IOException
        Fill the uncompressed bytes buffer by reading the underlying inputStream.
        Throws:
        java.io.IOException
      • readRaw

        protected final int readRaw​(byte[] buffer,
                                    int offset,
                                    int length)
                             throws java.io.IOException
        Throws:
        java.io.IOException
      • skipRaw

        protected final long skipRaw​(long amount)
                              throws java.io.IOException
        Throws:
        java.io.IOException