爪哇

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