fast-compress-cj 实战手册Snappy 类全 API 详解从字符串到多类型数组全覆盖【免费下载链接】fast-compress-cj一个快速的压缩/解压缩库项目地址: https://gitcode.com/Cangjie-TPC/fast-compress-cjfast-compress-cj 是谷歌 Snappy 压缩算法的仓颉Cangjie移植版一个开箱即用的高速压缩/解压缩库。它把 C 原生压缩能力封装成了纯仓颉友好的静态 API让你用一行代码就能压缩 String、Int32、Float64 等各类数据并提供完整的流式与帧式压缩方案非常适合日志归档、消息队列、大数据缓存等对速度敏感的场景。为什么选择 Snappy 压缩 压缩算法的选择通常要在压缩率和速度之间做取舍对比维度Snappy 表现适用场景压缩/解压速度⚡ 极快接近内存拷贝速度网络传输、缓存层压缩率中等略逊于 gzip对体积不极敏感的数据实现复杂度低API 极简快速集成跨语言兼容与 C/Java 生态互通混合架构项目一句话总结用一点点压缩率换极大的吞吐速度。三步跑起来环境准备与快速验证1. 编译原生依赖库底层依赖 snappy 1.1.10 与 bitshuffle 0.3.4 两个 C 库克隆到仓库根目录后执行编译脚本即可Windows 同理用 build_win.bat./build_linux.sh完整步骤见 build_linux.sh 与 README.md 的编译章节。2. 在 cjpm 中引入项目包名为snappy4cj见 cjpm.toml依赖 charset4cj 提供字符编码支持[dependencies] charset4cj {branch v1.0.0, git https://gitcode.com/Cangjie-TPC/charset4cj.git}3. 三十秒压缩一个字符串最小可用示例来自 test/DOC/example01.cjimport snappy4cj.* let input: ArrayUInt8 snappy test.toArray() let output Snappy.rawCompress(input, UIntNative(input.size)) let m2 String.fromUtf8(Snappy.uncompress(output))Snappy 类一站式压缩 API 全景核心类Snappysrc/snappy.cj全部是静态方法无需实例化。官方完整接口清单见 doc/feature_api.md。一行压缩compress() 支持的输入类型compress是最常用的入口通过参数类型自动选择实现输入类型说明String默认按 UTF-8 编码String encoding支持指定编码字符串或 Charset 对象ArrayUInt8/ 带偏移长度原始字节可做局部压缩ArrayRune字符数组ArrayInt16/Int32/Int64整型数组ArrayFloat32/Float64浮点数组定义位置见 src/snappy.cj#L46-L184。零拷贝进阶rawCompress() 与精确写入如果不想额外分配输出数组可以用带偏移参数的版本直接写入预分配缓冲区返回实际压缩后的字节数// 从 input[inputOffset] 开始压缩 inputLength 字节 // 结果写入 output[outputOffset] 起的位置 public static func rawCompress(input: ArrayByte, inputOffset: UIntNative, inputLength: UIntNative, output: ArrayUInt8, outputOffset: UIntNative): Int64各类型重载见 src/snappy.cj#L258-L327。压缩前必做长度预估与合法性校验maxCompressedLength(byteSize)预分配输出缓冲区前先算出压缩后的最大可能长度避免缓冲区溢出src/snappy.cj#L247uncompressedLength(input)不解压就得知原始数据长度isValidCompressedBuffer(input)校验缓冲区是否为合法 Snappy 数据处理不可信来源时必加src/snappy.cj#L226按类型解压uncompress* 系列 API 速查压缩产物统一是ArrayUInt8解压时按业务需要的类型选择对应方法API返回类型典型用途uncompressArrayUInt8原始字节uncompressStringString文本/日志支持指定编码uncompressCharArrayArrayRune字符序列uncompressShortArrayArrayInt1616 位整型uncompressIntArrayArrayInt3232 位整型uncompressLongArrayArrayInt6464 位整型uncompressFloatArrayArrayFloat32单精度浮点uncompressDoubleArrayArrayFloat64双精度浮点以上每个方法都提供整段和指定 offset/length 局部解压两种重载行号区间见 src/snappy.cj#L363-L702。选型建议内存敏感场景用整段 API大文件中只取片段时用 offset/length 重载避免全量解压。流式压缩SnappyOutputStream 与 SnappyInputStream数据大到放不进内存时改用流式方案SnappyOutputStreamsrc/snappy_output_stream.cj包装任意OutputStream构造时可指定块大小blockSize及缓存分配器工厂write支持ArrayUInt8、ArrayFloat32/Float64、ArrayInt16/Int32/Int64等多种类型直接写入写完记得close()刷新尾部块。SnappyInputStreamsrc/snappy_input_stream.cj对称的读取端read同样支持上述全部类型数组还支持rawRead按字节偏移精确定位、available()查询剩余数据量。完整示例见 test/DOC/example02.cj——写、关、读、断言一气呵成。帧式流自带 CRC 校验的 SnappyFramed 系列帧Framed格式是 Snappy 生态的标准信封适合跨系统传输和文件持久化SnappyFramedOutputStreamsrc/snappy_framed_output_stream.cj#L45-L57可配置块大小、最小压缩比和缓冲池除了常规write还提供transferFrom支持直接从输入流/ByteBuffer 搬运数据。SnappyFramedInputStreamsrc/snappy_framed_input_stream.cj#L38-L50构造时传入verifyChecksums: Bool即可开启CRC32C 校验防数据损坏这是普通流没有的安全能力transferTo可整体搬运到目标 ByteBuffer。完整示例见 test/DOC/example03.cj。BitShuffle数值数组的压缩率增强器 对数值数组尤其整型直接 Snappy 压缩效果往往不理想——把每个数的高位字节和低位字节交错重排后再压缩压缩率显著提升。BitShufflesrc/bit_shuffle.cj提供成对 APIshuffle(Int16/Int32/Int64/Float32/Float64 数组)按BitShuffleType重排字节返回ArrayUInt8unshuffleShortArray/IntArray/LongArray/FloatArray/DoubleArray精确还原典型链路shuffle → Snappy.compress → 传输 → Snappy.uncompress → unshuffle适合时序数据、数值日志等场景。类型枚举定义见 src/bit_shuffle_type.cj。异常处理与错误码所有可预期失败都以异常形式抛出便于精确定位SnappyError/SnappyIOException携带SnappyErrorCode错误枚举与消息见 src/snappy_error.cj、src/snappy_i_o_exception.cjSnappyErrorCodesrc/snappy_error_code.cj涵盖本地库加载失败、解析错误、内存溢出、空输入、版本不适配等 11 种错误还提供getErrorMessage(id)反查错误描述。推荐写法捕获SnappyError后通过getErrorCode()分支处理而不是笼统吞掉异常。核心文件导航模块路径作用核心 APIsrc/snappy.cj压缩/解压全部静态方法流式输出src/snappy_output_stream.cj边写边压流式输入src/snappy_input_stream.cj边读边解压帧式输出src/snappy_framed_output_stream.cj带块头与校验帧式输入src/snappy_framed_input_stream.cj支持 CRC 校验字节重排src/bit_shuffle.cj数值数组预压缩错误定义src/snappy_error_code.cj11 种错误码API 文档doc/feature_api.md全量接口参考示例代码test/DOC/三个可运行示例写在最后fast-compress-cj 的 API 设计非常直给小数据→Snappy.compress/Snappy.uncompress*一对方法搞定9 种输入类型全覆盖大数据→ 换SnappyOutputStream/SnappyInputStream流式处理跨系统/需防篡改→ 用SnappyFramed帧式流开启 CRC 校验数值数组追求更高压缩率→ 先过一道BitShuffle。配合 CHANGELOG.md 跟踪版本变更按需选择 API 组合基本能覆盖从字符串日志到浮点矩阵的全部压缩需求。【免费下载链接】fast-compress-cj一个快速的压缩/解压缩库项目地址: https://gitcode.com/Cangjie-TPC/fast-compress-cj创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 fast-compress-cj 实战手册：Snappy 类全 API 详解，从字符串到多类型数组全覆盖
fast-compress-cj 实战手册Snappy 类全 API 详解从字符串到多类型数组全覆盖【免费下载链接】fast-compress-cj一个快速的压缩/解压缩库项目地址: https://gitcode.com/Cangjie-TPC/fast-compress-cjfast-compress-cj 是谷歌 Snappy 压缩算法的仓颉Cangjie移植版一个开箱即用的高速压缩/解压缩库。它把 C 原生压缩能力封装成了纯仓颉友好的静态 API让你用一行代码就能压缩 String、Int32、Float64 等各类数据并提供完整的流式与帧式压缩方案非常适合日志归档、消息队列、大数据缓存等对速度敏感的场景。为什么选择 Snappy 压缩 压缩算法的选择通常要在压缩率和速度之间做取舍对比维度Snappy 表现适用场景压缩/解压速度⚡ 极快接近内存拷贝速度网络传输、缓存层压缩率中等略逊于 gzip对体积不极敏感的数据实现复杂度低API 极简快速集成跨语言兼容与 C/Java 生态互通混合架构项目一句话总结用一点点压缩率换极大的吞吐速度。三步跑起来环境准备与快速验证1. 编译原生依赖库底层依赖 snappy 1.1.10 与 bitshuffle 0.3.4 两个 C 库克隆到仓库根目录后执行编译脚本即可Windows 同理用 build_win.bat./build_linux.sh完整步骤见 build_linux.sh 与 README.md 的编译章节。2. 在 cjpm 中引入项目包名为snappy4cj见 cjpm.toml依赖 charset4cj 提供字符编码支持[dependencies] charset4cj {branch v1.0.0, git https://gitcode.com/Cangjie-TPC/charset4cj.git}3. 三十秒压缩一个字符串最小可用示例来自 test/DOC/example01.cjimport snappy4cj.* let input: ArrayUInt8 snappy test.toArray() let output Snappy.rawCompress(input, UIntNative(input.size)) let m2 String.fromUtf8(Snappy.uncompress(output))Snappy 类一站式压缩 API 全景核心类Snappysrc/snappy.cj全部是静态方法无需实例化。官方完整接口清单见 doc/feature_api.md。一行压缩compress() 支持的输入类型compress是最常用的入口通过参数类型自动选择实现输入类型说明String默认按 UTF-8 编码String encoding支持指定编码字符串或 Charset 对象ArrayUInt8/ 带偏移长度原始字节可做局部压缩ArrayRune字符数组ArrayInt16/Int32/Int64整型数组ArrayFloat32/Float64浮点数组定义位置见 src/snappy.cj#L46-L184。零拷贝进阶rawCompress() 与精确写入如果不想额外分配输出数组可以用带偏移参数的版本直接写入预分配缓冲区返回实际压缩后的字节数// 从 input[inputOffset] 开始压缩 inputLength 字节 // 结果写入 output[outputOffset] 起的位置 public static func rawCompress(input: ArrayByte, inputOffset: UIntNative, inputLength: UIntNative, output: ArrayUInt8, outputOffset: UIntNative): Int64各类型重载见 src/snappy.cj#L258-L327。压缩前必做长度预估与合法性校验maxCompressedLength(byteSize)预分配输出缓冲区前先算出压缩后的最大可能长度避免缓冲区溢出src/snappy.cj#L247uncompressedLength(input)不解压就得知原始数据长度isValidCompressedBuffer(input)校验缓冲区是否为合法 Snappy 数据处理不可信来源时必加src/snappy.cj#L226按类型解压uncompress* 系列 API 速查压缩产物统一是ArrayUInt8解压时按业务需要的类型选择对应方法API返回类型典型用途uncompressArrayUInt8原始字节uncompressStringString文本/日志支持指定编码uncompressCharArrayArrayRune字符序列uncompressShortArrayArrayInt1616 位整型uncompressIntArrayArrayInt3232 位整型uncompressLongArrayArrayInt6464 位整型uncompressFloatArrayArrayFloat32单精度浮点uncompressDoubleArrayArrayFloat64双精度浮点以上每个方法都提供整段和指定 offset/length 局部解压两种重载行号区间见 src/snappy.cj#L363-L702。选型建议内存敏感场景用整段 API大文件中只取片段时用 offset/length 重载避免全量解压。流式压缩SnappyOutputStream 与 SnappyInputStream数据大到放不进内存时改用流式方案SnappyOutputStreamsrc/snappy_output_stream.cj包装任意OutputStream构造时可指定块大小blockSize及缓存分配器工厂write支持ArrayUInt8、ArrayFloat32/Float64、ArrayInt16/Int32/Int64等多种类型直接写入写完记得close()刷新尾部块。SnappyInputStreamsrc/snappy_input_stream.cj对称的读取端read同样支持上述全部类型数组还支持rawRead按字节偏移精确定位、available()查询剩余数据量。完整示例见 test/DOC/example02.cj——写、关、读、断言一气呵成。帧式流自带 CRC 校验的 SnappyFramed 系列帧Framed格式是 Snappy 生态的标准信封适合跨系统传输和文件持久化SnappyFramedOutputStreamsrc/snappy_framed_output_stream.cj#L45-L57可配置块大小、最小压缩比和缓冲池除了常规write还提供transferFrom支持直接从输入流/ByteBuffer 搬运数据。SnappyFramedInputStreamsrc/snappy_framed_input_stream.cj#L38-L50构造时传入verifyChecksums: Bool即可开启CRC32C 校验防数据损坏这是普通流没有的安全能力transferTo可整体搬运到目标 ByteBuffer。完整示例见 test/DOC/example03.cj。BitShuffle数值数组的压缩率增强器 对数值数组尤其整型直接 Snappy 压缩效果往往不理想——把每个数的高位字节和低位字节交错重排后再压缩压缩率显著提升。BitShufflesrc/bit_shuffle.cj提供成对 APIshuffle(Int16/Int32/Int64/Float32/Float64 数组)按BitShuffleType重排字节返回ArrayUInt8unshuffleShortArray/IntArray/LongArray/FloatArray/DoubleArray精确还原典型链路shuffle → Snappy.compress → 传输 → Snappy.uncompress → unshuffle适合时序数据、数值日志等场景。类型枚举定义见 src/bit_shuffle_type.cj。异常处理与错误码所有可预期失败都以异常形式抛出便于精确定位SnappyError/SnappyIOException携带SnappyErrorCode错误枚举与消息见 src/snappy_error.cj、src/snappy_i_o_exception.cjSnappyErrorCodesrc/snappy_error_code.cj涵盖本地库加载失败、解析错误、内存溢出、空输入、版本不适配等 11 种错误还提供getErrorMessage(id)反查错误描述。推荐写法捕获SnappyError后通过getErrorCode()分支处理而不是笼统吞掉异常。核心文件导航模块路径作用核心 APIsrc/snappy.cj压缩/解压全部静态方法流式输出src/snappy_output_stream.cj边写边压流式输入src/snappy_input_stream.cj边读边解压帧式输出src/snappy_framed_output_stream.cj带块头与校验帧式输入src/snappy_framed_input_stream.cj支持 CRC 校验字节重排src/bit_shuffle.cj数值数组预压缩错误定义src/snappy_error_code.cj11 种错误码API 文档doc/feature_api.md全量接口参考示例代码test/DOC/三个可运行示例写在最后fast-compress-cj 的 API 设计非常直给小数据→Snappy.compress/Snappy.uncompress*一对方法搞定9 种输入类型全覆盖大数据→ 换SnappyOutputStream/SnappyInputStream流式处理跨系统/需防篡改→ 用SnappyFramed帧式流开启 CRC 校验数值数组追求更高压缩率→ 先过一道BitShuffle。配合 CHANGELOG.md 跟踪版本变更按需选择 API 组合基本能覆盖从字符串日志到浮点矩阵的全部压缩需求。【免费下载链接】fast-compress-cj一个快速的压缩/解压缩库项目地址: https://gitcode.com/Cangjie-TPC/fast-compress-cj创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考