net.hasor.cobble.io

类 LineIterator

java.lang.Object

net.hasor.cobble.io.LineIterator

所有已实现的接口:

Iterator<String>

public class LineIterator
extends Object
implements Iterator<String>

An Iterator over the lines in a Reader.

LineIterator holds a reference to an open Reader. When you have finished with the iterator you should close the reader to free internal resources. This can be done by closing the reader directly, or by calling the close() or closeQuietly(LineIterator) method on the iterator.

The recommended usage pattern is:

 LineIterator it = FileUtils.lineIterator(file, "UTF-8");
 try {
   while (it.hasNext()) {
     String line = it.nextLine();
     // do something with line
   }
 } finally {
   it.close();
 }
 

2017-09-13 reduction based on Apache Commons IO, org.apache.commons.io.LineIterator

从以下版本开始:

1.2

版本:

$Id: LineIterator.java 1307461 2012-03-30 15:12:29Z ggregory $

作者:

赵永春 (zyc@hasor.net)

构造器概要

构造器

构造器和说明
LineIterator(Reader reader) Constructs an iterator of the lines for a Reader.

方法概要

限定符和类型	方法和说明
void	close() Closes the underlying Reader quietly.
static void	closeQuietly(LineIterator iterator) Closes the iterator, handling null and ignoring exceptions.
boolean	hasNext() Indicates whether the Reader has more lines.
protected boolean	isValidLine(String line) Overridable method to validate each line that is returned.
String	next() Returns the next line in the wrapped Reader.
String	nextLine() Returns the next line in the wrapped Reader.
void	remove() Unsupported.

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

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

从接口继承的方法 java.util.Iterator

forEachRemaining

构造器详细资料

LineIterator

public LineIterator(Reader reader)
             throws IllegalArgumentException

Constructs an iterator of the lines for a Reader.

参数:

reader - the Reader to read from, not null

抛出:

IllegalArgumentException - if the reader is null

方法详细资料

hasNext

public boolean hasNext()

Indicates whether the Reader has more lines. If there is an IOException then close() will be called on this instance.

指定者:

hasNext 在接口中 Iterator<String>

返回:

true if the Reader has more lines

抛出:

IllegalStateException - if an IO exception occurs

isValidLine

protected boolean isValidLine(String line)

Overridable method to validate each line that is returned. This implementation always returns true.

参数:

line - the line that is to be validated

返回:

true if valid, false to remove from the iterator

next

public String next()

Returns the next line in the wrapped Reader.

指定者:

next 在接口中 Iterator<String>

返回:

the next line from the input

抛出:

NoSuchElementException - if there is no line to return

nextLine

public String nextLine()

Returns the next line in the wrapped Reader.

返回:

the next line from the input

抛出:

NoSuchElementException - if there is no line to return

close

public void close()

Closes the underlying Reader quietly. This method is useful if you only want to process the first few lines of a larger file. If you do not close the iterator then the Reader remains open. This method can safely be called multiple times.

remove

public void remove()

Unsupported.

指定者:

remove 在接口中 Iterator<String>

抛出:

UnsupportedOperationException - always

closeQuietly

public static void closeQuietly(LineIterator iterator)

Closes the iterator, handling null and ignoring exceptions.

参数:

iterator - the iterator to close