InputStream这个抽象类是所有基于字节的输入流的超类,抽象了Java的字节输入模型。在这个类中定义了一些基本的方法。看一下类的定义:
public abstract class InputStream implements Closeable
首先这是一个抽象类,实现了Closeable接口,也Closeable接口又拓展了AutoCloseable接口,因此所有InputStream及其子类都可以用于Java 7 新引入的带资源的try语句。读入字节之前,我们可能想要先知道还有多少数据可用,这有available方法完成,具体的读入由read()及其重载方法完成,skip方法用于跳过某些字节,同时定义了几个有关标记(mark)的方法,读完数据使用close方法关闭流,释放资源。下面详细介绍各个方 法:
1. available方法
public int available() throws IOException
假设方法返回的int值为a,a代表的是在不阻塞的情况下,可以读入或者跳过(skip)的字节数。也就是说,在该对象下一次调用读入方法读入a个字节,或者skip方法跳过a个字节时,不会出现阻塞(block)的情况。这个调用可以由相同线程调用,也可以是其他线程调用。但是在下次读入或跳过的时候,实际读入(跳过)的可能不只a字节。当遇到流结尾的时候,返回0。如果出现I/O错误,抛出IOException异常。看一下InputStream中该方法的实现:
public int available() throws IOException {
return 0;
}
2. 读入方法:read
2.1 read()
public abstract int read()throws IOException
2.2 read(byte[] b)
public int read(byte b[]) throws IOException
2.3 read (byte[] b, int off, int len)
public int read(byte[] b,int off,int len) throws IOException
public int read(byte b[]) throws IOException {
return read(b, 0, b.length);
}
public int read(byte b[], int off, int len) throws IOException {
if (b == null) { // 检测参数是否为null
throw new NullPointerException();
} else if (off < || len < || len > b.length - off) {
throw new IndexOutOfBoundsException(); // 数组越界检测
} else if (len == ) {
return ; //如果b为空数组,返回0
} int c = read(); // 调用read()方法获取下一个字节
if (c == -) {
return -;
} // 遇到流尾部,返回-1
b[off] = (byte)c; //读入的第一个字节存入b[off] int i = ; // 统计实际读入的字节数
try {
for (; i < len ; i++) { // 循环调用read,直到流尾部
c = read();
if (c == -) {
break;
}
b[off + i] = (byte)c; // 一次存入字节数组
}
} catch (IOException ee) {
}
return i; // 返回实际读入的字节数
}
会受到数据源的影响。另外一点就是读入的数据存到哪里,第一个方法作为返回值,第二、三个方法存入到指定数组的指定位置,返回的是实际读入的字节数。后两个方法真正的读入工作都是通过调用抽象方法read()来完成的,资格抽象方法在子类中实现。
3. skip方法
public long skip(long n)throws IOException
这个方法试图跳过当前流的n个字节,返回实际跳过的字节数。如果n为负数,返回0.当然子类可能提供不能的处理方式。n只是我们的期望,至于具体跳过几个,则不受我们控制,比如遇到流结尾。修改上面的例子:
public long skip(long n) throws IOException {
long remaining = n; // 还有多少字节没跳过
int nr;
if (n <= ) {
return ; // n小于0 简单返回0
}
int size = (int)Math.min(MAX_SKIP_BUFFER_SIZE, remaining); // 这里的常数在类中定义为2048
byte[] skipBuffer = new byte[size]; // 新建一个字节数组,如果n<2048,数组大小为n,否则为2048
while (remaining > ) {
nr = read(skipBuffer, , (int)Math.min(size, remaining)); // 读入字节,存入数组
if (nr < ) { // 遇到流尾部跳出循环
break;
}
remaining -= nr;
}
return n - remaining;
}
4.与标记相关的方法
4.1 mark
public void mark(int readlimit)
4.2 reset
public void reset()throws IOException
这个方法用于重定位到最近的标记。如果在这之前mark方法从来没被调用,或者标记已经无效,在抛出IOException。如果没有抛出这个异常,将当前位置重新定位到最近的标记位置。
InputStream is = null;
try {
is = new BufferedInputStream(new FileInputStream("test.txt"));
is.mark(4);
is.skip(2);
is.reset();
System.out.println((char)is.read());
} finally {
if (is != null) {
is.close();
}
}
4.3 markSupported
public boolean markSupported()
检测当前流对象是否支持标记。是返回true。否则返回false。比如InputStream不支持标记,而BufferedInputStream支持。
5. close方法
public void close()throws IOException
关闭当前流,释放与该流相关的资源,防止资源泄露。在带资源的try语句中将被自动调用。关闭流之后还试图读取字节,会出现IOException异常。