cc.fussen.cache.disklrucache

类 StrictLineReader

java.lang.Object

cc.fussen.cache.disklrucache.StrictLineReader

所有已实现的接口:

java.io.Closeable, java.lang.AutoCloseable

public class StrictLineReader
extends java.lang.Object
implements java.io.Closeable

Buffers input from an InputStream for reading lines.

This class is used for buffered reading of lines. For purposes of this class, a line ends with "\n" or "\r\n". End of input is reported by throwing EOFException. Unterminated line at end of input is invalid and will be ignored, the caller may use hasUnterminatedLine() to detect it after catching the EOFException.

This class is intended for reading input that strictly consists of lines, such as line-based cache entries or cache journal. Unlike the BufferedReader which in conjunction with InputStreamReader provides similar functionality, this class uses different end-of-input reporting and a more restrictive definition of a line.

This class supports only charsets that encode '\r' and '\n' as a single byte with value 13 and 10, respectively, and the representation of no other character contains these values. We currently check in constructor that the charset is one of US-ASCII, UTF-8 and ISO-8859-1. The default charset is US_ASCII.

构造器概要

构造器

构造器和说明
StrictLineReader(java.io.InputStream in, java.nio.charset.Charset charset) Constructs a new LineReader with the specified charset and the default capacity.
StrictLineReader(java.io.InputStream in, int capacity, java.nio.charset.Charset charset) Constructs a new LineReader with the specified capacity and charset.

方法概要

限定符和类型	方法和说明
void	close() Closes the reader by closing the underlying InputStream and marking this reader as closed.
boolean	hasUnterminatedLine()
java.lang.String	readLine() Reads the next line.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

StrictLineReader

public StrictLineReader(java.io.InputStream in,
                        java.nio.charset.Charset charset)

Constructs a new LineReader with the specified charset and the default capacity.

参数:

in - the InputStream to read data from.

charset - the charset used to decode data. Only US-ASCII, UTF-8 and ISO-8859-1 are supported.

抛出:

java.lang.NullPointerException - if in or charset is null.

java.lang.IllegalArgumentException - if the specified charset is not supported.

StrictLineReader

public StrictLineReader(java.io.InputStream in,
                        int capacity,
                        java.nio.charset.Charset charset)

Constructs a new LineReader with the specified capacity and charset.

参数:

in - the InputStream to read data from.

capacity - the capacity of the buffer.

charset - the charset used to decode data. Only US-ASCII, UTF-8 and ISO-8859-1 are supported.

抛出:

java.lang.NullPointerException - if in or charset is null.

java.lang.IllegalArgumentException - if capacity is negative or zero or the specified charset is not supported.

方法详细资料

close

public void close()
           throws java.io.IOException

Closes the reader by closing the underlying InputStream and marking this reader as closed.

指定者:

close 在接口中 java.io.Closeable

指定者:

close 在接口中 java.lang.AutoCloseable

抛出:

java.io.IOException - for errors when closing the underlying InputStream.

readLine

public java.lang.String readLine()
                          throws java.io.IOException

Reads the next line. A line ends with "\n" or "\r\n", this end of line marker is not included in the result.

返回:

the next line from the input.

抛出:

java.io.IOException - for underlying InputStream errors.

java.io.EOFException - for the end of source stream.

hasUnterminatedLine

public boolean hasUnterminatedLine()