副标题#e#
PrintWriter 先容
PrintWriter 是字符范例的打印输出流，它担任于Writer。
PrintStream 用于向文本输出流打印工具的名目化暗示形式。它实此刻 PrintStream 中的所有 print 要领。它不包括用于写入原始字节的要领，对付这些字节，措施应该利用未编码的字节约举办写入。
PrintWriter 函数列表
PrintWriter(OutputStream out)
PrintWriter(OutputStream out, boolean autoFlush)
PrintWriter(Writer wr)
PrintWriter(Writer wr, boolean autoFlush)
PrintWriter(File file)
PrintWriter(File file, String csn)
PrintWriter(String fileName)
PrintWriter(String fileName, String csn)
PrintWriter append(char c)
PrintWriter append(CharSequence csq, int start, int end)
PrintWriter append(CharSequence csq)
boolean checkError()
void close()
void flush()
PrintWriter format(Locale l, String format, Object... args)
PrintWriter format(String format, Object... args)
void print(float fnum)
void print(double dnum)
void print(String str)
void print(Object obj)
void print(char ch)
void print(char[] charArray)
void print(long lnum)
void print(int inum)
void print(boolean bool)
PrintWriter printf(Locale l, String format, Object... args)
PrintWriter printf(String format, Object... args)
void println()
void println(float f)
void println(int i)
void println(long l)
void println(Object obj)
void println(char[] chars)
void println(String str)
void println(char c)
void println(double d)
void println(boolean b)
void write(char[] buf, int offset, int count)
void write(int oneChar)
void write(char[] buf)
void write(String str, int offset, int count)
void write(String str)
#p#副标题#e#
PrintWriter 源码
package java.io;
import java.util.Objects;
import java.util.Formatter;
import java.util.Locale;
import java.nio.charset.Charset;
import java.nio.charset.IllegalCharsetNameException;
import java.nio.charset.UnsupportedCharsetException;
public class PrintWriter extends Writer {
protected Writer out;
// 自动flush
// 所谓“自动flush”，就是每次执行print(), println(), write()函数，城市挪用flush()函数；
// 而“不自动flush”，则需要我们手动挪用flush()接口。
private final boolean autoFlush;
// PrintWriter是否右发生异常。当PrintWriter有异常发生时，会被自己捕捉，并配置trouble为true
private boolean trouble = false;
// 用于名目化的工具
private Formatter formatter;
private PrintStream psOut = null;
// 行支解符
private final String lineSeparator;
// 获取csn(字符集名字)对应的Chaset
private static Charset toCharset(String csn)
throws UnsupportedEncodingException
{
Objects.requireNonNull(csn, "charsetName");
try {
return Charset.forName(csn);
} catch (IllegalCharsetNameException|UnsupportedCharsetException unused) {
// UnsupportedEncodingException should be thrown
throw new UnsupportedEncodingException(csn);
}
}
// 将“Writer工具out”作为PrintWriter的输出流，默认不会自动flush，而且回收默认字符集。
public PrintWriter (Writer out) {
this(out, false);
}
// 将“Writer工具out”作为PrintWriter的输出流，autoFlush的flush模式，而且回收默认字符集。
public PrintWriter(Writer out, boolean autoFlush) {
super(out);
this.out = out;
this.autoFlush = autoFlush;
lineSeparator = java.security.AccessController.doPrivileged(
new sun.security.action.GetPropertyAction("line.separator"));
}
// 将“输出流工具out”作为PrintWriter的输出流，不自动flush，而且回收默认字符集。
public PrintWriter(OutputStream out) {
this(out, false);
}
// 将“输出流工具out”作为PrintWriter的输出流，autoFlush的flush模式，而且回收默认字符集。
public PrintWriter(OutputStream out, boolean autoFlush) {
// new OutputStreamWriter(out)：将“字节范例的输出流”转换为“字符范例的输出流”
// new BufferedWriter(...): 为输出流提供缓冲成果。
this(new BufferedWriter(new OutputStreamWriter(out)), autoFlush);
// save print stream for error propagation
if (out instanceof java.io.PrintStream) {
psOut = (PrintStream) out;
}
}
// 建设fileName对应的OutputStreamWriter，进而建设BufferedWriter工具；然后将该BufferedWriter作为PrintWriter的输出流，不自动flush，回收默认字符集。
public PrintWriter(String fileName) throws FileNotFoundException {
this(new BufferedWriter(new OutputStreamWriter(new FileOutputStream(fileName))),
false);
}
// 建设fileName对应的OutputStreamWriter，进而建设BufferedWriter工具；然后将该BufferedWriter作为PrintWriter的输出流，不自动flush，回收字符集charset。
private PrintWriter(Charset charset, File file)
throws FileNotFoundException
{
this(new BufferedWriter(new OutputStreamWriter(new FileOutputStream(file), charset)),
false);
}
// 建设fileName对应的OutputStreamWriter，进而建设BufferedWriter工具；然后将该BufferedWriter作为PrintWriter的输出流，不自动flush，回收csn字符集。
public PrintWriter(String fileName, String csn)
throws FileNotFoundException, UnsupportedEncodingException
{
this(toCharset(csn), new File(fileName));
}
// 建设file对应的OutputStreamWriter，进而建设BufferedWriter工具；然后将该BufferedWriter作为PrintWriter的输出流，不自动flush，回收默认字符集。
public PrintWriter(File file) throws FileNotFoundException {
this(new BufferedWriter(new OutputStreamWriter(new FileOutputStream(file))),
false);
}
// 建设file对应的OutputStreamWriter，进而建设BufferedWriter工具；然后将该BufferedWriter作为PrintWriter的输出流，不自动flush，回收csn字符集。
public PrintWriter(File file, String csn)
throws FileNotFoundException, UnsupportedEncodingException
{
this(toCharset(csn), file);
}
private void ensureOpen() throws IOException {
if (out == null)
throw new IOException("Stream closed");
}
// flush“PrintWriter输出流中的数据”。
public void flush() {
try {
synchronized (lock) {
ensureOpen();
out.flush();
}
}
catch (IOException x) {
trouble = true;
}
}
public void close() {
try {
synchronized (lock) {
if (out == null)
return;
out.close();
out = null;
}
}
catch (IOException x) {
trouble = true;
}
}
// flush“PrintWriter输出流缓冲中的数据”，并查抄错误
public boolean checkError() {
if (out != null) {
flush();
}
if (out instanceof java.io.PrintWriter) {
PrintWriter pw = (PrintWriter) out;
return pw.checkError();
} else if (psOut != null) {
return psOut.checkError();
}
return trouble;
}
protected void setError() {
trouble = true;
}
protected void clearError() {
trouble = false;
}
// 将字符c写入到“PrintWriter输出流”中。c固然是int范例，但实际只会写入一个字符
public void write(int c) {
try {
synchronized (lock) {
ensureOpen();
out.write(c);
}
}
catch (InterruptedIOException x) {
Thread.currentThread().interrupt();
}
catch (IOException x) {
trouble = true;
}
}
// 将“buf中从off开始的len个字符”写入到“PrintWriter输出流”中。
public void write(char buf[], int off, int len) {
try {
synchronized (lock) {
ensureOpen();
out.write(buf, off, len);
}
}
catch (InterruptedIOException x) {
Thread.currentThread().interrupt();
}
catch (IOException x) {
trouble = true;
}
}
// 将“buf中的全部数据”写入到“PrintWriter输出流”中。
public void write(char buf[]) {
write(buf, 0, buf.length);
}
// 将“字符串s中从off开始的len个字符”写入到“PrintWriter输出流”中。
public void write(String s, int off, int len) {
try {
synchronized (lock) {
ensureOpen();
out.write(s, off, len);
}
}
catch (InterruptedIOException x) {
Thread.currentThread().interrupt();
}
catch (IOException x) {
trouble = true;
}
}
// 将“字符串s”写入到“PrintWriter输出流”中。
public void write(String s) {
write(s, 0, s.length());
}
// 将“换行符”写入到“PrintWriter输出流”中。
private void newLine() {
try {
synchronized (lock) {
ensureOpen();
out.write(lineSeparator);
if (autoFlush)
out.flush();
}
}
catch (InterruptedIOException x) {
Thread.currentThread().interrupt();
}
catch (IOException x) {
trouble = true;
}
}
// 将“boolean数据对应的字符串”写入到“PrintWriter输出流”中，print实际挪用的是write函数
public void print(boolean b) {
write(b ? "true" : "false");
}
// 将“字符c对应的字符串”写入到“PrintWriter输出流”中，print实际挪用的是write函数
public void print(char c) {
write(c);
}
// 将“int数据i对应的字符串”写入到“PrintWriter输出流”中，print实际挪用的是write函数
public void print(int i) {
write(String.valueOf(i));
}
// 将“long型数据l对应的字符串”写入到“PrintWriter输出流”中，print实际挪用的是write函数
public void print(long l) {
write(String.valueOf(l));
}
// 将“float数据f对应的字符串”写入到“PrintWriter输出流”中，print实际挪用的是write函数
public void print(float f) {
write(String.valueOf(f));
}
// 将“double数据d对应的字符串”写入到“PrintWriter输出流”中，print实际挪用的是write函数
public void print(double d) {
write(String.valueOf(d));
}
// 将“字符数组s”写入到“PrintWriter输出流”中，print实际挪用的是write函数
public void print(char s[]) {
write(s);
}
// 将“字符串数据s”写入到“PrintWriter输出流”中，print实际挪用的是write函数
public void print(String s) {
if (s == null) {
s = "null";
}
write(s);
}
// 将“工具obj对应的字符串”写入到“PrintWriter输出流”中，print实际挪用的是write函数
public void print(Object obj) {
write(String.valueOf(obj));
}
// 将“换行符”写入到“PrintWriter输出流”中，println实际挪用的是write函数
public void println() {
newLine();
}
// 将“boolean数据对应的字符串+换行符”写入到“PrintWriter输出流”中，println实际挪用的是write函数
public void println(boolean x) {
synchronized (lock) {
print(x);
println();
}
}
// 将“字符x对应的字符串+换行符”写入到“PrintWriter输出流”中，println实际挪用的是write函数
public void println(char x) {
synchronized (lock) {
print(x);
println();
}
}
// 将“int数据对应的字符串+换行符”写入到“PrintWriter输出流”中，println实际挪用的是write函数
public void println(int x) {
synchronized (lock) {
print(x);
println();
}
}
// 将“long数据对应的字符串+换行符”写入到“PrintWriter输出流”中，println实际挪用的是write函数
public void println(long x) {
synchronized (lock) {
print(x);
println();
}
}
// 将“float数据对应的字符串+换行符”写入到“PrintWriter输出流”中，println实际挪用的是write函数
public void println(float x) {
synchronized (lock) {
print(x);
println();
}
}
// 将“double数据对应的字符串+换行符”写入到“PrintWriter输出流”中，println实际挪用的是write函数
// 查察本栏目
示例代码
#p#分页标题#e#关于PrintWriter中API的具体用法，参考示例代码(PrintWriterTest.java)：
import java.io.PrintWriter;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
/**
* PrintWriter 的示例措施
*
* @author skywang
*/
public class PrintWriterTest {
public static void main(String[] args) {
// 下面3个函数的浸染都是一样：都是将字母“abcde”写入到文件“file.txt”中。
// 任选一个执行即可！
testPrintWriterConstrutor1() ;
//testPrintWriterConstrutor2() ;
//testPrintWriterConstrutor3() ;
// 测试write(), print(), println(), printf()等接口。
testPrintWriterAPIS() ;
}
/**
* PrintWriter(OutputStream out) 的测试函数
*
* 函数的浸染，就是将字母“abcde”写入到文件“file.txt”中
*/
private static void testPrintWriterConstrutor1() {
final char[] arr={'a', 'b', 'c', 'd', 'e' };
try {
// 建设文件“file.txt”的File工具
File file = new File("file.txt");
// 建设文件对应FileOutputStream
PrintWriter out = new PrintWriter(
new FileOutputStream(file));
// 将“字节数组arr”全部写入到输出流中
out.write(arr);
// 封锁输出流
out.close();
} catch (IOException e) {
e.printStackTrace();
}
}
/**
* PrintWriter(File file) 的测试函数
*
* 函数的浸染，就是将字母“abcde”写入到文件“file.txt”中
*/
private static void testPrintWriterConstrutor2() {
final char[] arr={'a', 'b', 'c', 'd', 'e' };
try {
File file = new File("file.txt");
PrintWriter out = new PrintWriter(file);
out.write(arr);
out.close();
} catch (IOException e) {
e.printStackTrace();
}
}
/**
* PrintWriter(String fileName) 的测试函数
*
* 函数的浸染，就是将字母“abcde”写入到文件“file.txt”中
*/
private static void testPrintWriterConstrutor3() {
final char[] arr={'a', 'b', 'c', 'd', 'e' };
try {
PrintWriter out = new PrintWriter("file.txt");
out.write(arr);
out.close();
} catch (IOException e) {
e.printStackTrace();
}
}
/**
* 测试write(), print(), println(), printf()等接口。
*/
private static void testPrintWriterAPIS() {
final char[] arr={'a', 'b', 'c', 'd', 'e' };
try {
// 建设文件对应FileOutputStream
PrintWriter out = new PrintWriter("other.txt");
// 将字符串“hello PrintWriter”+回车符，写入到输出流中
out.println("hello PrintWriter");
// 将0x41写入到输出流中
// 0x41对应ASCII码的字母'A'，也就是写入字符'A'
out.write(0x41);
// 将字符串"65"写入到输出流中。
// out.print(0x41); 等价于 out.write(String.valueOf(0x41));
out.print(0x41);
// 将字符'B'追加到输出流中
out.append('B').append("CDEF");
// 将"CDE is 5" + 回车 写入到输出流中
String str = "GHI";
int num = 5;
out.printf("%s is %d\n", str, num);
out.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
运行上面的代码，会在源码地址目次生成两个文件“file.txt”和“other.txt”。
file.txt的内容如下：
abcde
other.txt的内容如下：
hello PrintWriter
A65BCDEFGHI is 5
来历：http://www.cnblogs.com/skywang12345/p/io_25.html
