工作中用到了字符流,所以去看了下JDK学习,分享一下学习笔记!
源码分析
这里附上我经常查看的源码JDK8的链接,供各位客官参考。
Writer类的前世今生
包名:java.io
类名: Writer
继承类:java.lang.Object
实现的接口:Closeable, Flushable, Appendable, AutoCloseable
直接子类:BufferedWriter, CharArrayWriter, FilterWriter, OutputStreamWriter, PipedWriter, PrintWriter, StringWriter
filed域
用于同步此流上的操作的对象。
protected Object lock
构造函数
类型 | 方法名 | 描述 |
---|---|---|
protected | Write() | 创建一个新的字符流编写器,其关键部分将在编写器本身上同步。 |
protected | Write(Object lock) | 创建一个新的字符流编写器,其关键部分将在给定对象上同步。 |
构造函数细节
protected Writer()
描述:
创建一个新的字符流编写器,其关键部分将在阅读器本身上同步。
protected Writer(Object lock)
描述:
创建一个新的字符流编写器,其关键部分将在给定对象上同步。
方法分析
返回类型 | 方法名 | 描述 |
---|---|---|
Writer | apend(char c) | 将指定的字符追加到此writer。 |
Writer | append(CharSequence csq) | 将指定的字符序列追加到此writer。 |
Writer | append(CharSequence csq, int start, int end) | 将指定字符序列的子序列追加到此writer。 |
abstract void | close() | 关闭流,先flush。 |
abstract void | flush() | 刷新流 |
void | write(char[] cbuf) | 写一个字符数组。 |
abstract void | write(char[] cbuf, int off, int len) | 写一个字符数组的一部分。 |
void | write(int c) | 写一个字符。 |
void | write(String str) | 写一个字符串。 |
void | write(String str, int off, int len) | 写一个字符串的一部分。 |
方法使用细节
public void write(int c)
描述:
写一个字符。 要写入的字符包含在给定整数值的16个低位中; 16个高位被忽略。
打算支持高效单字符输出的子类应该重写此方法。
public void write(char[] cbuf)
描述:
写一个字符数组。
public abstract void write(char[] cbuf,int off, int len)
描述:
写一个字符数组的一部分。
参数:
cbuf - 字符数组
off - 开始写字符的偏移量
len - 要写入的字符数
public void write(String str)
描述:
写一个字符串。
public void write(String str, int off,int len)
描述:
写一个字符串的一部分。
参数:
str - 一个字符串
off - 开始写字符的偏移量
len - 要写入的字符数
public Writer append(CharSequence csq)
描述:
将指定的字符序列追加到此writer。
调用out.append(csq)形式的此方法的行为与调用的方式完全相同
out.write(csq.toString())
根据字符序列csq的toString规范,可能不会附加整个序列。 例如,调用字符缓冲区的toString方法将返回一个子序列,其内容取决于缓冲区的位置和限制。
参数:
csq - 要追加的字符序列。 如果csq为null,则将四个字符“null”附加到此writer。
public Writer append(CharSequence csq, int start,int end)
描述:
将指定字符序列的子序列追加到此writer。
当csq不为null时,调用out.append(csq,start,end)形式的此方法的行为与调用的方式完全相同
out.write(csq.subSequence(start,end).toString())
参数:
csq - 将附加子序列的字符序列。 如果csq为null,则将附加字符,就好像csq包含四个字符“null”一样。
start - 子序列中第一个字符的索引
end - 子序列中最后一个字符后面的字符的索引
public Writer append(char c)
描述:
将指定的字符追加到此writer。
调用out.append(c)形式的此方法的行为与调用的方式完全相同
out.write(c)
public abstract void flush()
描述:
一次flush()调用将刷新Writers和OutputStreams链中的所有缓冲区。
如果该流的预期目的地是由底层操作系统提供的抽象,例如文件,则刷新流仅保证先前写入流的字节被传递到操作系统以进行写入; 它不能保证它们实际上写入物理设备,如磁盘驱动器。
public abstract void close()
描述:
关闭流,先flush它。 关闭流后,进一步的write()或flush()调用将导致抛出IOException。 关闭先前关闭的流无效。