萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Java 讀取 JAR 檔案內容完整指南:從列舉條目到提取資料流

JAR 檔案基礎概念

JAR (Java Archive) 以 ZIP 格式為基礎,可打包類別檔、圖片、聲音等資源,支援壓縮、簽章、版本資訊。java.util.jar 套件提供 JarFile、JarEntry 等類別,讓程式無需解壓即可直接讀取內部檔案。

核心步驟

  1. 建立 JarFile 實例(傳入檔案路徑或 File 物件)
  2. 呼叫 entries() 取得 Enumeration<JarEntry> 列舉所有條目
  3. 若需讀取檔案內容,對特定 JarEntry 呼叫 getInputStream() 取得輸入串流

範例 1:列出 JAR 內所有檔案與大小

import java.io.*;
import java.util.*;
import java.util.jar.*;

public class JarDir {
    public static void main(String[] args) throws IOException {
        if (args.length != 1) {
            System.out.println("用法: java JarDir ");
            System.exit(-1);
        }
        try (JarFile jarFile = new JarFile(args[0])) {
            Enumeration<JarEntry> entries = jarFile.entries();
            while (entries.hasMoreElements()) {
                JarEntry entry = entries.nextElement();
                System.out.printf("%s %,d %,d%n",
                    entry.getName(), entry.getSize(), entry.getCompressedSize());
            }
        }
    }
}

範例 2:讀取 JAR 內指定文字檔內容

public class JarRead {
    public static void main(String[] args) throws IOException {
        if (args.length != 2) {
            System.out.println("用法: java JarRead  ");
            System.exit(-1);
        }
        try (JarFile jarFile = new JarFile(args[0])) {
            JarEntry entry = jarFile.getJarEntry(args[1]);
            if (entry == null) {
                System.err.println("找不到條目: " + args[1]);
                return;
            }
            try (InputStream is = jarFile.getInputStream(entry);
                 BufferedReader br = new BufferedReader(new InputStreamReader(is))) {
                String line;
                while ((line = br.readLine()) != null) {
                    System.out.println(line);
                }
            }
        }
    }
}

關鍵類別速查表

類別用途
JarFile代表 JAR 檔案本身,提供條目列舉與輸入串流取得
JarEntry代表 JAR 內單一檔案/目錄,含名稱、大小、壓縮大小、CRC32 等屬性
Manifest存取 META-INF/MANIFEST.MF 中的屬性、版本、主類別等資訊

常見陷阱與解法

  • 目錄條目大小為 0:JarEntry.getSize() 回傳 0 表示該條目為目錄,非檔案損毀。
  • 編碼問題:讀取文字檔時建議明確指定 StandardCharsets.UTF_8。
  • 資源洩漏:務必使用 try-with-resources 確保 JarFile 與串流正確關閉。

總結

掌握 JarFile 與 JarEntry 的操作,即可在應用程式中動態載入資源、讀取設定檔、實作外掛機制等,是 Java 開發者的必備技能。

copyright © 萬盛學電腦網 all rights reserved