前言
Github:https://github.com/yihonglei/jdk-source-code-reading(java-io)
概述
InputStream类是Java IO API中所有输入流的基类。
一 InputStream 实例
根据File指定构建文件,通过FileInputStream将文件构建为输入流,FileInputStream 为 InputStream 的子类,
所以,可以将 FileInputStream 赋值给 InputStream。然后通过 InputStream 的 read(byte b[]) 方法从输入流中读取字节放入缓冲字节数组中,
最后将缓冲字节数组转换为字符串打印到控制台。
package com.jpeony.io.inputstream;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
/**
* 读取基于字节的数据:
* 构建文件流,从输入流中读取字节数据存储到缓冲字节数组中,然后将缓冲字节数组转换成字符串打印到控制台
* FileInputStream是InputStream的子类,所以可以把FileInputStream赋值给InputStream。
* 这里使用"try-with-resources"来关闭流,也即当退出try语句块的时候,InputStream流会关闭。
*
* @author yihonglei
*/
public class FileInputStream2 {
public static void main(String[] args) {
// 指定构造文件
File file = new File("C:\\mycode\\hello.txt");
// 将文件构建为输入流
try (InputStream is = new FileInputStream(file)) {
// 创建字节数组
byte[] data = new byte[1024];
// 从文件流中读取数据,存储到缓冲字节数组
is.read(data);
// 输出文件内容
System.out.println("文件内容:" + new String(data));
} catch (IOException e) {
e.printStackTrace();
}
}
}
二 InputStream 的 read 方法
InputStream 通过 read() 方法从流内读取字节内容,包含三个重载方法:
从输入流中读取字节, 并返回流的字节长度:
public abstract int read() throws IOException;
package com.jpeony.io.inputstream;
import java.io.File;
import java.io.FileInputStream;
import java.io.InputStream;
public class FileInputStream1 {
public static void main(String[] args) {
// 指定构建文件
File file = new File("C:\\mycode\\hello.txt");
// 将文件构建为输入流
try (InputStream is = new FileInputStream(file)) {
StringBuilder sb = new StringBuilder();
// 读取第一个字节
int data = is.read();
// 判断是否是末尾流
while (data != -1) {
sb.append((char)data);
// 读取下一个字节
data = is.read();
}
// 输出到控制台
System.out.println("内容:" + sb.toString().getBytes("UTF-8"));
} catch (Exception e) {
e.printStackTrace();
}
}
}
从输入流中读取字节并放入字节数组b中, 并返回流的字节长度:
public int read(byte b[]) throws IOException {
......
}
从输入流中从 offset 位置读取 length 长度的字节放入字节数组b中,并返回流的字节长度:
public int read(byte b[], int off, int len) throws IOException {
......
}
package com.jpeony.io.inputstream;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
public class FileInputStream3 {
public static void main(String[] args) {
// 构建输入流
File file = new File("C:\\mycode\\hello.txt");
try (InputStream is = new FileInputStream(file)) {
// 创建字节数组
byte[] data = new byte[1024];
// 指定索引起始位置到结束位置读取流放入字节数组中
is.read(data, 0, data.length);
// 打印文件内容
System.out.println("内容:" + new String(data));
} catch (IOException e) {
e.printStackTrace();
}
}
}
小结
InputStream 包含了2个从 InputStream 中读取数据并将数据存储到缓冲数组中的 read() 方法。
int read(byte[])
int read(byte, int offset, int length)
一次性读取一个字节数组的方式,比一次性读取一个字节的方式快的多,所以,尽可能使用这两个方法代替read()方法。
read(byte[])
会尝试读取与给定字节数组容量一样大的字节数,返回值说明已经读取过的字节数。如果InputStream内可读的数据
不足以填满字节数组,那么数组剩余的部分将包含本次读取之前的数据。记得检查有多少数据实际被写入到了字节数组中。
read(byte, int offset, int length)
同样将数据读取到字节数组中,不同的是,该方法从数组的offset位置开始,并且最多将length个字节写
入到数组中。同样地,read(byte, int offset, int length)方法返回一个int变量,告诉你已经有多少字节已经被写入到字节数组中,
所以请记得在读取数据前检查上一次调用read(byte, int offset, int length)的返回值。这两个方法都会在读取到达到流末尾时返回-1。
InputStream有很多子类,子类中有很多替代read的方法。
比如:DataInputStream 的 readBoolean(), readShort() 等方法获取
java基本类型变量boolean,short,int,long,char,byte,double,float。
后续详细分析DataInputStream类。
三 流末尾
如果 read() 方法返回-1,意味着程序已经读到了流的末尾,此时流内已经没有多余的数据可供读取了。
-1 是一个 int 类型,不是 byte 或者 char 类型,从 read 方法的返回值可以知道返回 int。当达到流末尾时,你就可以关闭流了。