cn.hutool.core.collection

类 LineIterator

java.lang.Object

cn.hutool.core.collection.LineIterator

所有已实现的接口:

Closeable, AutoCloseable, Iterator<String>

public class LineIterator
extends Object
implements Iterator<String>, Closeable

将Reader包装为一个按照行读取的Iterator
此对象遍历结束后，应关闭之，推荐使用方式:

 LineIterator it = null;
 try {
        it = new LineIterator(reader);
        while (it.hasNext()) {
                String line = it.nextLine();
                // do something with line
        }
 } finally {
                it.close();
 }
 

此类来自于Apache Commons io

从以下版本开始:

4.0.6

作者:

looly

构造器概要

构造器

构造器和说明
LineIterator(InputStream in, Charset charset) 构造
LineIterator(Reader reader) 构造

方法概要

方法

限定符和类型	方法和说明
void	close() 关闭Reader
boolean	hasNext() 判断Reader是否可以存在下一行。
protected boolean	isValidLine(String line) Overridable method to validate each line that is returned.
String	next() 返回下一行内容
String	nextLine() 返回下一行
void	remove() Unsupported.

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

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

构造器详细资料

LineIterator

public LineIterator(InputStream in,
            Charset charset)
             throws IllegalArgumentException

构造

参数:

in - InputStream

charset - 编码

抛出:

IllegalArgumentException - reader为null抛出此异常

LineIterator

public LineIterator(Reader reader)
             throws IllegalArgumentException

构造

参数:

reader - Reader对象，不能为null

抛出:

IllegalArgumentException - reader为null抛出此异常

方法详细资料

hasNext

public boolean hasNext()
                throws IORuntimeException

判断Reader是否可以存在下一行。 If there is an IOException then close() will be called on this instance.

指定者:

hasNext 在接口中 Iterator<String>

返回:

true 表示有更多行

抛出:

IORuntimeException - IO异常

next

public String next()
            throws NoSuchElementException

返回下一行内容

指定者:

next 在接口中 Iterator<String>

返回:

下一行内容

抛出:

NoSuchElementException - 没有新行

nextLine

public String nextLine()
                throws NoSuchElementException

返回下一行

返回:

下一行

抛出:

NoSuchElementException - 没有更多行

close

public void close()

关闭Reader

指定者:

close 在接口中 Closeable

指定者:

close 在接口中 AutoCloseable

remove

public void remove()

Unsupported.

指定者:

remove 在接口中 Iterator<String>

抛出:

UnsupportedOperationException - always

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