CharArrayReader 介紹
CharArrayReader 是字符數組輸入流。它和ByteArrayInputStream類似,只不過ByteArrayInputStream是字節數組輸入流,而CharArray是字符數組輸入流。CharArrayReader 是用於讀取字符數組,它繼承於Reader。操作的數據是以字符為單位!
CharArrayReader 函數列表
CharArrayReader(char[] buf) CharArrayReader(char[] buf, int offset, int length) void close() void mark(int readLimit) boolean markSupported() int read() int read(char[] buffer, int offset, int len) boolean ready() void reset() long skip(long charCount)
Reader和CharArrayReader源碼分析
Reader是CharArrayReader的父類,我們先看看Reader的源碼,然後再學CharArrayReader的源碼。
1. Reader源碼分析(基於jdk1.7.40)
package java.io; public abstract class Reader implements Readable, Closeable { protected Object lock; protected Reader() { this.lock = this; } protected Reader(Object lock) { if (lock == null) { throw new NullPointerException(); } this.lock = lock; } public int read(java.nio.CharBuffer target) throws IOException { int len = target.remaining(); char[] cbuf = new char[len]; int n = read(cbuf, 0, len); if (n > 0) target.put(cbuf, 0, n); return n; } public int read() throws IOException { char cb[] = new char[1]; if (read(cb, 0, 1) == -1) return -1; else return cb[0]; } public int read(char cbuf[]) throws IOException { return read(cbuf, 0, cbuf.length); } abstract public int read(char cbuf[], int off, int len) throws IOException; private static final int maxSkipBufferSize = 8192; private char skipBuffer[] = null; public long skip(long n) throws IOException { if (n < 0L) throw new IllegalArgumentException("skip value is negative"); int nn = (int) Math.min(n, maxSkipBufferSize); synchronized (lock) { if ((skipBuffer == null) || (skipBuffer.length < nn)) skipBuffer = new char[nn]; long r = n; while (r > 0) { int nc = read(skipBuffer, 0, (int)Math.min(r, nn)); if (nc == -1) break; r -= nc; } return n - r; } } public boolean ready() throws IOException { return false; } public boolean markSupported() { return false; } public void mark(int readAheadLimit) throws IOException { throw new IOException("mark() not supported"); } public void reset() throws IOException { throw new IOException("reset() not supported"); } abstract public void close() throws IOException; }
2. CharArrayReader 源碼分析(基於jdk1.7.40)
package java.io; public class CharArrayReader extends Reader { // 字符數組緩沖 protected char buf[]; // 下一個被獲取的字符的位置 protected int pos; // 被標記的位置 protected int markedPos = 0; // 字符緩沖的長度 protected int count; // 構造函數 public CharArrayReader(char buf[]) { this.buf = buf; this.pos = 0; this.count = buf.length; } // 構造函數 public CharArrayReader(char buf[], int offset, int length) { if ((offset < 0) || (offset > buf.length) || (length < 0) || ((offset + length) < 0)) { throw new IllegalArgumentException(); } this.buf = buf; this.pos = offset; this.count = Math.min(offset + length, buf.length); this.markedPos = offset; } // 判斷“CharArrayReader是否有效”。 // 若字符緩沖為null,則認為其無效。 private void ensureOpen() throws IOException { if (buf == null) throw new IOException("Stream closed"); } // 讀取下一個字符。即返回字符緩沖區中下一位置的值。 // 查看本欄目說明:
CharArrayReader實際上是通過“字符數組”去保存數據。
(01) 通過 CharArrayReader(char[] buf) 或 CharArrayReader(char[] buf, int offset, int length) ,我們可以根據buf數組來創建CharArrayReader對象。
(02) read()的作用是從CharArrayReader中“讀取下一個字符”。
(03) read(char[] buffer, int offset, int len)的作用是從CharArrayReader讀取字符數據,並寫入到字符數組buffer中。offset是將字符寫入到buffer的起始位置,len是寫入的字符的長度。
(04) markSupported()是判斷CharArrayReader是否支持“標記功能”。它始終返回true。
(05) mark(int readlimit)的作用是記錄標記位置。記錄標記位置之後,某一時刻調用reset()則將“CharArrayReader下一個被讀取的位置”重置到“mark(int readlimit)所標記的位置”;也就是說,reset()之後再讀取CharArrayReader時,是從mark(int readlimit)所標記的位置開始讀取。
示例代碼
關於CharArrayReader中API的詳細用法,參考示例代碼(CharArrayReaderTest.java):
/** * CharArrayReader 演示程序 * * @author skywang */ import java.io.CharArrayReader; import java.io.CharArrayWriter; import java.io.IOException; public class CharArrayReaderTest { private static final int LEN = 5; // 對應英文字母“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) { tesCharArrayReader() ; } /** * CharArrayReader的API測試函數 */ private static void tesCharArrayReader() { try { // 創建CharArrayReader字符流,內容是ArrayLetters數組 CharArrayReader car = new CharArrayReader(ArrayLetters); // 從字符數組流中讀取5個字符 for (int i=0; i<LEN; i++) { // 若能繼續讀取下一個字符,則讀取下一個字符 if (car.ready() == true) { // 讀取“字符流的下一個字符” char tmp = (char)car.read(); System.out.printf("%d : %c\n", i, tmp); } } // 若“該字符流”不支持標記功能,則直接退出 if (!car.markSupported()) { System.out.println("make not supported!"); return ; } // 標記“字符流中下一個被讀取的位置”。即--標記“f”,因為因為前面已經讀取了5個字符,所以下一個被讀取的位置是第6個字符” // (01), CharArrayReader類的mark(0)函數中的“參數0”是沒有實際意義的。 // (02), mark()與reset()是配套的,reset()會將“字符流中下一個被讀取的位置”重置為“mark()中所保存的位置” car.mark(0); // 跳過5個字符。跳過5個字符後,字符流中下一個被讀取的值應該是“k”。 car.skip(5); // 從字符流中讀取5個數據。即讀取“klmno” char[] buf = new char[LEN]; car.read(buf, 0, LEN); System.out.printf("buf=%s\n", String.valueOf(buf)); // 重置“字符流”:即,將“字符流中下一個被讀取的位置”重置到“mark()所標記的位置”,即f。 car.reset(); // 從“重置後的字符流”中讀取5個字符到buf中。即讀取“fghij” car.read(buf, 0, LEN); System.out.printf("buf=%s\n", String.valueOf(buf)); } catch (IOException e) { e.printStackTrace(); } } }運行結果:
0 : a
1 : b
2 : c
3 : d
4 : e
buf=klmno
buf=fghij
來源:http://www.cnblogs.com/skywang12345/p/io_18.html