JDK阅读之Writer类

JDK阅读之Writer类

工作中用到了字符流，所以去看了下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。 关闭先前关闭的流无效。