爪哇

Java 的 XZ

介绍

XZ for Java 旨在成为纯 Java 中 XZ 数据压缩的完整实现。

特征：

• 完全支持 .xz 文件格式规范版本 1.2.1
• 单线程流式压缩和解压
• 具有有限随机访问支持的单线程解压缩
• 供高级用户使用的原始流（无 .xz 标头），包括带有预设字典的 LZMA2

线程化已在计划中，但尚不清楚何时实施。

主要源代码与 Java 8 及更高版本兼容，但也有适用于 Java 9 或更高版本的类（module-info.java 和速度优化）。默认构建选项需要 OpenJDK 11 或更高版本，并创建 Java 8 兼容的二进制文件。

使用 Apache Ant 构建

所有输出文件都进入build目录。

• 键入ant来编译类并创建 JAR 文件。
• 输入ant doc以构建 javadoc HTML 文档。
• 输入ant -projecthelp查看所有可用的目标。

可重复的构建

可重复的构建应该是可能的。需要指定一个时间戳，该时间戳将用于 JAR 元数据中的文件修改时间。时间戳使用本地时区存储，因此最好将其覆盖为 GMT/UTC。在 POSIX 系统上，以下命令是等效的：

 $ ANT_OPTS=-Duser.timezone=GMT 
      ant -Dant.tstamp.now.iso=2024-07-29T14:10:26Z

$ SOURCE_DATE_EPOCH=1722262226 TZ=UTC0 ant

当 Git 存储库可用时，使用提交者日期是获取合理值的一种方法：

 $ SOURCE_DATE_EPOCH=$(git log -n1 --pretty=%ct) TZ=UTC0 ant

旧的构建环境

• 如果您使用的 Ant 版本早于 1.10.2：

  编辑build.xml并从元素中删除modificationtime="${timestamp}"属性。

• 如果您使用的 Ant 版本早于 1.9.8：

  编辑build.xml并从标记中删除发布属性，即删除所有出现的这两行：

   release="${sourcever}"
  
  release="${sourcever9}"
  

  上述的缺点是，将使用-source和-target选项而不是--release 。

• 如果您使用的 OpenJDK 版本早于 9：

  要使用 OpenJDK 8 进行构建，请在ant命令行上使用-Djava8only=true 。那么需要 Java >= 9 的文件将不会被构建，并且xz.jar将不会是模块化 JAR。

• 如果您使用的 OpenJDK 版本早于 8：

  不再支持这些版本。尝试 XZ for Java 1.9，它与 Java 5 兼容，只需要编辑build.properties即可构建。

不使用 Apache Ant 进行构建

如果您不能或不想使用 Ant，只需编译src目录下的所有 .java 文件（可能会跳过演示文件src/*.java ）。为了模块支持和速度优化 (Java >= 9)，还编译src9目录下的所有 .java 文件。

演示程序

您可以使用 XZEncDemo 测试压缩，它从标准输入压缩到标准输出：

 java -jar build/jar/XZEncDemo.jar < foo.txt > foo.txt.xz

您可以使用 XZDecDemo 测试解压，它解压到标准输出：

 java -jar build/jar/XZDecDemo.jar foo.txt.xz

联系信息

• 主页：https://tukaani.org/xz/java.html
• 电子邮件：莱塞·柯林 [email protected]
• IRC：Larhzu 在 Libera 聊天中关注 #tukaani
• GitHub：https://github.com/tukaani-project/xz-java