【Guava】StandardSystemPropertyの使い方

2025年7月6日2025年7月11日

Javaでシステムプロパティを取得する際には、System.getProperty("キー") を直接呼び出すのが一般的です。しかし、この方法ではキー名を文字列でハードコードする必要があるため、スペルミスや定数の重複、可読性の低下といった問題が起こりがちです。

こうした課題を解決する手段として、Googleが提供するライブラリ Guava の StandardSystemProperty を活用すれば、列挙型（enum）による安全かつ明示的なアクセスが可能になります。IDEの補完も活用できるため、開発効率や保守性の向上にもつながります。

この記事では、StandardSystemProperty の基本的な使い方から利点、注意点、実務での活用法までを詳しく解説します。

StandardSystemPropertyとは？

StandardSystemProperty は、Google Guavaライブラリの com.google.common.base パッケージに含まれる 列挙型（enum）クラス で、Javaが標準で提供するシステムプロパティを網羅的に定義しています。

通常、システムプロパティを取得するには System.getProperty("java.version") のように キーを文字列で直接指定する必要がありますが、この方法ではミスや保守性の問題が発生しやすくなります。

一方で StandardSystemProperty を使えば、以下のように 定数としてプロパティに安全にアクセスできます。

StandardSystemProperty.JAVA_VERSION.value();

このように、プロパティ名を 定義済みのenum定数で表現できるため、可読性が向上し、IDEの補完機能も活用できる点が大きなメリットです。

定義されているプロパティ一覧

StandardSystemProperty には、Javaが標準で定義しているシステムプロパティが列挙型として登録されています。これらはすべて System.getProperty で取得可能なプロパティであり、Javaの実行環境やOS情報などを取得する際に便利です。

以下は定義されている定数とその対応するプロパティ名、および説明の一覧です。

Enum定数	対応プロパティ名	説明
JAVA_VERSION	java.version	Javaのバージョン
JAVA_VENDOR	java.vendor	Javaのベンダ名
JAVA_VENDOR_URL	java.vendor.url	Javaベンダの公式URL
JAVA_HOME	java.home	Javaのインストールパス
JAVA_VM_SPECIFICATION_VERSION	java.vm.specification.version	JVM仕様のバージョン
JAVA_VM_SPECIFICATION_VENDOR	java.vm.specification.vendor	JVM仕様のベンダ名
JAVA_VM_SPECIFICATION_NAME	java.vm.specification.name	JVM仕様の名称
JAVA_VM_VERSION	java.vm.version	JVM実装のバージョン
JAVA_VM_VENDOR	java.vm.vendor	JVM実装のベンダ名
JAVA_VM_NAME	java.vm.name	JVM実装の名称
JAVA_SPECIFICATION_VERSION	java.specification.version	Java仕様のバージョン
JAVA_SPECIFICATION_VENDOR	java.specification.vendor	Java仕様のベンダ名
JAVA_SPECIFICATION_NAME	java.specification.name”	Java仕様の名称
JAVA_CLASS_VERSION	java.class.version	クラスファイルのバージョン
JAVA_CLASS_PATH	java.class.path	クラスパス
JAVA_LIBRARY_PATH	java.library.path	ネイティブライブラリの検索パス
JAVA_IO_TMPDIR	java.io.tmpdir	一時ファイル用ディレクトリのパス
JAVA_COMPILER	java.compiler	使用するJITコンパイラ名
JAVA_EXT_DIRS	java.ext.dirs	拡張ディレクトリ（※Java 9以降は使用不可）
OS_NAME	os.name	OSの名称
OS_ARCH	os.arch	OSのアーキテクチャ
OS_VERSION	os.version	OSのバージョン
FILE_SEPARATOR	file.separator	ファイルパスの区切り文字
PATH_SEPARATOR	path.separator	複数パスの区切り文字
LINE_SEPARATOR	line.separator	改行コード
USER_NAME	user.name	実行ユーザ名
USER_HOME	user.home	ユーザのホームディレクトリ
USER_DIR	user.dir	実行時のカレントディレクトリ

すべての定数には以下のメソッドが用意されています。

key()：プロパティ名（文字列）を返す
value()：対応するシステムプロパティの値を返す（null の可能性あり）

実際の使い方

StandardSystemProperty は、Javaの標準システムプロパティに対して簡潔かつ安全にアクセスするための手段です。ここでは、基本的な使い方から応用的な利用例までを紹介します。

単一のプロパティを取得する例

特定のシステムプロパティを取得したい場合は、以下のように value() メソッドを使います。

import com.google.common.base.StandardSystemProperty;

public class Example {
    public static void main(String[] args) {
        String javaVersion = StandardSystemProperty.JAVA_VERSION.value();
        System.out.println("Java Version: " + javaVersion);
    }
}

出力例：

Java Version: 11.0.21

このように、プロパティキーをハードコードせず、列挙型定数として安全にアクセスできます。

すべてのプロパティを出力する例

StandardSystemProperty.values() を使えば、定義されている全プロパティをループ処理で一括出力できます。ログ出力や環境確認などに便利です。

for (StandardSystemProperty prop : StandardSystemProperty.values()) {
    System.out.printf("%s = %s%n", prop.key(), prop.value());
}

出力例（一部）：

java.version = 11.0.21
java.vendor = Eclipse Adoptium
java.vendor.url = https://adoptium.net/
java.home = C:\Program Files\Eclipse Adoptium\jdk-11.0.21.9-hotspot

System.getPropertyとの違い

Java標準の System.getProperty(String key) は、任意のシステムプロパティを取得できる柔軟なAPIですが、キーを文字列で直接指定するため、いくつかの落とし穴があります。

一方で StandardSystemProperty を使えば、列挙型によってキーが定義済みになっているため、ミスを防ぎ、安全にアクセスできるという利点があります。

以下は、それぞれの違いを観点ごとに比較した表です。

比較項目	`System.getProperty()`	`StandardSystemProperty`
型安全性	❌ 文字列ベース。スペルミスがコンパイル時に検出されない	✅ Enum定数のため安全
保守性	❌ ハードコードになりやすく、修正漏れのリスクあり	✅ プロパティ名が定数化されており、意図が明確
補完機能	❌ IDEの補完が効かず、キー名を都度調べる必要がある	✅ IDE補完が効き、一覧から選択できる
柔軟性	✅ 任意のキーが指定可能（カスタムプロパティ含む）	❌ Java標準のプロパティのみ対応

どちらを使うべきか？

標準プロパティ（JavaのバージョンやOS情報など）を扱う場合は、StandardSystemProperty を使うことで可読性・安全性が大幅に向上します。
独自プロパティや外部ライブラリの設定値など、定義されていないキーを扱う場合は、従来の System.getProperty() を使う必要があります。

使用上の注意点とベストプラクティス

StandardSystemProperty は非常に便利な仕組みですが、使う際にはいくつか注意すべきポイントがあります。安全に活用するためのコツとあわせて紹介します。

`value()` は `null` を返すことがある

内部的には System.getProperty(key()) を呼び出しているため、プロパティが存在しない場合は null が返されます。
そのため、必ず null チェックを行うことが重要です。

String osName = StandardSystemProperty.OS_NAME.value();
if (osName != null) {
    System.out.println("OS: " + osName);
} else {
    System.out.println("OS情報は取得できませんでした。");
}

特に環境依存のプロパティ（例：JAVA_COMPILER や JAVA_EXT_DIRS）は、環境によっては設定されていないことがあります。