25. ビルドとは何か: 手作業なら何をするか

import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;

// 「ビルド」の模型: 5つの段が、それぞれ「あるファイル群を読んで、別のファイル群を書く」。
// ファイルシステムは Map で代用し、本物のコマンド(javac、cp、java -jar junit...、jar)は名前だけ書く。
// これは模型であって、Ant/Maven/Gradle の実装ではない。
class Main {
    // パス -> 中身の短い説明
    static final Map<String, String> fs = new LinkedHashMap<>();

    static void step(String title, String command, List<String> reads, Map<String, String> writes) {
        System.out.println("## " + title);
        System.out.println("   $ " + command);
        for (String r : reads) {
            if (!fs.containsKey(r)) {
                // 読むべきファイルがまだ無い = 前の段をやり忘れた
                System.out.println("   FAIL: needs " + r + " but it does not exist yet");
                System.out.println();
                return;
            }
        }
        System.out.println("   reads : " + reads);
        fs.putAll(writes);
        System.out.println("   writes: " + writes.keySet());
        System.out.println();
    }

    static Map<String, String> files(String... pathAndContent) {
        Map<String, String> m = new LinkedHashMap<>();
        for (int i = 0; i < pathAndContent.length; i += 2) {
            m.put(pathAndContent[i], pathAndContent[i + 1]);
        }
        return m;
    }

    static void tree() {
        System.out.println("## files now");
        fs.keySet().stream().sorted().forEach(p -> System.out.println("   " + p));
        System.out.println();
    }

    public static void main(String[] args) {
        fs.put("src/com/example/app/Main.java", "source");
        fs.put("src/com/example/greet/Greeter.java", "source, uses StringUtils from commons-lang3");
        fs.put("resources/app.properties", "greeting=Hello");
        fs.put("test/com/example/greet/GreeterTest.java", "JUnit (Jupiter) test");
        fs.put("lib/commons-lang3-3.21.0.jar", "dependency (downloaded by a human)");
        fs.put("lib-test/junit-platform-console-standalone-6.1.3.jar", "test runner (downloaded by a human)");
        tree();

        // (a) コンパイル。依存 JAR も読む(-cp に無いと package ... does not exist)
        step("(a) compile", "javac -d build/classes -cp lib/commons-lang3-3.21.0.jar src/**/*.java",
            List.of("src/com/example/app/Main.java", "src/com/example/greet/Greeter.java", "lib/commons-lang3-3.21.0.jar"),
            files("build/classes/com/example/app/Main.class", "bytecode",
                  "build/classes/com/example/greet/Greeter.class", "bytecode"));

        // (b) リソースのコピー。javac は .properties を触らないので別の段になる。(a) とは独立
        step("(b) copy resources (javac does not touch .properties)", "cp -r resources/. build/classes/",
            List.of("resources/app.properties"),
            files("build/classes/app.properties", "greeting=Hello"));

        // (c) テストのコンパイルは (a) の出力を読む。ここに本当の依存関係がある
        step("(c) compile tests", "javac -d build/test-classes -cp build/classes:lib/*:lib-test/* test/**/*.java",
            List.of("test/com/example/greet/GreeterTest.java", "build/classes/com/example/greet/Greeter.class",
                    "lib-test/junit-platform-console-standalone-6.1.3.jar"),
            files("build/test-classes/com/example/greet/GreeterTest.class", "bytecode"));

        // (c2) テストの実行は、結果を画面に出すだけでファイルは書かない(終了コードが 0 か 1 かで次に進むかを決める)
        step("(c2) run tests (prints the result, exit code 0 or 1; writes nothing)", "java -jar lib-test/junit-platform-console-standalone-6.1.3.jar execute --class-path ... --scan-class-path",
            List.of("build/test-classes/com/example/greet/GreeterTest.class", "build/classes/app.properties"),
            files());

        // (d) JAR 化。依存は入らない
        step("(d) package", "jar --create --file dist/app.jar --main-class com.example.app.Main -C build/classes .",
            List.of("build/classes/com/example/app/Main.class", "build/classes/app.properties"),
            files("dist/app.jar", "classes + app.properties, NOT the dependency"));

        // (e) 実行は何も書かない。依存は JAR の外に置いたまま -cp に並べる
        step("(e) run", "java -cp dist/app.jar:lib/commons-lang3-3.21.0.jar com.example.app.Main",
            List.of("dist/app.jar", "lib/commons-lang3-3.21.0.jar"),
            files());

        tree();

        // やり忘れの例: (a) を飛ばして (c) をやると、読むべき .class が無い
        fs.remove("build/classes/com/example/greet/Greeter.class");
        step("(c) compile tests, but (a) was skipped", "javac -d build/test-classes ... test/**/*.java",
            List.of("test/com/example/greet/GreeterTest.java", "build/classes/com/example/greet/Greeter.class"),
            files());

        // ビルドツールが持っているのはこれ: 各段が何を読み何を書くか、その順序、済んでいるかの判定
        // (Maven/Gradle はさらに lib/ を自分で取ってくる)
        System.out.println("A build tool stores this: which step reads what, writes what, in which order,");
        System.out.println("and whether a step is already done. Maven and Gradle also fetch lib/ for you.");
    }
}