InputStream

一、基础概念

在 Java 的 I/O 流体系中，InputStream 类位于 java.io 包下，是所有字节输入流的超类。

二、read() 方法

调用任何read()方法后，读到的数据会从stream中流出，不再保存在stream中。

InputStream.read() 方法主要有以下几种形式：

1. int read()

   • 描述：从输入流中读取下一个字节的数据。如果到达流的末尾，则返回 -1。
   • 返回值：返回读取的字节（0 到 255 之间的整数），如果已到达流的末尾，则返回 -1。
   • 抛出异常：可能会抛出 IOException 异常，表示发生 I/O 错误。

2. int read(byte[] b)

   • 描述：从输入流中读取最多 b.length 个字节的数据，并将其存储在提供的字节数组 b 中。实际读取的字节数将作为返回值返回；如果因为已经到达流的末尾而不能再读取更多字节，则返回 -1。
   • 参数：byte[] b - 存储读取数据的缓冲区。
   • 返回值：返回读取的字节数（0 到 b.length 之间），如果已经到达流的末尾，则返回 -1。
   • 抛出异常：可能会抛出 NullPointerException（如果 b 为 null）、IndexOutOfBoundsException（如果 b.offset 或 b.count 无效）以及 IOException 异常。

3. int read(byte[] b, int off, int len)

   • 描述：尝试从输入流中读取最多 len 个字节的数据，并将这些数据存储到指定的字节数组 b 中，在b中从偏移量 off 开始存储。实际读取的字节数将作为返回值返回；如果因为已经到达流的末尾而不能再读取更多字节，则返回 -1。
   • 参数：
     • byte[] b - 存储读取数据的目的缓冲区。
     • int off - 从目的缓冲区的哪个位置开始存储数据，是指参数b中的偏移量，而不是在stream中的偏移量。
     • int len - 最多读取多少个字节。
   • 返回值：返回读取的字节数（0 到 len 之间），如果已经到达流的末尾，则返回 -1。
   • 抛出异常：可能会抛出 NullPointerException（如果 b 为 null）、IndexOutOfBoundsException（如果 off、len 或 b.length - off 无效）以及 IOException 异常。

三、注意事项

• 对于网络流或某些类型的文件流，可能需要多次调用 read() 方法才能读取完整的数据内容，因为单次调用可能无法读取所有数据。
• 使用完 InputStream 后，应调用其 close() 方法来释放与该流关联的系统资源。这通常在一个 try-with-resources 语句块中自动完成，或者在使用完流后显式调用 close() 方法。