36. クラスパスと JAR

は、が必要になると(探しに行く場所の一覧)からを探します。場所に指定するのはディレクトリかです。JAR は .class をまとめた zip で、先頭のバイトも zip と同じです。中のに入口のクラス名()を書いておくと、で起動できます。

前のレッスンまでに見た Rust の Hello は実行ファイル1つでしたが、Java では自分の JAR との JAR が別々のファイルのまま、実行時にクラスパスで結び付きます。足りない JAR があると、実測では起動時ではなく、そのクラスを初めて使う行でになりました。java -jar で起動するとの指定が無視される点にも注意が要ります。

では依存の JAR を自分の JAR の中に入れて1ファイルにできるかというと、標準のままでは読めませんでした。中に greet.jar を入れた JAR を java -jar で起動すると同じエラーになり、のに書いても変わりません。隣に本物のファイルとして置けば動きます。のがこの点をどうしているかは、後のレッスンで扱います。

点線の付いた語はタップすると説明が出ます。用語集を開く →

クラスパスからクラスを探す(JDK 25 の実測)

java -cp app.jar:greet.jar app.Main探す場所を : で区切って並べる(Windows では ;)

クラスが必要になるたび

アプリケーションクラスローダクラスパスの場所から .class を探す

探す場所

app.jarapp/Main.class

greet.jargreet/Greeter.class

JAR の中の JARlib/greet.jar は探されなかった

・java マニュアルは -jar について「other class path settings are ignored」と書いています。-jar と -cp を併用しても -cp 側は使われません
・マニフェストの Class-Path に書いた相対パスは、JAR の外のファイルとして探されました(隣に greet.jar を置くと成功、JAR の中に入れると失敗)
・入れ子の JAR を読めないと JAR の仕様が直接書いているわけではありません。JDK 25 の標準のローダで試した結果です

▶ サンプルコードを実行してみよう(自由に書き換えてOK)

Java

import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.InputStream;
import java.util.jar.Attributes;
import java.util.jar.JarEntry;
import java.util.jar.JarOutputStream;
import java.util.jar.Manifest;
import java.util.zip.ZipEntry;
import java.util.zip.ZipInputStream;

class Main {
    public static void main(String[] args) throws Exception {
        // マニフェスト = JAR に添える説明書き。入口のクラス名をここに書く
        Manifest mf = new Manifest();
        mf.getMainAttributes().put(Attributes.Name.MANIFEST_VERSION, "1.0");
        mf.getMainAttributes().put(Attributes.Name.MAIN_CLASS, "Main");

        // メモリ上に JAR を作り、いま動いている Main.class を1つ入れる
        ByteArrayOutputStream buf = new ByteArrayOutputStream();
        try (JarOutputStream jar = new JarOutputStream(buf, mf);
             InputStream self = Main.class.getResourceAsStream("Main.class")) {
            jar.putNextEntry(new JarEntry("Main.class"));
            jar.write(self.readAllBytes());
            jar.closeEntry();
        }
        byte[] b = buf.toByteArray();
        System.out.printf("first 4 bytes: %02X %02X %02X %02X%n", b[0], b[1], b[2], b[3]);

        // 同じバイト列を、JAR ではなく「ただの zip」として読んでみる
        try (ZipInputStream zip = new ZipInputStream(new ByteArrayInputStream(b))) {
            for (ZipEntry e; (e = zip.getNextEntry()) != null; ) {
                System.out.println("entry: " + e.getName());
                if (e.getName().equals("META-INF/MANIFEST.MF")) {
                    for (String line : new String(zip.readAllBytes()).split("\r\n")) {
                        System.out.println("  | " + line);
                    }
                }
            }
        }
    }
}

import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.InputStream;
import java.util.jar.Attributes;
import java.util.jar.JarEntry;
import java.util.jar.JarOutputStream;
import java.util.jar.Manifest;
import java.util.zip.ZipEntry;
import java.util.zip.ZipInputStream;

class Main {
    public static void main(String[] args) throws Exception {
        // マニフェスト = JAR に添える説明書き。入口のクラス名をここに書く
        Manifest mf = new Manifest();
        mf.getMainAttributes().put(Attributes.Name.MANIFEST_VERSION, "1.0");
        mf.getMainAttributes().put(Attributes.Name.MAIN_CLASS, "Main");

// メモリ上に JAR を作り、いま動いている Main.class を1つ入れる
        ByteArrayOutputStream buf = new ByteArrayOutputStream();
        try (JarOutputStream jar = new JarOutputStream(buf, mf);
             InputStream self = Main.class.getResourceAsStream("Main.class")) {
            jar.putNextEntry(new JarEntry("Main.class"));
            jar.write(self.readAllBytes());
            jar.closeEntry();
        }
        byte[] b = buf.toByteArray();
        System.out.printf("first 4 bytes: %02X %02X %02X %02X%n", b[0], b[1], b[2], b[3]);

// 同じバイト列を、JAR ではなく「ただの zip」として読んでみる
        try (ZipInputStream zip = new ZipInputStream(new ByteArrayInputStream(b))) {
            for (ZipEntry e; (e = zip.getNextEntry()) != null; ) {
                System.out.println("entry: " + e.getName());
                if (e.getName().equals("META-INF/MANIFEST.MF")) {
                    for (String line : new String(zip.readAllBytes()).split("\r\n")) {
                        System.out.println("  | " + line);
                    }
                }
            }
        }
    }
}

図やコードに出てくる用語(タップで説明)

サンプルコードで身につける(5本) →

学んだ概念を、素朴な例から実務寄りの例まで5つの具体例で確認します。

公式ドキュメントで詳しく ↗