字符流
Reader 类
Reader 是抽象类, 定义了 Java 的流字符输入模型. 该类实现了 AutoCloseable, Closeable 以及 Readable 接口. 当发生错误时, 该类中的所有方法都会抛出 IOException 异常.
| 方 法 | 描 述 |
|---|---|
| abstract void close() | 关闭输入源 |
| void mark(int numChars) | 在输入流的当前位置放置标记, 该标记在读入 numChars 个字符之前都一直有效 |
| boolean markSupported() | 如果这个流支持 mark() 或 reset()方法, 就返回 true |
| int read() | 返回一个表示调用输入流中下一个可用字符串的整数. 如果到达文件末尾, 就返回-1 |
| int read(char buffer[]) | 尝试读取 buffer.length 个字符到 buffer中, 并且返回成功读取的实际字符数. 如果到达文件末尾, 则就返回-1 |
| abstract int read(char buffer[], int offset, int numChars) | 尝试读取 numChars 个字符到 buffer 中, 从 buffer[offset] 开始保存读取的字符, 返回成功读取的字符数. 如果到达文件末尾, 就返回-1 |
| boolean ready() | 如果下一个输入请求不等待, 就返回 true, 否则返回 false |
| void reset() | 将输入指针重新设置为前面的标记位置 |
| long skip(long numChars) | 略过 numChars 的输入字符, 返回实际略过的字符数. |
Writer 类
Writer 是定义流字符输出模型的抽象类, 实现了 AutoCloseable, Closeable. Flushable以及 Appendable 接口. 如果发生错误都会抛出 IOException 异常
| 方 法 | 描 述 |
|---|---|
| abstract void close() | 关闭输出源 |
| abstract void flush | 完成输出状态, 从而清空所有缓冲区, 即刷新输出缓冲区 |
| Writer append(char ch) | 将 ch 追加到调用输出流的末尾, 返回对调用流的引用 |
| Writer append(CharSequence chars) | 将 chars 追加到调用输出流的末尾, 返回调用流的引用 |
| Writer append(CharSequence chars, int begin, int end) | 将 chars 中从begin 到 end -1 之间的字符串追加到调用输出流末尾, 返回对调用流的引用 |
| void write(int ch) | 向调用输出流写入单个字符 |
| void write(char buffer[]) | 将整个字符数组写入调用输出流中 |
| void write(String str) | 将 str 写入调用输出流中 |
| void write(String str, int offset, int numChars) | 将字符串 str 中从 offset 开始的 numChars 个字符串写入调用输出流中 |
| abstract void write(char buffer[], int offset, int numChars) | 将 buffer 数组中从 buffer[offset]开始的 numChars 个字符写入调用的输出流中 |
FileReader 类
可以创建用于读取文件内容的 Reader 对象, 该类最常用的两个构造函数入下所示:
FileReader(String filePath)
FileReader(File fileObj)
每个构造函数都会抛出 FileNotFoundException 异常. 其中, filePath 是文件的完整路径名. fileObj 是描述文件的File对象.
FileWriter 类
可以创建能够用于写入文件的 Writer 对象, 该类最常用的4个构造函数如下:
FileWriter(String filePath)
FileWriter(String filePath, boolean append)
FileWriter(File fileObj)
FileWriter(File fileObj, boolean append)
它们都会抛出 IOException 异常, 其中, filePath 是文件的完整路径名, fileObj 是描述文件的 File 对象. 如果 append 为 true, 输出将被追加到文件的末尾.
FileWriter 对象的创建不依赖于已经存在的文件, 当创建对象时, FileWriter 会在打开文件之前为输出创建文件, 对于这种情况, 如果试图打开只读文件, 就会抛出 IOException 异常.
CharArrayReader 类
使用字符数组作为源的一个输出流实现, 该类具有两个构造函数, 每个构造函数都需要一个字符数组来提供数据源:
CharArrayReader(char array[])
CharArrayReader(char array[], int start, int numChars)
其中, array 是输入源. 第二个构造函数根据字符数组的子集创建Reader对象, 该子集从start指定的索引位置的字符串开始, 共 numChars 个字符.
CharArrayWriter 类
使用数组作为目标的一个输出流实现. 两个构造函数:
CharArrayWriter()
CharArrayWriter(int numChars)
在第一种形式中, 创建使用默认大小的缓冲区, 在第二种形式中, 创建由 numChars 指定大小的缓冲区. 缓冲区保存在 CharArrayWriter 类的 buf 域变了中. 如果需要, 缓冲区的大小可以自动增加. 缓冲区能够容纳的字符数量保存在 CharArrayWriter 类的 count 域变量中. buf和count都是保护域变量.
BufferedReader 类
通过缓冲输入提高性能, 两个构造函数:
BufferedReader(Reader inputStream)
BufferedReader(Reader inputStream, int bufSize)
第一种形式使用默认缓冲区大小创建缓冲的字符流. 在第二种形式中, 缓冲区 bufSize 传递的.
关闭 BufferedReader 对象也会导致 inputStream 指定的底层流被关闭
BufferedWriter 类
两个构造函数:
BufferedWriter(Writer outputStream)
BufferedWriter(Writer outputStream, int bufSize)
第一种形式创建的缓冲流使用具有默认大小的缓冲区. 在第二种形式, 缓冲区大小是由 bufSize 传递的.