如何使用Java读取二进制.Chn格式文件

前置准备 #

• 先从官方读取规则里提取完整的字段定义：包括每个字段的字节长度、字节序（大端/小端）、数据类型（无符号整数、字符串、浮点数等），这两项信息是保证解析不出错的核心
• 建议先读取前几个固定长度的头部字段做校验，比如如果文件头有固定魔数，先校验魔数判断是否为合法的.chn文件，避免解析无效文件报错

核心实现代码示例 #

使用Java NIO的ByteBuffer可以更方便的处理字节序，无需手动拼接字节：

import java.io.FileInputStream;
import java.io.IOException;
import java.nio.ByteBuffer;
import java.nio.ByteOrder;
import java.nio.channels.FileChannel;

public class ChnFileReader {
    // 按需替换为官方规则中的对应参数，此处为示例值
    private static final int MAGIC_NUMBER_LENGTH = 4;
    private static final int FILE_VERSION_LENGTH = 2;
    // 字节序根据官方规则调整，多数厂商二进制文件默认使用小端序
    private static final ByteOrder DEFAULT_ORDER = ByteOrder.LITTLE_ENDIAN;

    public void readChnFile(String filePath) throws IOException {
        try (FileInputStream fis = new FileInputStream(filePath);
             FileChannel channel = fis.getChannel()) {
            // 小文件可以直接全量映射，大文件可以按块分段读取
            ByteBuffer buffer = channel.map(FileChannel.MapMode.READ_ONLY, 0, channel.size());
            buffer.order(DEFAULT_ORDER);

            // 1. 读取文件魔数校验示例
            byte[] magic = new byte[MAGIC_NUMBER_LENGTH];
            buffer.get(magic);
            // 此处可加校验逻辑：如果magic和规则约定的固定值不匹配，直接抛出非法文件异常

            // 2. 读取2字节版本号示例（无符号短整型）
            int version = Short.toUnsignedInt(buffer.getShort());

            // 3. 后续按规则的字段顺序依次读取即可，不同类型对应读取方法参考：
            // - 1字节无符号整数：Byte.toUnsignedInt(buffer.get())
            // - 4字节有符号整数：buffer.getInt()
            // - 4字节浮点数：buffer.getFloat()
            // - 固定长度字符串：先读取对应长度的byte数组，再用规则指定的字符集（GBK/UTF-8等）解码
        }
    }

    public static void main(String[] args) throws IOException {
        new ChnFileReader().readChnFile("替换为你的.chn文件路径");
    }
}

常见问题排查 #

如果解析出来的数值异常，优先检查以下几点：

• 字节序配置错误：如果读出来的数值明显不符合常理，先切换ByteOrder.BIG_ENDIAN测试
• 无符号数处理错误：Java基础类型默认都是有符号的，读取无符号数值时必须调用toUnsignedInt/toUnsignedLong等方法转换
• 字符串编码错误：如果读取的字符串出现乱码，依次尝试GBK、GB2312、UTF-8等常见编码解码

内容的提问来源于stack exchange，提问作者LAHCEN