(最近剛來到簡(jiǎn)書平臺(tái)鹅很,以前在CSDN上寫的一些東西像吻,也在逐漸的移到這兒來,有些篇幅是很早的時(shí)候?qū)懴碌纳装虼丝赡軙?huì)看到一些內(nèi)容雜亂的文章晃琳,對(duì)此深感抱歉,以下為正文)
正文
本篇講述的是Java IO包中的FilterReader和FilterWriter類琐鲁,它們同F(xiàn)ilterInputStream和FilterOutputStream類一樣卫旱,是Reader和Writer的包裝類,為Reader和Writer提供了更多的功能围段,下面先貼上源碼顾翼,對(duì)其進(jìn)行簡(jiǎn)單的分析。
FilterReader.java
package java.io;
public abstract class FilterReader extends Reader {
//內(nèi)置了一個(gè)Reader對(duì)象句柄in奈泪,用于接收傳入的Reader對(duì)象适贸。
protected Reader in;
/**
* 帶一個(gè)參數(shù)的構(gòu)造方法,傳入的參數(shù)類型為一個(gè)Reader對(duì)象涝桅。內(nèi)部直接調(diào)用父類Reader對(duì)象的對(duì)應(yīng)構(gòu)造方法拜姿,并為內(nèi)置的Reader對(duì)象句柄in賦值。
*/
protected FilterReader(Reader in) {
super(in);
this.in = in;
}
/**
* 該方法每次讀取讀取一個(gè)字符的數(shù)據(jù)冯遂,實(shí)質(zhì)就是調(diào)用Reader中對(duì)應(yīng)的read方法蕊肥。
*/
public int read() throws IOException {
return in.read();
}
/**
* 該方法每次能夠讀取多個(gè)字符的數(shù)據(jù),包含三個(gè)參數(shù)蛤肌,第一個(gè)參數(shù)為一個(gè)字符數(shù)組壁却,用于存放讀取的數(shù)據(jù)內(nèi)容,第二和第三個(gè)參數(shù)都是一個(gè)int型數(shù)值寻定,分別表示著
* 在數(shù)組中存放數(shù)據(jù)的起點(diǎn)以及存儲(chǔ)數(shù)據(jù)的長(zhǎng)度儒洛。內(nèi)部實(shí)質(zhì)直接調(diào)用Reader中對(duì)應(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)部實(shí)質(zhì)直接調(diào)用Reader中對(duì)應(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)部實(shí)質(zhì)是直接調(diào)用Reader的mark方法僵芹。
*/
public void mark(int readAheadLimit) throws IOException {
in.mark(readAheadLimit);
}
/**
* 該方法用于與mark方法聯(lián)用处硬,用于將當(dāng)前流的讀取位置回退到標(biāo)記的地方。內(nèi)部實(shí)質(zhì)是直接調(diào)用Reader的reset方法拇派。
*/
public void reset() throws IOException {
in.reset();
}
/**
* 該方法用于關(guān)閉當(dāng)前的流及與之相關(guān)聯(lián)的系統(tǒng)資源荷辕。內(nèi)部實(shí)質(zhì)是直接調(diào)用Reader對(duì)應(yīng)的close方法凿跳。
*/
public void close() throws IOException {
in.close();
}
}
FilterWriter:
package java.io;
public abstract class FilterWriter extends Writer {
//內(nèi)置了一個(gè)Writer對(duì)象的句柄,用于接收傳入的Writer對(duì)象疮方。
protected Writer out;
/**
* 一個(gè)帶一個(gè)參數(shù)的構(gòu)造方法控嗜,傳入的參數(shù)是一個(gè)Writer對(duì)象。內(nèi)部實(shí)質(zhì)上是調(diào)用Writer對(duì)應(yīng)的構(gòu)造方法骡显,并為內(nèi)置的Writer對(duì)象句柄賦值疆栏。
*/
protected FilterWriter(Writer out) {
super(out);
this.out = out;
}
/**
* 該方法可以每次寫入一個(gè)字符的數(shù)據(jù),傳入的參數(shù)為要寫入字符數(shù)據(jù)的int型值惫谤。內(nèi)部實(shí)質(zhì)是調(diào)用Writer對(duì)應(yīng)的構(gòu)造方法壁顶。
*/
public void write(int c) throws IOException {
out.write(c);
}
/**
* 該方法可以每次寫入多個(gè)字符的數(shù)據(jù),含有3個(gè)參數(shù)溜歪,第一個(gè)參數(shù)為一個(gè)字符型數(shù)組若专,其中包含要寫入的數(shù)據(jù),第二和第三個(gè)參數(shù)都是一個(gè)int型數(shù)值
* 分別表示了從數(shù)組中取出數(shù)據(jù)的起點(diǎn)和長(zhǎng)度痹愚。內(nèi)部本質(zhì)是直接調(diào)用Writer對(duì)應(yīng)的write方法富岳。
*/
public void write(char cbuf[], int off, int len) throws IOException {
out.write(cbuf, off, len);
}
/**
* 該方法可以每次寫入一個(gè)字符串類型的數(shù)據(jù)(可以截取一部分),含有3個(gè)參數(shù)拯腮,第一個(gè)參數(shù)為要寫入的字符串類型的數(shù)據(jù)窖式,第二和第三個(gè)參數(shù)都是
* 一個(gè)int型數(shù)據(jù),分別代表截取字符串?dāng)?shù)據(jù)的起點(diǎn)和終點(diǎn)动壤。內(nèi)部本質(zhì)上是直接調(diào)用Writer對(duì)應(yīng)的write方法萝喘。
*/
public void write(String str, int off, int len) throws IOException {
out.write(str, off, len);
}
/**
* 該方法用于將緩存中的數(shù)據(jù)強(qiáng)制寫出。內(nèi)部實(shí)質(zhì)上是調(diào)用Writer的flush方法琼懊。
*/
public void flush() throws IOException {
out.flush();
}
/**
* 該方法用于關(guān)閉當(dāng)前流以及其相關(guān)聯(lián)的系統(tǒng)資源阁簸。內(nèi)部實(shí)質(zhì)上是調(diào)用Writer的close方法。
*/
public void close() throws IOException {
out.close();
}
}
通過對(duì)源碼的簡(jiǎn)單分析哼丈,我們也不難看出FilterReader/FilterWriter和之前說過的FilterInputStream/FilterOutputStream一樣启妹,都是一個(gè)包裝類,它們本身并沒有什么特別大的意義醉旦,更多的是定義了標(biāo)準(zhǔn)饶米,具體的實(shí)現(xiàn)是由子類來實(shí)現(xiàn)的,這里再次牽扯到了裝飾者模式车胡,將在其它的篇幅中介紹到檬输。
以上為本篇的全部?jī)?nèi)容。