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;
}
只是简单地返回0,因此子类必须重写该方法。注意到一点,虽然这个方法实现中根本不会出现异常,但是还是在throws中指出(specify)可能抛出 IOException。这是Java异常机制很重要的一个点,子类的方法不能throws父类方法没有throws的异常(构造器除外),因此在父类方法先指出,然后允许子类方法抛出IOException。 单独使用这一方法几乎没有意义,它一般用于在读入或者跳过之间先探测一下有多少可用字节。
2. 读入方法:read
跟读入相关的方法是这个类的核心方法。有3种重载的形式,下面分别介绍。
2.1 read()
public abstract int read()throws IOException
读取输入流的下一个字节。这是一个抽象方法,不提供实现,子类必须实现这个方法。该方法读取下一个字节,返回一个0-255之间的int类型整数。如果到达流的末端,返回-1. 调用该方法的时候,方法阻塞直到出现下列其中一种情况:1)遇到流的尾部(end of the stream)。2)有数据可以读入。3)抛出异常。 面向字节的操作时,可能需要像这样比较底层的字节操作。我们也可以一次读入多个字节,使用下面的重载形式。
2.2 read(byte[] b)
public int read(byte b[]) throws IOException
试图读入多个字节,存入字节数组b,返回实际读入的字节数。如果传递的是一个空数组(注意数组长度可以为0,即空数组。比如 byte[] b = new byte[0]; 或者byte[] b = {};)那么什么也没读入,返回0.
如果到达流尾部,没有字节可读,返回-1;如果上面两种情况都没有出现,并且没有I/O错误,则至少有1个字节被读入,存储到字节数组b中。实际读入的第一个字节存在b[0],往后一次存入数组,读入的字节数最多不能超过数组b的长度。如果读入的字节数小于b的长度,剩余的数组元素保持不变。具体地,如果读入的字节数为k,则k个字节分别存在 b[0]到b[k-1],而b[k]到b[b.length-1]保持原来的数据。
2.3 read (byte[] b, int off, int len)
public int read(byte[] b,int off,int len) throws IOException
这个方法跟上一个功能类似,除了读入的数据存储到b数组是从off开始。len是试图读入的字节数,返回的是实际读入的字节数。如果len=0,则什么也不读入,返回0;如果遇到流尾部,返回-1.否则至少读入一个字节。
假设实际读入k个字节,则k个字节分别存储在b[off]到b[off+k-1],而b[off+k]往后的元素保持不变。b[off]之前也保持不变。
public int read(byte b[]) throws IOException {
return read(b, 0, b.length);
}
解析来看一下第三个read方法的源代码:
public int read(byte b[], int off, int len) throws IOException { if (b == null) { // 检测参数是否为null throw new NullPointerException(); } else if (off < 0 || len < 0 || len > b.length - off) { throw new IndexOutOfBoundsException(); // 数组越界检测 } else if (len == 0) { return 0; //如果b为空数组,返回0 } int c = read(); // 调用read()方法获取下一个字节 if (c == -1) { return -1; } // 遇到流尾部,返回-1 b[off] = (byte)c; //读入的第一个字节存入b[off] int i = 1; // 统计实际读入的字节数 try { for (; i < len ; i++) { // 循环调用read,直到流尾部 c = read(); if (c == -1) { break; } b[off + i] = (byte)c; // 一次存入字节数组 } } catch (IOException ee) { } return i; // 返回实际读入的字节数 }