java io进修（十七） CharArrayReader(字符数组输入流)
副标题#e#
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;
}
#p#副标题#e#
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。
#p#分页标题#e#(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
