8. mvn・./mvnw・ant・./gradlew: ビルドのコマンド

import java.util.List;

// 「mvn の後ろに書いた語」を Maven がどう読むかの模型(Maven の実装ではない)。
// フェーズは順番が決まっていて、指定したところまで前から全部進む。
// フェーズには、プラグインのゴール(実際の作業)が割り当てられている。
class Main {
    // default ライフサイクルのフェーズの一部と、jar のプロジェクトで割り当てられるゴール
    static final String[][] PHASES = {
        {"validate", ""},
        {"process-resources", "resources:resources"},
        {"compile", "compiler:compile"},
        {"process-test-resources", "resources:testResources"},
        {"test-compile", "compiler:testCompile"},
        {"test", "surefire:test"},
        {"package", "jar:jar"},
        {"verify", ""},
        {"install", "install:install"},
        {"deploy", "deploy:deploy"},
    };

    static void mvn(String... words) {
        System.out.println("$ mvn " + String.join(" ", words));
        for (String word : words) {
            if (word.startsWith("-D")) {
                // -D名前 は、プロパティ(設定値)を渡すオプション
                System.out.println("  option   " + word + "  (defines the property " + word.substring(2) + ")");
            } else if (word.contains(":")) {
                // プラグイン:ゴール の形は、ゴールを直接実行する
                System.out.println("  goal     " + word + "  (runs this goal only)");
            } else if (word.equals("clean")) {
                // clean は、別のライフサイクル(clean)のフェーズ。その前の pre-clean は、この模型では省略
                System.out.println("  phase    clean  -> clean:clean");
            } else {
                runUpTo(word);
            }
        }
        System.out.println();
    }

    // 先頭のフェーズから、指定されたフェーズまでを順に進める
    static void runUpTo(String last) {
        List<String> names = java.util.Arrays.stream(PHASES).map(p -> p[0]).toList();
        if (!names.contains(last)) {
            System.out.println("  unknown phase: " + last);
            return;
        }
        for (String[] phase : PHASES) {
            String goal = phase[1].isEmpty() ? "(no goal in this table)" : "-> " + phase[1];
            System.out.printf("  phase    %-23s %s%n", phase[0], goal);
            if (phase[0].equals(last)) {
                break;
            }
        }
    }

    public static void main(String[] args) {
        mvn("package");
        mvn("clean", "package");
        mvn("validate");
        mvn("dependency:tree");
        // この模型は語の読み分けだけを見せる。-DskipTests でテストが飛ぶところまでは再現していない
        mvn("-DskipTests", "package");
    }
}

// 出力(5つのうち先頭の4つ。2つ目は途中まで。JDK 22 で実行)
//   $ mvn package
//     phase    validate                (no goal in this table)
//     phase    process-resources       -> resources:resources
//     phase    compile                 -> compiler:compile
//     phase    process-test-resources  -> resources:testResources
//     phase    test-compile            -> compiler:testCompile
//     phase    test                    -> surefire:test
//     phase    package                 -> jar:jar
//
//   $ mvn clean package
//     phase    clean  -> clean:clean
//     phase    validate                (no goal in this table)
//   ...
//   $ mvn validate
//     phase    validate                (no goal in this table)
//
//   $ mvn dependency:tree
//     goal     dependency:tree  (runs this goal only)
//   ...