【Java】定数と設定値の使い分け方

2025年6月1日2025年7月4日

Javaアプリケーションを開発していると、「この値は定数としてコードに書くべきか？それとも外部の設定ファイルにすべきか？」という場面にたびたび直面します。この判断を誤ると、保守性やパフォーマンスに悪影響を与えかねません。

この記事では、定数（static final）とプロパティファイルの違いと使い分けの判断基準を、経験豊富なJavaエンジニアの視点から解説します。

定数（`static final`）とは？

Javaにおける「定数」とは、変更不可の固定値を意味し、通常は static final キーワードを使って定義されます。これにより、クラス単位で共有され、かつ値の再代入ができなくなります。

よくある定数の定義例は以下のようになります。

public class AppConstants {
    // ビジネスルールとして固定された値
    public static final int MAX_RETRY_COUNT = 3;
    public static final int PASSWORD_MIN_LENGTH = 8;
    
    // アプリケーションの仕様値
    public static final String VERSION = "1.0.0";
    public static final String ERROR_CODE_AUTH = "E001";
    
    // 計算に使う固定値
    public static final double TAX_RATE = 0.10;
}

定数の主な特徴

コンパイル時に値が確定するため、安全かつ予測可能
高速（I/Oを伴わないため、実行時のオーバーヘッドがほぼゼロ）
IDEの補完や静的解析の対象になるため、保守性や可読性が高い
値を変更するには再コンパイルが必要（柔軟性は低め）

ビジネスロジックやアプリケーションの仕様と密接に関わるような値は、定数としてコード内に定義するのが適しています。

プロパティファイルとは？

プロパティファイル（.properties）は、Javaアプリケーションにおける外部設定ファイルの代表的な形式です。主に、環境ごとに異なる値や実行時に変更される可能性がある設定値を管理するために使われます。

構文はシンプルで、キー = 値 の形式で記述します。たとえば以下のようになります。

# データベース接続設定
db.url=jdbc:mysql://localhost:3306/mydb
db.connection.pool.size=10
db.connection.timeout.ms=30000

# API設定
api.endpoint=https://api.example.com
api.timeout.ms=5000
api.key=your-secret-key

Javaコードからは、Properties クラスを使って以下のように読み込みます。

Properties props = new Properties();
try (InputStream input = new FileInputStream("config.properties")) {
    props.load(input);
}
String url = props.getProperty("db.url");
int poolSize = Integer.parseInt(props.getProperty("db.connection.pool.size", "5"));

プロパティファイルの主な特徴

アプリケーションの外部から設定値を変更可能（柔軟性が高い）
実行環境ごとの切り替えが容易（開発／本番環境の分離に有効）
再コンパイル不要で設定を変更できる
すべて文字列として扱われるため、型安全性は低い

システムの構成や環境に依存する値（データベースの接続情報、APIのエンドポイントなど）は、プロパティファイルで管理するのが一般的です。

使い分けの判断基準

「この値はコードに埋め込むべきか？それとも設定ファイルにすべきか？」――その判断を誤ると、保守性や柔軟性に悪影響を及ぼします。

以下は、定数（static final）とプロパティファイルを使い分けるための主要な判断ポイントです。

判断基準	定数（`static final`）	プロパティファイル
コードの仕様と密接に関係する値か？例：バージョン番号、固定エラーコード	✅ 適している	❌ 不向き
実行環境ごとに変更する必要があるか？例：DB接続先、APIキー	❌ 不向き	✅ 適している
アプリケーション実行中に値を変更したいか？例：タイムアウト時間、ログレベル	❌ 不可	✅ 可能
セキュリティ的に秘匿すべき値か？例：APIキー、トークン	❌ コードに埋め込むと漏洩リスク	✅ 設定ファイル＋秘匿手段で管理可能
パフォーマンス重視か？読み込み時のオーバーヘッドを避けたい	✅ 高速（I/O不要）	❌ I/O発生あり
IDE補完・リファクタリングの恩恵を受けたいか？可読性・保守性向上	✅ 受けられる	❌ 対象外

重要なのは「どちらが正しい」ではなく、用途に応じて適切な手段を選ぶことです。以下のような方針が基本となります。

変わらない仕様値 → 定数としてコードに埋め込む
変更される設定値 → プロパティファイルで外部化

判断に迷ったら、「この値がいつ・どこで・なぜ変更されるか？」を軸に考えると適切な選択ができます。

実践Tips：ハイブリッド運用も検討を

すべてを「定数」または「プロパティファイル」のどちらかに統一するのではなく、両者の長所を活かしたハイブリッドな設計も可能です。

Spring Bootでの型安全な設定管理

Spring Bootでは、@Valueを使ってプロパティファイルの値を型安全に扱うことができます。

@Component
public class ApiClient {
    // デフォルト値付きで設定を読み込み
    @Value("${api.timeout.ms:5000}")
    private int timeout;
    
    @Value("${api.endpoint}")
    private String endpoint;
}

さらに、@ConfigurationPropertiesを使えば、複数の設定をグルーピングして管理することも可能です。

@ConfigurationProperties(prefix = "api")
@Validated
public class ApiProperties {
    @NotNull
    private String endpoint;
    
    @Min(1000)
    @Max(30000)
    private int timeout = 5000; // デフォルト値
    
    private boolean retryEnabled = true;
    
    // getter, setter
}

フレームワークを使わない場合でも、設定読み込みロジックをクラスで共通化することで、定数的に扱う工夫も可能です。

デフォルト値戦略

次のような「初期値は定数で定義し、必要に応じて設定で上書き」という戦略も有効です。

public class ConfigurableService {
    // 安全なデフォルト値を定数で保証
    private static final int DEFAULT_TIMEOUT_MS = 5000;
    private static final int DEFAULT_RETRY_COUNT = 3;

    private final int timeout;
    private final int retryCount;

    public ConfigurableService(Properties config) {
        // プロパティファイルで上書き可能
        this.timeout = Integer.parseInt(
            config.getProperty("service.timeout.ms", String.valueOf(DEFAULT_TIMEOUT_MS)));
        this.retryCount = Integer.parseInt(
            config.getProperty("service.retry.count", String.valueOf(DEFAULT_RETRY_COUNT)));
    }
}

このアプローチの利点：