Class ReversedLinesFileReader

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

    public class ReversedLinesFileReader
    extends java.lang.Object
    implements java.io.Closeable
    Reads lines in a file reversely (similar to a BufferedReader, but starting at the last line). Useful for e.g. searching in log files.
    Since:
    2.2
    • Field Detail

      • blockSize

        private final int blockSize
      • encoding

        private final java.nio.charset.Charset encoding
      • randomAccessFile

        private final java.io.RandomAccessFile randomAccessFile
      • totalByteLength

        private final long totalByteLength
      • totalBlockCount

        private final long totalBlockCount
      • newLineSequences

        private final byte[][] newLineSequences
      • avoidNewlineSplitBufferSize

        private final int avoidNewlineSplitBufferSize
      • byteDecrement

        private final int byteDecrement
      • trailingNewlineOfFileSkipped

        private boolean trailingNewlineOfFileSkipped
    • Constructor Detail

      • ReversedLinesFileReader

        @Deprecated
        public ReversedLinesFileReader​(java.io.File file)
                                throws java.io.IOException
        Deprecated.
        Creates a ReversedLinesFileReader with default block size of 4KB and the platform's default encoding.
        Parameters:
        file - the file to be read
        Throws:
        java.io.IOException - if an I/O error occurs
      • ReversedLinesFileReader

        public ReversedLinesFileReader​(java.io.File file,
                                       java.nio.charset.Charset charset)
                                throws java.io.IOException
        Creates a ReversedLinesFileReader with default block size of 4KB and the specified encoding.
        Parameters:
        file - the file to be read
        charset - the encoding to use
        Throws:
        java.io.IOException - if an I/O error occurs
        Since:
        2.5
      • ReversedLinesFileReader

        public ReversedLinesFileReader​(java.io.File file,
                                       int blockSize,
                                       java.nio.charset.Charset encoding)
                                throws java.io.IOException
        Creates a ReversedLinesFileReader with the given block size and encoding.
        Parameters:
        file - the file to be read
        blockSize - size of the internal buffer (for ideal performance this should match with the block size of the underlying file system).
        encoding - the encoding of the file
        Throws:
        java.io.IOException - if an I/O error occurs
        Since:
        2.3
      • ReversedLinesFileReader

        public ReversedLinesFileReader​(java.io.File file,
                                       int blockSize,
                                       java.lang.String encoding)
                                throws java.io.IOException
        Creates a ReversedLinesFileReader with the given block size and encoding.
        Parameters:
        file - the file to be read
        blockSize - size of the internal buffer (for ideal performance this should match with the block size of the underlying file system).
        encoding - the encoding of the file
        Throws:
        java.io.IOException - if an I/O error occurs
        java.nio.charset.UnsupportedCharsetException - thrown instead of UnsupportedEncodingException in version 2.2 if the encoding is not supported.
    • Method Detail

      • readLine

        public java.lang.String readLine()
                                  throws java.io.IOException
        Returns the lines of the file from bottom to top.
        Returns:
        the next line or null if the start of the file is reached
        Throws:
        java.io.IOException - if an I/O error occurs
      • close

        public void close()
                   throws java.io.IOException
        Closes underlying resources.
        Specified by:
        close in interface java.lang.AutoCloseable
        Specified by:
        close in interface java.io.Closeable
        Throws:
        java.io.IOException - if an I/O error occurs