java.lang.Object
|---java.io.Reader
public abstract class Reader
extends Object
implements Readable, Closeable
用于读取字符流的抽象类。 子类必须实现的唯一方法是 read(char[], int, int) 和 close()。 然而，大多数子类将覆盖此处定义的一些方法，以提供更高的效率、附加功能或两者兼而有之。
Since:
JDK1.1
| 修饰符和类型 | 字段 | 描述 |
|---|---|---|
| protected Object | lock | 用于同步此流上的操作的对象。 |
| 修饰符 | 构造函数 | 描述 |
|---|---|---|
| protected | Reader() | 创建一个新的字符流阅读器，其关键部分将在阅读器本身上同步。 |
| protected | Reader(Object lock) | 创建一个新的字符流阅读器，其关键部分将在给定对象上同步。 |
| 修饰符和类型 | 方法 | 描述 |
|---|---|---|
| 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) | 跳过字符。 |
| 从类 java.lang.Object 继承的方法 |
|---|
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
protected Object lock
用于同步此流上的操作的对象。 为了提高效率，字符流对象可以使用自身以外的对象来保护临界区。 因此，子类应该使用该字段中的对象而不是 this 或同步方法。
protected Reader()
创建一个新的字符流阅读器，其关键部分将在阅读器本身上同步。
protected Reader(Object lock)
创建一个新的字符流阅读器，其关键部分将在给定对象上同步。
参数：
| 参数名称 | 参数描述 |
|---|---|
| lock | 要同步的对象。 |
public int read(CharBuffer target) throws IOException
尝试将字符读入指定的字符缓冲区。 缓冲区按原样用作字符的存储库：所做的唯一更改是 put 操作的结果。 不执行缓冲区的翻转或倒带。
指定者：
读入接口Readable
参数：
| 参数名称 | 参数描述 |
|---|---|
| target | 将字符读入的缓冲区 |
返回:
添加到缓冲区的字符数，如果此字符源位于其末尾，则为 -1
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误 |
| NullPointerException | 如果 target 为空 |
| ReadOnlyBufferException | 如果 target 是只读缓冲区 |
Since:
1.5
public int read() throws IOException
读取单个字符。 此方法将阻塞，直到字符可用、发生 I/O 错误或到达流的末尾。
打算支持有效的单字符输入的子类应覆盖此方法。
返回:
读取的字符，为 0 到 65535 (0x00-0xffff) 范围内的整数，如果已到达流的末尾，则为 -1
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误 |
public int read(char[] cbuf) throws IOException
将字符读入数组。 此方法将阻塞，直到某些输入可用、发生 I/O 错误或到达流的末尾。
参数：
| 参数名称 | 参数描述 |
|---|---|
| cbuf | 目标缓冲区 |
返回:
读取的字符数，如果已到达流的末尾，则为 -1
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误 |
public abstract int read(char[] cbuf, int off, int len) throws IOException
将字符读入数组的一部分。 此方法将阻塞，直到某些输入可用、发生 I/O 错误或到达流的末尾。
参数：
| 参数名称 | 参数描述 |
|---|---|
| cbuf | 目标缓冲区 |
| off | 开始存储字符的偏移量 |
| len | 要读取的最大字符数 |
返回:
读取的字符数，如果已到达流的末尾，则为 -1
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误 |
public long skip(long n) throws IOException
跳过字符。 此方法将阻塞，直到某些字符可用、发生 I/O 错误或到达流的末尾。
参数：
| 参数名称 | 参数描述 |
|---|---|
| n | 要跳过的字符数 |
返回:
实际跳过的字符数
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果 n 为负数。 |
| IOException | 如果发生 I/O 错误 |
public boolean ready() throws IOException
告诉这个流是否准备好被读取。
返回:
如果保证下一个 read() 不会阻塞输入，则为 true，否则为 false。 请注意，返回 false 并不能保证下一次读取将阻塞。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误 |
public boolean markSupported()
告知此流是否支持 mark() 操作。 默认实现总是返回 false。 子类应覆盖此方法。
返回:
当且仅当此流支持标记操作时才为 true。
public void mark(int readAheadLimit) throws IOException
标记流中的当前位置。 对 reset() 的后续调用将尝试将流重新定位到该点。 并非所有字符输入流都支持 mark() 操作。
参数：
| 参数名称 | 参数描述 |
|---|---|
| readAheadLimit | 在保留标记的同时限制可以读取的字符数。 读取这么多字符后，尝试重置流可能会失败。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果流不支持 mark()，或者发生其他一些 I/O 错误 |
public void reset() throws IOException
重置流。 如果流已被标记，则尝试将其重新定位在标记处。 如果流尚未被标记，则尝试以适合特定流的某种方式将其重置，例如将其重新定位到其起点。 并非所有字符输入流都支持 reset() 操作，有些支持 reset() 但不支持 mark()。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果流没有被标记，或者标记已经失效，或者流不支持 reset()，或者发生其他一些 I/O 错误 |
public abstract void close() throws IOException
关闭流并释放与其关联的任何系统资源。 关闭流后，进一步的 read()、ready()、mark()、reset() 或 skip() 调用将引发 IOException。 关闭以前关闭的流没有效果。
指定者：
在接口 AutoCloseable 中关闭
指定者：
在接口Closeable中关闭
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误 |
备案信息： 粤ICP备15087711号-2
Copyright © 2008-2024 啊嘎哇在线工具箱 All Rights.
本站所有资料来源于网络，版权归原作者所有，仅作学习交流使用，如不慎侵犯了您的权利，请联系我们。