Java java.io 类 FileInputStream（JDK5）

所有类

java.io
类 FileInputStream

java.lang.Object
  java.io.InputStream
      java.io.FileInputStream

所有已实现的接口：

Closeable

public class FileInputStream
   
   
   
   
   
extends InputStream
   
   
   
   
   

FileInputStream 从文件系统中的某个文件中获取输入字节。哪些文件可用取决于主机环境。

FileInputStream 用于读取诸如图像数据之类的原始字节流。要读取字符流，请考虑使用 FileReader。

从以下版本开始：

JDK1.0

另请参见：

File, FileDescriptor, FileOutputStream

FileInputStream

public FileInputStream(String name)
                throws FileNotFoundException

通过打开一个到实际文件的连接来创建一个 FileInputStream，该文件通过文件系统中的路径名 name 指定。创建一个新 FileDescriptor 对象来表示此文件连接。

首先，如果有安全管理器，则用 name 作为参数调用其 checkRead 方法。

如果指定文件不存在，或者它是一个目录，而不是一个常规文件，抑或因为其他某些原因而无法打开进行读取，则抛出 FileNotFoundException。

参数：

name - 与系统有关的文件名。

抛出：

FileNotFoundException - 如果该文件不存在，或者它是一个目录，而不是一个常规文件，抑或因为其他某些原因而无法打开进行读取。

SecurityException - 如果存在安全管理器，且其 checkRead 方法拒绝对文件进行读取访问。

另请参见：

SecurityManager.checkRead(java.lang.String)

FileInputStream

public FileInputStream(File file)
                throws FileNotFoundException

通过打开一个到实际文件的连接来创建一个 FileInputStream，该文件通过文件系统中的 File 对象 file 指定。创建一个新 FileDescriptor 对象来表示此文件连接。

首先，如果有安全管理器，则用 file 参数表示的路径作为参数调用其 checkRead 方法。

如果指定文件不存在，或者它是一个目录，而不是一个常规文件，抑或因为其他某些原因而无法打开进行读取，则抛出 FileNotFoundException。

参数：

file - 为了进行读取而打开的文件。

抛出：

FileNotFoundException - 如果该文件不存在，或者它是一个目录，而不是一个常规文件，抑或因为其他某些原因而无法打开进行读取。

SecurityException - 如果存在安全管理器，且其 checkRead 方法拒绝对文件进行读取访问。

另请参见：

File.getPath(), SecurityManager.checkRead(java.lang.String)

FileInputStream

public FileInputStream(FileDescriptor fdObj)

通过使用文件描述符 fdObj 创建一个 FileInputStream，该文件描述符表示到文件系统中某个实际文件的现有连接。

首先，如果有安全管理器，则用文件描述符 fdObj 作为参数调用其 checkRead 方法，以查看它是否可以读取该文件描述符。如果拒绝对该文件描述符进行读取访问，则抛出 SecurityException。

如果 fdObj 为 null，则抛出 NullPointerException。

参数：

fdObj - 为了进行读取而打开的文件描述符。

抛出：

SecurityException - 如果存在安全管理器，且其 checkRead 方法拒绝对文件描述符进行读取访问

另请参见：

SecurityManager.checkRead(java.io.FileDescriptor)

read

public int read()
         throws IOException

从此输入流中读取一个数据字节。如果没有输入可用，则此方法将阻塞。

指定者：

类 InputStream 中的 read

返回：

下一个数据字节；如果已到达文件末尾，则返回 -1。

抛出：

IOException - 如果发生 I/O 错误。

read

public int read(byte[] b)
         throws IOException

从此输入流中将最多 b.length 个字节的数据读入一个字节数组中。在某些输入可用之前，此方法将阻塞。

覆盖：

类 InputStream 中的 read

参数：

b - 存储读取数据的缓冲区。

返回：

读入缓冲区的字节总数，如果因为已经到达文件末尾而没有更多的数据，则返回 -1。

抛出：

IOException - 如果发生 I/O 错误。

另请参见：

InputStream.read(byte[], int, int)

read

public int read(byte[] b,
                int off,
                int len)
         throws IOException

从此输入流中将最多 len 个字节的数据读入一个字节数组中。在某些输入可用之前，此方法将阻塞。

覆盖：

类 InputStream 中的 read

参数：

b - 存储读取数据的缓冲区。

off - 数据的起始偏移量。

len - 读取的最大字节数。

返回：

读入缓冲区的字节总数，如果因为已经到达文件末尾而没有更多的数据，则返回 -1。

抛出：

IOException - 如果发生 I/O 错误。

另请参见：

InputStream.read()

skip

public long skip(long n)
          throws IOException

从输入流中跳过并丢弃 n 个字节的数据。

出于各种原因，skip 方法最终跳过的字节数可能更少一些，甚至可能为 0。如果 n 为负，则抛出 IOException，即使 InputStream 超类的 skip 方法在这种情况下没有执行任何操作。返回实际跳过的字节数。

此方法跳过的字节可能多于底层文件中剩余的字节。这不会产生异常，并且跳过的字节数可能包括底层文件的 EOF（文件结束符）之后的一些字节数。如果试图在跳过末尾之后读取流，那么会返回指示文件末尾的 -1。

覆盖：

类 InputStream 中的 skip

参数：

n - 要跳过的字节数。

返回：

实际跳过的字节数。

抛出：

IOException - 如果 n 为负，或者发生 I/O 错误。

available

public int available()
              throws IOException

返回可以不受阻塞地从此文件输入流中读取的字节数。

覆盖：

类 InputStream 中的 available

返回：

可以不受阻塞地从此文件输入流中读取的字节数。

抛出：

IOException - 如果发生 I/O 错误。