程式師世界 >> 編程語言 >> JAVA編程 >> 關於JAVA >> java io學習（十二） BufferedOutputStream的認知、源碼和示例

java io學習（十二） BufferedOutputStream的認知、源碼和示例

編輯：關於JAVA

BufferedOutputStream(緩沖輸出流)的認知、源碼和示例

本章內容包括3個部分：BufferedOutputStream介紹，BufferedOutputStream源碼，以及BufferedOutputStream使用示例。

BufferedOutputStream 介紹

BufferedOutputStream 是緩沖輸出流。它繼承於FilterOutputStream。

BufferedOutputStream 的作用是為另一個輸出流提供“緩沖功能”。

BufferedOutputStream 函數列表

BufferedOutputStream(OutputStream out)
BufferedOutputStream(OutputStream out, int size)
     
synchronized void     close()
synchronized void     flush()
synchronized void     write(byte[] buffer, int offset, int length)
synchronized void     write(int oneByte)

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

package java.io;
     
public class BufferedOutputStream extends FilterOutputStream {
    // 保存“緩沖輸出流”數據的字節數組
    protected byte buf[];
     
    // 緩沖中數據的大小
    protected int count;
     
    // 構造函數：新建字節數組大小為8192的“緩沖輸出流”
    public BufferedOutputStream(OutputStream out) {
        this(out, 8192);
    }
     
    // 構造函數：新建字節數組大小為size的“緩沖輸出流”
    public BufferedOutputStream(OutputStream out, int size) {
        super(out);
        if (size <= 0) {
            throw new IllegalArgumentException("Buffer size <= 0");
        }
        buf = new byte[size];
    }
     
    // 將緩沖數據都寫入到輸出流中
    private void flushBuffer() throws IOException {
        if (count > 0) {
            out.write(buf, 0, count);
            count = 0;
        }
    }
     
    // 將“數據b(轉換成字節類型)”寫入到輸出流中
    public synchronized void write(int b) throws IOException {
        // 若緩沖已滿，則先將緩沖數據寫入到輸出流中。
        if (count >= buf.length) {
            flushBuffer();
        }
        // 將“數據b”寫入到緩沖中
        buf[count++] = (byte)b;
    }
     
    public synchronized void write(byte b[], int off, int len) throws IOException {
        // 若“寫入長度”大於“緩沖區大小”，則先將緩沖中的數據寫入到輸出流，然後直接將數組b寫入到輸出流中
        if (len >= buf.length) {
            flushBuffer();
            out.write(b, off, len);
            return;
        }
        // 若“剩余的緩沖空間 不足以 存儲即將寫入的數據”，則先將緩沖中的數據寫入到輸出流中
        if (len > buf.length - count) {
            flushBuffer();
        }
        System.arraycopy(b, off, buf, count, len);
        count += len;
    }
     
    // 將“緩沖數據”寫入到輸出流中
    public synchronized void flush() throws IOException {
        flushBuffer();
        out.flush();
    }
}

說明：

BufferedOutputStream的源碼非常簡單，這裡就BufferedOutputStream的思想進行簡單說明：BufferedOutputStream通過字節數組來緩沖數據，當緩沖區滿或者用戶調用flush()函數時，它就會將緩沖區的數據寫入到輸出流中。

查看本欄目

示例代碼

關於BufferedOutputStream中API的詳細用法，參考示例代碼(BufferedOutputStreamTest.java)：

import java.io.BufferedOutputStream;
import java.io.File;
import java.io.OutputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.FileNotFoundException;
import java.lang.SecurityException;
import java.util.Scanner;
     
/**
 * BufferedOutputStream 測試程序
 *
 * @author skywang
 */
public class BufferedOutputStreamTest {
     
    private static final int LEN = 5;
    // 對應英文字母“abcddefghijklmnopqrsttuvwxyz”
    private static final byte[] ArrayLetters = {
        0x61, 0x62, 0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x6A, 0x6B, 0x6C, 0x6D, 0x6E, 0x6F,
        0x70, 0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78, 0x79, 0x7A
    };
     
    public static void main(String[] args) {
        testBufferedOutputStream() ;
    }
     
    /**
     * BufferedOutputStream的API測試函數
     */
    private static void testBufferedOutputStream() {
     
        // 創建“文件輸出流”對應的BufferedOutputStream
        // 它對應緩沖區的大小是16，即緩沖區的數據>=16時，會自動將緩沖區的內容寫入到輸出流。
        try {
            File file = new File("out.txt");
            OutputStream out =
                  new BufferedOutputStream(
                      new FileOutputStream(file), 16);
     
            // 將ArrayLetters數組的前10個字節寫入到輸出流中
            out.write(ArrayLetters, 0, 10);
            // 將“換行符\n”寫入到輸出流中
            out.write('\n');
     
            // TODO!
            //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);
    }
}

運行結果：

生成文件“out.txt”，文件的內容是“abcdefghij”。

分步測試：

分別按照下面3種步驟測試程序,來查看緩沖區大小以及flush()的作用。

第1種：原始程序。

(01) 運行程序。在程序等待用戶輸入時，查看“out.txt”的文本內容；發現：內容為空。

(02) 運行程序。在用戶輸入之後，查看“out.txt”的文本內容；發現：內容為“abcdefghij”。

從中，我們發現(01)和(02)的結果不同；之所以(01)中的out.txt內容為空，是因為out.txt對應的緩沖區大小是16字節，而我們只寫入了11個字節，所以，它不會執行清空緩沖操作(即，將緩沖數據寫入到輸出流中)。

而(02)對應out.txt的內容是“abcdefghij”，是因為執行了out.close()，它會關閉輸出流；在關閉輸出流之前，會將緩沖區的數據寫入到輸出流中。

注意：重新測試時，要先刪除out.txt。

第2種：在readUserInput()前添加如下語句，

out.flush();