java io學習（二十三） BufferedWriter(字符緩沖輸出流)

BufferedWriter 介紹

BufferedWriter 是緩沖字符輸出流。它繼承於Writer。

BufferedWriter 的作用是為其他字符輸出流添加一些緩沖功能。

BufferedWriter 函數列表

// 構造函數
BufferedWriter(Writer out) 
BufferedWriter(Writer out, int sz) 
      
void    close()                              // 關閉此流，但要先刷新它。
void    flush()                              // 刷新該流的緩沖。
void    newLine()                            // 寫入一個行分隔符。
void    write(char[] cbuf, int off, int len) // 寫入字符數組的某一部分。
void    write(int c)                         // 寫入單個字符。
void    write(String s, int off, int len)    // 寫入字符串的某一部分。

BufferedWriter 源碼分析(基於jdk1.7.40)

package java.io;
     
public class BufferedWriter extends Writer {
     
    // 輸出流對象
    private Writer out;
     
    // 保存“緩沖輸出流”數據的字符數組
    private char cb[];
     
    // nChars 是cb緩沖區中字符的總的個數
    // nextChar 是下一個要讀取的字符在cb緩沖區中的位置
    private int nChars, nextChar;
     
    // 默認字符緩沖區大小
    private static int defaultCharBufferSize = 8192;
     
    // 行分割符
    private String lineSeparator;
     
    // 構造函數，傳入“Writer對象”，默認緩沖區大小是8k
    public BufferedWriter(Writer out) {
        this(out, defaultCharBufferSize);
    }
     
    // 構造函數，傳入“Writer對象”，指定緩沖區大小是sz
    public BufferedWriter(Writer out, int sz) {
        super(out);
        if (sz <= 0)
            throw new IllegalArgumentException("Buffer size <= 0");
        this.out = out;
        cb = new char[sz];
        nChars = sz;
        nextChar = 0;
     
        lineSeparator = java.security.AccessController.doPrivileged(
            new sun.security.action.GetPropertyAction("line.separator"));
    }
     
    // 確保“BufferedWriter”是打開狀態
    private void ensureOpen() throws IOException {
        if (out == null)
            throw new IOException("Stream closed");
    }
     
    // 對緩沖區執行flush()操作，將緩沖區的數據寫入到Writer中
    void flushBuffer() throws IOException {
        synchronized (lock) {
            ensureOpen();
            if (nextChar == 0)
                return;
            out.write(cb, 0, nextChar);
            nextChar = 0;
        }
    }
     
    // 將c寫入到緩沖區中。先將c轉換為char，然後將其寫入到緩沖區。
    public void write(int c) throws IOException {
        synchronized (lock) {
            ensureOpen();
            // 若緩沖區滿了，則清空緩沖，將緩沖數據寫入到輸出流中。
            if (nextChar >= nChars)
                flushBuffer();
            cb[nextChar++] = (char) c;
        }
    }
     
    // 返回a，b中較小的數
    private int min(int a, int b) {
        if (a < b) return a;
        return b;
    }
     
    // 將字符數組cbuf寫入到緩沖中，從cbuf的off位置開始寫入，寫入長度是len。
	// 查看本欄目

		
 
			
		
		

示例代碼
關於BufferedWriter中API的詳細用法，參考示例代碼(BufferedWriterTest.java)：
import java.io.BufferedWriter;
import java.io.File;
import java.io.OutputStream;
import java.io.FileWriter;
import java.io.IOException;
import java.io.FileNotFoundException;
import java.lang.SecurityException;
import java.util.Scanner;
     
/**
 * BufferedWriter 測試程序
 *
 * @author skywang
 */
public class BufferedWriterTest {
     
    private static final int LEN = 5;
    // 對應英文字母“abcdefghijklmnopqrstuvwxyz”
    //private static final char[] ArrayLetters = "abcdefghijklmnopqrstuvwxyz";
    private static final char[] ArrayLetters = new char[] {'a','b','c','d','e','f','g','h','i','j','k','l','m','n','o','p','q','r','s','t','u','v','w','x','y','z'};
     
    public static void main(String[] args) {
        testBufferedWriter() ;
    }
     
    /**
     * BufferedWriter的API測試函數
     */
    private static void testBufferedWriter() {
     
        // 創建“文件輸出流”對應的BufferedWriter
        // 它對應緩沖區的大小是16，即緩沖區的數據>=16時，會自動將緩沖區的內容寫入到輸出流。
        try {
            File file = new File("bufferwriter.txt");
            BufferedWriter out =
                  new BufferedWriter(
                      new FileWriter(file));
     
            // 將ArrayLetters數組的前10個字符寫入到輸出流中
            out.write(ArrayLetters, 0, 10);
            // 將“換行符\n”寫入到輸出流中
            out.write('\n');
     
            out.flush();
            //readUserInput() ;
     
            out.close();
       } catch (FileNotFoundException e) {
           e.printStackTrace();
       } catch (SecurityException e) {
           e.printStackTrace();
       } catch (IOException e) {
           e.printStackTrace();
       }
    }
     
    /**
     * 讀取用戶輸入
     */
    private static void readUserInput() {
        System.out.println("please input a text:");
        Scanner reader=new Scanner(System.in);
        // 等待一個輸入
        String str = reader.next();
        System.out.printf("the input is : %s\n", str);
    }
}
運行結果：
生成文件“bufferwriter.txt”，文件的內容是“abcdefghij”。
來源：http://www.cnblogs.com/skywang12345/p/io_24.html