Java IO筆記(FilterReader/FilterWriter)


(最近剛來到簡書平臺,以前在CSDN上寫的一些東西,也在逐漸的移到這兒來,有些篇幅是很早的時候?qū)懴碌?,因此可能會看到一些?nèi)容雜亂的文章,對此深感抱歉,以下為正文)


正文

本篇講述的是Java IO包中的FilterReader和FilterWriter類,它們同F(xiàn)ilterInputStream和FilterOutputStream類一樣,是Reader和Writer的包裝類,為Reader和Writer提供了更多的功能,下面先貼上源碼,對其進(jìn)行簡單的分析。
FilterReader.java

package java.io;
 
public abstract class FilterReader extends Reader {
 
    //內(nèi)置了一個Reader對象句柄in,用于接收傳入的Reader對象。
    protected Reader in;
 
    /**
     * 帶一個參數(shù)的構(gòu)造方法,傳入的參數(shù)類型為一個Reader對象。內(nèi)部直接調(diào)用父類Reader對象的對應(yīng)構(gòu)造方法,并為內(nèi)置的Reader對象句柄in賦值。
     */
    protected FilterReader(Reader in) {
        super(in);
        this.in = in;
    }
 
    /**
     * 該方法每次讀取讀取一個字符的數(shù)據(jù),實質(zhì)就是調(diào)用Reader中對應(yīng)的read方法。
     */
    public int read() throws IOException {
        return in.read();
    }
 
    /**
     * 該方法每次能夠讀取多個字符的數(shù)據(jù),包含三個參數(shù),第一個參數(shù)為一個字符數(shù)組,用于存放讀取的數(shù)據(jù)內(nèi)容,第二和第三個參數(shù)都是一個int型數(shù)值,分別表示著
     * 在數(shù)組中存放數(shù)據(jù)的起點以及存儲數(shù)據(jù)的長度。內(nèi)部實質(zhì)直接調(diào)用Reader中對應(yīng)的read方法。
     */
    public int read(char cbuf[], int off, int len) throws IOException {
        return in.read(cbuf, off, len);
    }
 
    /**
     * 該方法可以跳過指定字符數(shù)量的數(shù)據(jù)。內(nèi)部實質(zhì)直接調(diào)用Reader中對應(yīng)的read方法。
     */
    public long skip(long n) throws IOException {
        return in.skip(n);
    }
 
    /**
     * 該方法用于判斷當(dāng)前流是否處于可讀狀態(tài)
     */
    public boolean ready() throws IOException {
        return in.ready();
    }
 
    /**
     * 該方法用于判斷當(dāng)前流是否支持流標(biāo)記功能。
     */
    public boolean markSupported() {
        return in.markSupported();
    }
 
    /**
     * 該方法用于在指定位置留下標(biāo)記,以便于跟reset方法聯(lián)合使用,從而可以使流回退到標(biāo)記的地方。內(nèi)部實質(zhì)是直接調(diào)用Reader的mark方法。
     */
    public void mark(int readAheadLimit) throws IOException {
        in.mark(readAheadLimit);
    }
 
    /**
     * 該方法用于與mark方法聯(lián)用,用于將當(dāng)前流的讀取位置回退到標(biāo)記的地方。內(nèi)部實質(zhì)是直接調(diào)用Reader的reset方法。
     */
    public void reset() throws IOException {
        in.reset();
    }
 
    
    /**
     * 該方法用于關(guān)閉當(dāng)前的流及與之相關(guān)聯(lián)的系統(tǒng)資源。內(nèi)部實質(zhì)是直接調(diào)用Reader對應(yīng)的close方法。
     */
    public void close() throws IOException {
        in.close();
    }
}
FilterWriter:
package java.io;
 
 
public abstract class FilterWriter extends Writer {
 
    //內(nèi)置了一個Writer對象的句柄,用于接收傳入的Writer對象。
    protected Writer out;
 
    /**
     * 一個帶一個參數(shù)的構(gòu)造方法,傳入的參數(shù)是一個Writer對象。內(nèi)部實質(zhì)上是調(diào)用Writer對應(yīng)的構(gòu)造方法,并為內(nèi)置的Writer對象句柄賦值。
     */
    protected FilterWriter(Writer out) {
        super(out);
        this.out = out;
    }
 
    /**
     * 該方法可以每次寫入一個字符的數(shù)據(jù),傳入的參數(shù)為要寫入字符數(shù)據(jù)的int型值。內(nèi)部實質(zhì)是調(diào)用Writer對應(yīng)的構(gòu)造方法。
     */
    public void write(int c) throws IOException {
        out.write(c);
    }
 
    /**
     * 該方法可以每次寫入多個字符的數(shù)據(jù),含有3個參數(shù),第一個參數(shù)為一個字符型數(shù)組,其中包含要寫入的數(shù)據(jù),第二和第三個參數(shù)都是一個int型數(shù)值
     * 分別表示了從數(shù)組中取出數(shù)據(jù)的起點和長度。內(nèi)部本質(zhì)是直接調(diào)用Writer對應(yīng)的write方法。
     */
    public void write(char cbuf[], int off, int len) throws IOException {
        out.write(cbuf, off, len);
    }
 
    /**
     * 該方法可以每次寫入一個字符串類型的數(shù)據(jù)(可以截取一部分),含有3個參數(shù),第一個參數(shù)為要寫入的字符串類型的數(shù)據(jù),第二和第三個參數(shù)都是
     * 一個int型數(shù)據(jù),分別代表截取字符串?dāng)?shù)據(jù)的起點和終點。內(nèi)部本質(zhì)上是直接調(diào)用Writer對應(yīng)的write方法。
     */
    public void write(String str, int off, int len) throws IOException {
        out.write(str, off, len);
    }
 
    /**
     * 該方法用于將緩存中的數(shù)據(jù)強制寫出。內(nèi)部實質(zhì)上是調(diào)用Writer的flush方法。
     */
    public void flush() throws IOException {
        out.flush();
    }
 
    /**
     * 該方法用于關(guān)閉當(dāng)前流以及其相關(guān)聯(lián)的系統(tǒng)資源。內(nèi)部實質(zhì)上是調(diào)用Writer的close方法。
     */
    public void close() throws IOException {
        out.close();
    }
 
}

通過對源碼的簡單分析,我們也不難看出FilterReader/FilterWriter和之前說過的FilterInputStream/FilterOutputStream一樣,都是一個包裝類,它們本身并沒有什么特別大的意義,更多的是定義了標(biāo)準(zhǔn),具體的實現(xiàn)是由子類來實現(xiàn)的,這里再次牽扯到了裝飾者模式,將在其它的篇幅中介紹到。

以上為本篇的全部內(nèi)容。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容