Java DataInputStream[编辑 | 编辑源代码]

DataInputStream是Java I/O体系中一个重要的二进制数据读取类，它属于java.io包，允许以与机器无关的方式从底层输入流中读取原始Java数据类型（如int、float、double等）。它是装饰器模式的典型应用，需要包装其他InputStream实现类使用。

核心特性[编辑 | 编辑源代码]

支持读取Java基本数据类型（readInt(), readDouble()等）
采用大端字节序（Big-Endian）读取数据
实现DataInput接口
线程不安全（需外部同步）
读取方法会阻塞直至数据可用

类继承关系[编辑 | 编辑源代码]

基础用法[编辑 | 编辑源代码]

构造方法[编辑 | 编辑源代码]

DataInputStream必须包装现有的输入流：

// 示例：包装FileInputStream
FileInputStream fis = new FileInputStream("data.bin");
DataInputStream dis = new DataInputStream(fis);

主要方法[编辑 | 编辑源代码]

方法签名	返回类型	说明
`readBoolean()`	boolean	读取1字节布尔值
`readByte()`	byte	读取1字节
`readShort()`	short	读取2字节（大端序）
`readInt()`	int	读取4字节（大端序）
`readLong()`	long	读取8字节（大端序）
`readFloat()`	float	读取4字节IEEE 754浮点数
`readDouble()`	double	读取8字节IEEE 754浮点数
`readUTF()`	String	读取UTF-8编码字符串

代码示例[编辑 | 编辑源代码]

基础数据读取[编辑 | 编辑源代码]

try (DataInputStream dis = new DataInputStream(
    new FileInputStream("data.dat"))) {
    
    boolean flag = dis.readBoolean();  // 读取1字节布尔值
    int count = dis.readInt();         // 读取4字节整数
    double price = dis.readDouble();   // 读取8字节浮点数
    String desc = dis.readUTF();       // 读取UTF字符串
    
    System.out.printf("Flag: %b, Count: %d, Price: %.2f, Desc: %s%n",
        flag, count, price, desc);
} catch (IOException e) {
    e.printStackTrace();
}

假设data.dat由DataOutputStream写入以下内容：

true 42 3.1415 "Java数据流"

输出结果：

Flag: true, Count: 42, Price: 3.14, Desc: Java数据流

读取字节数组[编辑 | 编辑源代码]

// 先读取长度，再读取实际数据
int length = dis.readInt();
byte[] buffer = new byte[length];
dis.readFully(buffer);  // 确保读取完整数据

高级特性[编辑 | 编辑源代码]

字节序处理[编辑 | 编辑源代码]

DataInputStream始终使用大端序（Big-Endian）读取数据。如果需要处理小端序数据，可通过ByteBuffer转换：

int littleEndianInt = ByteBuffer.wrap(bytes)
    .order(ByteOrder.LITTLE_ENDIAN)
    .getInt();

性能优化[编辑 | 编辑源代码]

对于高频读取操作，建议添加缓冲层：

DataInputStream dis = new DataInputStream(
    new BufferedInputStream(
        new FileInputStream("large.dat")));

异常处理[编辑 | 编辑源代码]

读取时可能抛出EOFException（文件结尾）或UTFDataFormatException（UTF字符串格式错误）。推荐使用try-with-resources确保资源释放。

实际应用案例[编辑 | 编辑源代码]

场景：网络协议解析[编辑 | 编辑源代码]

假设需要解析自定义二进制协议：

对应代码实现：

public ProtocolPacket parsePacket(InputStream in) throws IOException {
    DataInputStream dis = new DataInputStream(in);
    
    int magicNumber = dis.readInt();     // 协议标识
    if (magicNumber != 0xCAFEBABE) {
        throw new ProtocolException("Invalid magic number");
    }
    
    byte version = dis.readByte();      // 协议版本
    int payloadLength = dis.readInt();   // 数据长度
    byte[] payload = new byte[payloadLength];
    dis.readFully(payload);             // 读取完整负载
    
    return new ProtocolPacket(version, payload);
}

注意事项[编辑 | 编辑源代码]

读取顺序必须与写入顺序严格一致
字符串处理推荐使用readUTF()而非readChar()
读取方法会阻塞线程直至数据可用
不直接支持随机访问（需结合RandomAccessFile）
大文件处理时注意内存限制

数学原理[编辑 | 编辑源代码]

DataInputStream处理浮点数时遵循IEEE 754标准。以readDouble()为例：

读取的8字节转换为double的过程为： $value = (- 1)^{sign} \times 2^{exponent - 1023} \times (1 + \sum_{i = 1}^{52} \frac{{bit}_{52 - i}}{2^{i}})$

其中：

第1位：符号位（0正1负）
2-12位：指数部分（偏移1023）
13-64位：尾数部分

常见问题[编辑 | 编辑源代码]

Q: 如何判断是否到达文件末尾？[编辑 | 编辑源代码]

使用available()方法（返回0表示可能到达结尾），但更可靠的方式是捕获EOFException。

Q: 为什么读取的数据与写入的不一致？[编辑 | 编辑源代码]

常见原因包括： 1. 字节序不匹配 2. 读取/写入顺序不一致 3. 未使用相同的编码方式（特别是字符串）

Q: 如何处理自定义数据结构？[编辑 | 编辑源代码]

推荐方案：

public record Person(String name, int age) {}

Person readPerson(DataInputStream dis) throws IOException {
    String name = dis.readUTF();
    int age = dis.readInt();
    return new Person(name, age);
}

页面模块:Message box/ambox.css没有内容。

总结[编辑 | 编辑源代码]

DataInputStream是Java二进制数据读取的核心类，其特点包括：

类型安全的原始数据类型读取
与DataOutputStream完美配对
适合协议解析和持久化存储
需严格保持读写顺序一致性

对于现代Java开发，也可考虑java.nio包中的ByteBuffer作为替代方案，特别是在需要高性能或灵活字节序处理的场景。