compact1, compact2, compact3

java.io

Class Reader

java.lang.Object

java.io.Reader

All Implemented Interfaces:

Closeable， AutoCloseable， Readable

已知直接子类：

BufferedReader， CharArrayReader， FilterReader， InputStreamReader， PipedReader， StringReader

public abstract class Reader
extends Object
implements Readable, Closeable

读取字符流的抽象类。这一类必须实现的唯一方法是读（char []，int，int）和（）。大多数子类，但是，将重写这里定义的一些方法，以提供更高的效率，额外的功能，或两者都有。

从以下版本开始：

JDK1.1

另请参见：

BufferedReader， LineNumberReader， CharArrayReader， InputStreamReader， FileReader， FilterReader， PushbackReader， PipedReader， StringReader， Writer

Field Summary

Fields

Modifier and Type	Field and Description
protected Object	lock 用于在该流上同步操作的对象。

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	Reader() 创建一个新的字符流阅读器，其关键部分将同步在阅读器本身上。
protected	Reader(Object lock) 创建一个新的字符流阅读器，其关键部分将在给定的对象上同步。

方法摘要

Modifier and Type	Method and Description
abstract void	close() 关闭流并释放与它相关联的任何系统资源。
void	mark(int readAheadLimit) 标记流中的当前位置。
boolean	markSupported() 告诉这是否流支持的mark()操作。
int	read() 读取单个字符。
int	read(char[] cbuf) 将字符读入一个数组。
abstract int	read(char[] cbuf, int off, int len) 将字符读入一个数组的一部分。
int	read(CharBuffer target) 试图将字符读入指定的字符缓冲区中。
boolean	ready() 告诉是否该流已准备好阅读。
void	reset() 重置流。
long	skip(long n) 跳过的字符。

Methods inherited from class java.lang.Object

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

Field Detail

lock

protected Object lock

用于在该流上同步操作的对象。为了效率，一个字符流对象可以使用一个对象以外的其他来保护关键部分。子类必须使用对象在这场而不是 this或同步方法。

Constructor Detail

Reader

protected Reader()

创建一个新的字符流阅读器，其关键部分将同步在阅读器本身上。

Reader

protected Reader(Object lock)

创建一个新的字符流阅读器，其关键部分将在给定的对象上同步。

参数

lock -同步对象。

方法详细信息

read

public int read(CharBuffer target)
         throws IOException

试图将字符读入指定的字符缓冲区中。该缓冲区被用作一个字符库，是：唯一的变化是一个投入运行的结果。没有翻转或缓冲卷进行。

Specified by:

read 接口 Readable

参数

target -缓冲区中读取字符

结果

添加到缓冲区的字符数，或-如果此字符源的结束，则为1

异常

IOException如果I/O错误发生

NullPointerException -如果目标是空的

ReadOnlyBufferException -如果目标是一个只读缓冲区

从以下版本开始：

一点五

read

public int read()
         throws IOException

读取单个字符。此方法将阻塞，直到一个字符可用，一个I / O错误发生，或流的结束达到。

打算支持高效的单字符输入的子类应重写此方法。

结果

个性阅读，如在范围0到65535的整数（ 0x00-0xffff），或1如果已到达流的末尾

异常

IOException如果I/O错误发生

read

public int read(char[] cbuf)
         throws IOException

将字符读入一个数组。这种方法将阻塞，直到有一个输入可用，一个I / O错误发生，或流的结束达到。

参数

cbuf -目的缓冲区

结果

读取的字符数，或-如果流的结束已达到- 1

异常

IOException如果I/O错误发生

read

public abstract int read(char[] cbuf,
                         int off,
                         int len)
                  throws IOException

将字符读入一个数组的一部分。这种方法将阻塞，直到有一个输入可用，一个I / O错误发生，或流的结束达到。

参数

cbuf -目的缓冲区

off偏移，开始存储字符

len -最大字符数读

结果

读取的字符数，或-如果流的结束已达到- 1

异常

IOException如果I/O错误发生

skip

public long skip(long n)
          throws IOException

跳过的字符。这种方法将阻塞，直到一些字符可用，发生I / O错误，或到达流的结束。

参数

n -字符数跳过

结果

实际上跳过的字符数

异常

IllegalArgumentException -如果 n是负的。

IOException如果I/O错误发生

ready

public boolean ready()
              throws IOException

告诉是否该流已准备好阅读。

结果

如果下一read()保证不阻塞输入真，否则为假。请注意，返回错误不保证下一次读将块。

异常

IOException如果I/O错误发生

markSupported

public boolean markSupported()

告诉这是否流支持的mark()操作。默认实现总是返回错误。子类应重写此方法。

结果

如果和只有这条流支持标记操作，则是真的。

mark

public void mark(int readAheadLimit)
          throws IOException

标记流中的当前位置。随后调用reset()将试图重新定位流这一点。不是所有的字符输入流的支持mark()操作。

参数

readAheadLimit的字符数限制，可同时仍保留了马克读。读了这许多字符后，试图重置流可能会失败。

异常

IOException如果流不支持mark()，或者其他一些发生I/O错误

reset

public void reset()
           throws IOException

重置流。如果流已被标记，然后尝试重新定位它在标记。如果流没有被标记，然后尝试以适当的方式重新设置它以适当的特定的流，例如通过重新定位到它的出发点。不是所有的字符输入流的支持reset()操作，和一些支持不支持mark() reset()。

异常

IOException如果流不被标记，或者如果该商标已失效，或如果流不支持reset()，或者其他一些发生I/O错误

close

public abstract void close()
                    throws IOException

关闭流并释放与它相关联的任何系统资源。一旦流已经关闭，进一步read()，ready()，mark()，reset()，或skip()调用会抛出IOException。关闭先前关闭的流没有影响。

Specified by:

close 接口 Closeable

Specified by:

close 接口 AutoCloseable

异常

IOException如果I/O错误发生