[二十四]JavaIO之PrintWriter

 

功能简介

 

PrintWriter   向文本输出流打印对象的格式化表示形式

他与PrintStream的逻辑上功能目的是相同的--他们都想做同一件事情--更便捷的格式化打印输出

 

PrintWriter实现了PrintStream 中的所有 print 方法,除了那些用于写入原始字节的方法，对于那些字节，程序应该使用未编码的字节流进行写入

PrintStream会在换行符时自动调用自动刷新

PrintWriter在这一点上与PrintWriter不同,

只有在调用 println、printf 或 format 的其中一个方法时才可能完成此操作

类似,PrintStream   此类中的方法不会抛出 I/O 异常，可以通过 checkError() 检查是否出现错误

 

PrintWriter也是装饰器模式
只不过看起来没那么典型而已
他直接继承Writer   省略了抽象装饰器角色Decorator
PrintWriter 既充当了Decorator也是一个ConcreteDecorator
它内部包含了一个Writer out

 

 

构造方法

 

他内部有一个Writer out ,而且刚才我们已经说了他是装饰器模式

所以他必然会需要一个out,你从构造方法的实际情况也可以看得出来

构造方法主要内容包括下面三部分:

    1. 首先需要一个Writer

    2. 自动刷新的标志

    3. 字符编码的设置

    对于一个Writer

    1. 他要么就是一个直接的Writer

    2. 要么是一个new OutputStreamWriter( OutputStream) 把OutputStream转换为Writer

    3. 另外,通过File或者String路径名,也可以构造FileOutputStream  ,他就是一个OutputStream,也就是下面的形式:

        new OutputStreamWriter( new FileOutputStream(File/String路径) )   

自动刷新,如果不传递,默认false
编码如果不设置,那么是系统默认

 

最根本的构造方法是

最根本的为什么没有字符编码相关的?
其实, 还有一个私有的
私有的构造方法,将带有字符编码情况的进行了二次的包装
在创建 OutputStreamWriter时使用
私有的构造方法还是绕回去到上面说的这个根本的构造方法去了

你会从构造方法中可以看得出来
如果构造方法中指定了编码
将会经由这个私有的构造方法转发下

如果没指定将会使用我们上面说的那个最根本的形式

    public PrintWriter(Writer out,

                       boolean autoFlush) {

不指定编码的 
全部都是使用PrintWriter(Writer out, boolean autoFlush)

带编码的借助于私有构造方法进行请求转发
private PrintWriter(Charset charset, File file)

说了那么多,其实也只还是需要记住下面这一个就好了
PrintWriter(Writer out, boolean autoFlush)
只有File参数或者String路径参数 才会设置编码的参数,
如果设置了编码的参数的话,将会在把他们转换为Writer时, 也就是 new OutputStreamWriter 中通过指定编码参数构造

 

 

Write方法

write方法的本质还是将数据写入到输出流
提供了5个版本的write

void write(char[] buf)

          将字符数组 写入

void write(char[] buf, int off, int len)

          将字符数组的某一部分  写入

void write(int c)

          将单个字符 写入

void write(String s)

          将字符串 写入

void write(String s, int off, int len)

          将字符串的某一部分 写入

 

三个基础方法,两个简化版方法

看得出来,类似PrintStream PrintWriter 也不会抛出IOException异常

可以通过  checkError  方法查看 trouble 的状态 

 

 

print(xxx) /println(xxx)

println()
通过写入行分隔符字符串终止当前行。行分隔符字符串由系统属性 line.separator 定义，不一定是单个换行符 ('\n')

 

print(boolean)		+ println()  = println(boolean)
print(char)		+ println()  = println(char)
print(int)		+ println()  = println(int)
print(long)		+ println()  = println(long)
print(float)		+ println()  = println(float)
print(double)		+ println()  = println(double)
print(char[])		+ println()  = println(char[])
print(String)		+ println()  = println(String)
print(Object)		println(String.valueOf(Object))+ println()  = println(Object) 稍微特殊,先转换为String    String.valueOf(Object) 然后print(String)+ println()

 

可以看得出来  print系列都是调用的write方法
而且,基本上是write(String s)方法
boolean 会翻译成 字符串 true 或者false,然后调用write
String 如果是null 翻译成字符串 null    然后调用write
除了Object略微特殊以外,其他所有的print 和 println结合之后可以产生对应的println(xxx)的形式

 

append

三个版本的append方法

    append(char)

    append(java.lang.CharSequence)

    append(java.lang.CharSequence, int, int)

 

内部全部都是依赖于write方法

 

printf 与 format

PrintWriter内部也有一个Formatter

printf(java.util.Locale, java.lang.String, java.lang.Object...)

printf(java.lang.String, java.lang.Object...)

format(java.util.Locale, java.lang.String, java.lang.Object...)

format(java.lang.String, java.lang.Object...)

printf借助于format
format依赖Formatter

jdk1.8中 format方法与PrintStream 中几乎一样的,几乎一样的,几乎一样的....

 

 

PrintWriter提供了close以及flush方法
如下图所示,依赖于内部out 的 close和flush 也没什么好说的

 

总结

 

PrintWriter 构造方法很多,提供出来的方法也很多,看起来让人眼花缭乱

其实他就是一个装饰工具类,底层逻辑也很简单

既然是工具性质的

1. 自然需要有足够便捷的构造形式,你看那么多构造方法,最终不过也就是一种形式的构造方法

2. 自然有能够有多变的输出形式才能够说是便捷的输出打印嘛

对于Writer家族的一些基本操作,基本上是沿用了Write

 

所谓的增加的便捷亮点各种print和println

也就只是使用Writer本身的write方法打印输出他们的字符 形式

转换为字符的规则为:

基本数据类型和Object 会使用String.valueOf进行转换  

字符 字符数组 String本身就是字符/字符串的形式

 

另外的一个亮点是printf 同PrintStream中的是一样的,想要弄清楚重点在于弄清楚 Formatter了

 

上面说了,他既然是装饰工具流,所以说他必然要依赖于其他的输出流

PrintWriter就是依赖Writer,他就是来给这个Writer增加更便捷的打印输出功能的

既然着重点在于格式化输出数据,那么他的关注点自然在于数据的形式,而不是在于怎么写,所以write方法都几乎不动使用的还是原来的

然后在实际的调用各种print方法的时候,在对方法的入参进行转换,换成了字符的形式而已