java.io类InputStream
java.io.InputStream
所有已实现的接口：
直接已知子类：
public abstract class
InputStream
extends
Object
implements
Closeable
此抽象类是表示字节输入流的所有类的超类。
需要定义InputStream子类的应用程序必须总是提供返回下一个输入字节的方法。
从以下版本开始：
JDK1.0
另请参见：
方法摘要
int
()返回此输入流下一个方法调用可以不受阻塞地从此输入流读取(或跳过)的估计字节数。
void
()关闭此输入流并释放与该流关联的所有系统资源。
void
(int
readlimit)在此输入流中标记当前的位置。
boolean
()测试此输入流是否支持mark和reset方法。
abstract int
()从输入流中读取数据的下一个字节。
int
(byte[]
b)从输入流中读取一定数量的字节，并将其存储在缓冲区数组b中。
int
(byte[]
b, int off, int len)将输入流中最多len个数据字节读入byte数组。
void
()将此流重新定位到最后一次对此输入流调用mark方法时的位置。
long
(long
n)跳过和丢弃此输入流中数据的n个字节。
构造方法详细信息
InputStream
public
InputStream()
方法详细信息
read
public abstract int
read()
从输入流中读取数据的下一个字节。返回0到255范围内的int字节值。如果因为已经到达流末尾而没有可用的字节，则返回值-1。在输入数据可用、检测到流末尾或者抛出异常前，此方法一直阻塞。
子类必须提供此方法的一个实现。
返回：
下一个数据字节；如果到达流的末尾，则返回-1。
抛出：
如果发生I/O
错误。
read
public int
read(byte[] b)
从输入流中读取一定数量的字节，并将其存储在缓冲区数组b中。以整数形式返回实际读取的字节数。在输入数据可用、检测到文件末尾或者抛出异常前，此方法一直阻塞。
如果b的长度为0，则不读取任何字节并返回0；否则，尝试读取至少一个字节。如果因为流位于文件末尾而没有可用的字节，则返回值-1；否则，至少读取一个字节并将其存储在b中。
将读取的第一个字节存储在元素b[0]中，下一个存储在b[1]中，依次类推。读取的字节数最多等于b的长度。设 k为实际读取的字节数；这些字节将存储在b[0]到b[k-1]的元素中，不影响b[k]到b[b.length-1]的元素。
类InputStream
的read(b)方法的效果等同于：
read(b, 0,b.length)
参数：
b -存储读入数据的缓冲区。
返回：
读入缓冲区的总字节数；如果因为已经到达流末尾而不再有数据可用，则返回-1。
抛出：
如果不是因为流位于文件末尾而无法读取第一个字节；如果输入流已关闭；如果发生其他I/O错误。
另请参见：
read
public int
read(byte[] b,
intoff,
intlen)
将输入流中最多len
个数据字节读入byte数组。尝试读取len个字节，但读取的字节也可能小于该值。以整数形式返回实际读取的字节数。
在输入数据可用、检测到流末尾或者抛出异常前，此方法一直阻塞。
如果len为0，则不读取任何字节并返回0；否则，尝试读取至少一个字节。如果因为流位于文件末尾而没有可用的字节，则返回值-1；否则，至少读取一个字节并将其存储在b中。
将读取的第一个字节存储在元素b[off]中，下一个存储在b[off+1]中，依次类推。读取的字节数最多等于len。设
k为实际读取的字节数；这些字节将存储在b[off]到b[off+k-1]的元素中，不影响b[off+k]到b[off+len-1]的元素。
在任何情况下，b[0]
到b[off]的元素以及b[off+len]到b[b.length-1]的元素都不会受到影响。
类InputStream
的read(b, off, len)方法重复调用方法read()。如果第一次这样的调用导致IOException，则从对read(b, off, len)方法的调用中返回该异常。如果对read()的任何后续调用导致IOException，则捕获该异常并将其视为到达文件末尾；到达该点时读取的字节存储在b中，并返回发生异常之前读取的字节数。在已读取输入数据len的请求数量、检测到文件结束标记、抛出异常前，此方法的默认实现将一直阻塞。建议子类提供此方法更为有效的实现。
参数：
b -读入数据的缓冲区。
off -数组b中将写入数据的初始偏移量。
len -要读取的最大字节数。
返回：
读入缓冲区的总字节数；如果因为已到达流末尾而不再有数据可用，则返回-1。
抛出：
如果不是因为位于文件末尾而无法读取第一个字节；如果输入流已关闭；如果发生其他I/O错误。
如果off
为负，len为负，或者len大于b.length - off
另请参见：
skip
public long
skip(long n)
跳过和丢弃此输入流中数据的n
个字节。出于各种原因，skip方法结束时跳过的字节数可能小于该数，也可能为0。导致这种情况的原因很多，跳过n个字节之前已到达文件末尾只是其中一种可能。返回跳过的实际字节数。如果 n为负，则不跳过任何字节。
此类的skip方法创建一个byte数组，然后重复将字节读入其中，直到读够n个字节或已到达流末尾为止。建议子类提供此方法更为有效的实现。例如，可依赖搜索能力的实现。
参数：
n -要跳过的字节数。
返回：
跳过的实际字节数。
抛出：
如果流不支持搜索，或者发生其他I/O错误。
available
public int
available()
返回此输入流下一个方法调用可以不受阻塞地从此输入流读取(或跳过)的估计字节数。下一个调用可能是同一个线程，也可能是另一个线程。一次读取或跳过此估计数个字节不会受阻塞，但读取或跳过的字节数可能小于该数。
注意，有些InputStream的实现将返回流中的字节总数，但也有很多实现不会这样做。试图使用此方法的返回值分配缓冲区，以保存此流所有数据的做法是不正确的。
如果已经调用
类InputStream
的available方法总是返回0。
此方法应该由子类重写。
返回：
可以不受阻塞地从此输入流读取(或跳过)的估计字节数；如果到达输入流末尾，则返回0。
抛出：
如果发生I/O
错误。
close
public void
close()
关闭此输入流并释放与该流关联的所有系统资源。
InputStream的close方法不执行任何操作。
指定者：
抛出：
如果发生I/O
错误。
mark
public void
mark(int readlimit)
在此输入流中标记当前的位置。对reset方法的后续调用会在最后标记的位置重新定位此流，以便后续读取重新读取相同的字节。
readlimit参数告知此输入流在标记位置失效之前允许读取的字节数。
mark的常规协定是：如果方法markSupported返回true，那么输入流总是在调用mark
之后记录所有读取的字节，并时刻准备在调用方法reset时(无论何时)，再次提供这些相同的字节。但是，如果在调用reset之前可以从流中读取多于readlimit的字节，则不需要该流记录任何数据。
标记已关闭的流对其无效。
InputStream的mark方法不执行任何操作。
参数：
readlimit -在标记位置失效前可以读取字节的最大限制。
另请参见：
reset
public void
reset()
将此流重新定位到最后一次对此输入流调用mark方法时的位置。
reset的常规协定是：
·如果方法markSupported返回true，那么：
o如果创建流以后未调用方法mark，或最后调用mark以后从该流读取的字节数大于最后调用mark时的参数，则可能抛出IOException。
o如果未抛出这样的IOException，则将该流重新设置为这种状态：最近一次调用mark以后(如果未调用过mark，则从文件开头开始)读取的所有字节将重新提供给read方法的后续调用者，后跟任何从调用reset时起将作为下一输入数据的字节。
·如果方法markSupported返回false，那么：
o对reset的调用可能抛出IOException。
o如果未抛出IOException，则将该流重新设置为一种固定状态，该状态取决于输入流的特定类型及其创建方式。提供给read方法后续调用者的字节取决于特定类型的输入流。
除了抛出IOException
之外，类InputStream的方法reset不执行任何操作。
抛出：
如果未标记此流或该标记失效。
另请参见：
markSupported
public boolean
markSupported()
测试此输入流是否支持mark
和reset方法。是否支持mark和reset是特定输入流实例的不变属性。InputStream的markSupported方法返回false。
返回：
如果此输入流实例支持mark
和reset方法，则返回true；否则返回false。
