Java 8→17→21 JVM オプション移行ガイド：廃止・変更・新設オプション徹底比較

import java.lang.management.GarbageCollectorMXBean;
import java.lang.management.ManagementFactory;
import java.lang.management.RuntimeMXBean;
import java.util.List;

/**
 * JVM オプション移行ガイド — 実行バージョン確認と設定検証デモ
 *
 * 実行方法（Java 17 / 21）:
 *   java -Xms256m -Xmx512m \
 *        -Xlog:gc*:file=gc.log:time,uptime,level,tags \
 *        -XX:+HeapDumpOnOutOfMemoryError \
 *        JvmOptionsMigrationDemo
 *
 * Java 8 で使っていた廃止オプション（使用禁止）:
 *   -XX:+PrintGCDetails     -> 代替: -Xlog:gc*
 *   -XX:+PrintGCDateStamps  -> 代替: -Xlog:gc*:...:time
 *   -XX:MaxPermSize=256m    -> PermGen 廃止済み。削除すること
 */
public class JvmOptionsMigrationDemo {

    /** 実行中の Java バージョンを取得して大まかに分類する */
    static int detectMajorVersion() {
        String version = System.getProperty("java.version");
        // "1.8.0_xxx" 形式（Java 8）と "17.0.x" 形式を両対応
        if (version.startsWith("1.")) {
            return Integer.parseInt(version.split("\\.")[1]);
        }
        return Integer.parseInt(version.split("\\.")[0]);
    }

    /** JVM に渡された起動フラグを取得し、廃止フラグが含まれていれば警告する */
    static void checkDeprecatedFlags(List<String> flags) {
        var deprecated = List.of(
            "-XX:+PrintGCDetails",
            "-XX:+PrintGCDateStamps",
            "-XX:MaxPermSize",
            "-XX:PermSize",
            "-XX:+UseConcMarkSweepGC"  // Java 14 で削除
        );
        System.out.println("\n=== 廃止オプションチェック ===");
        boolean found = false;
        for (String flag : flags) {
            for (String dep : deprecated) {
                if (flag.contains(dep)) {
                    System.out.println("[警告] 廃止オプション検出: " + flag);
                    found = true;
                }
            }
        }
        if (!found) {
            System.out.println("廃止オプションなし — OK");
        }
    }

    /** ヒープ設定とコンテナ対応状況を表示する */
    static void printHeapInfo() {
        var runtime = Runtime.getRuntime();
        long maxMb   = runtime.maxMemory()   / (1024 * 1024);
        long totalMb = runtime.totalMemory() / (1024 * 1024);
        long usedMb  = (runtime.totalMemory() - runtime.freeMemory()) / (1024 * 1024);

        System.out.println("\n=== ヒープ情報 ===");
        System.out.println("最大ヒープ (-Xmx)   : " + maxMb   + " MB");
        System.out.println("現在のヒープ        : " + totalMb + " MB");
        System.out.println("使用中              : " + usedMb  + " MB");
        System.out.println("CPU コア数          : " + runtime.availableProcessors());
        // Java 10+ で UseContainerSupport がデフォルト有効になり、
        // コンテナの cgroup 上限（docker run --memory など）を JVM が認識するようになった。
        // -Xmx を明示しない場合は MaxRAMPercentage（デフォルト 25%）が上限の基準になる。
        System.out.println("(コンテナ実行時は cgroup 上限を反映: UseContainerSupport Java 10+)");
    }

    /** GC アルゴリズムとバージョン別の変遷を表示する */
    static void printGcInfo() {
        System.out.println("\n=== GC 情報 ===");
        for (GarbageCollectorMXBean gc : ManagementFactory.getGarbageCollectorMXBeans()) {
            System.out.println("GC 名     : " + gc.getName());
            System.out.println("  回数    : " + gc.getCollectionCount());
            System.out.println("  累計時間: " + gc.getCollectionTime() + " ms");
        }
    }

    /** バージョン別の推奨 GC オプションを表示する */
    static void printVersionGuidance(int major) {
        // switch 式（Java 14+）でバージョン別ガイダンスを返す
        var guidance = switch (major) {
            case 8  -> """
                [Java 8] デフォルト GC: Parallel GC
                  推奨: -XX:+UseG1GC（明示指定で G1GC に切替可）
                  GC ログ: -XX:+PrintGCDetails -XX:+PrintGCDateStamps（Java 8 のみ有効）
                  注意: UseContainerSupport 未対応。コンテナではヒープを明示指定すること""";
            case 17 -> """
                [Java 17] デフォルト GC: G1GC
                  推奨: -Xlog:gc*:file=gc.log:time,uptime,level,tags
                  ZGC: -XX:+UseZGC（低レイテンシ要件向け）
                  廃止: -XX:+PrintGCDetails, -XX:MaxPermSize は削除すること""";
            default -> """
                [Java 21] デフォルト GC: G1GC / Generational ZGC
                  推奨 ZGC: -XX:+UseZGC -XX:+ZGenerational
                  GC ログ: -Xlog:gc*:file=gc.log:time,uptime,level,tags
                  コンテナ: -XX:MaxRAMPercentage=75.0 を検討（デフォルト 25%）""";
        };
        System.out.println("\n=== バージョン別ガイダンス ===");
        System.out.println(guidance);
    }

    public static void main(String[] args) {
        System.out.println("=== JVM オプション移行チェッカー ===");
        System.out.println("Java version : " + System.getProperty("java.version"));
        System.out.println("JVM vendor   : " + System.getProperty("java.vendor"));

        int major = detectMajorVersion();
        System.out.println("メジャーバージョン: " + major);

        // 起動フラグに廃止オプションが含まれていないか確認
        RuntimeMXBean runtimeMxBean = ManagementFactory.getRuntimeMXBean();
        checkDeprecatedFlags(runtimeMxBean.getInputArguments());

        printHeapInfo();
        printGcInfo();
        printVersionGuidance(major);

        System.out.println("\n=== 移行チェックリスト ===");
        System.out.println("""
            [ ] -XX:MaxPermSize / -XX:PermSize を削除した
            [ ] -XX:+PrintGCDetails を -Xlog:gc* に書き換えた
            [ ] -XX:+UseConcMarkSweepGC (CMS) を削除 / G1GC に変更した
            [ ] コンテナ環境で -XX:MaxRAMPercentage を設定した
            [ ] GC アルゴリズムをワークロードに合わせて選定した""");
    }
}