Java Tips | 基本ユーティリティ：Double.parseDouble()

Boolean.parseBoolean()とは何か
boolean型とは何か
なぜ変換が必要なのか
Boolean.parseBoolean()の基本構文
ステップバイステップで理解する
変換結果を理解しよう
大事な注意点：例外が発生しない
内部でどのように動いているのか
実務でよくある利用例
実務でよくある失敗例
1. yes/no を期待している
2. 1と0を期待している
入力値の検証も重要
Boolean.valueOf()との違い
1. Boolean.parseBoolean()
2. Boolean.valueOf()
実務で使えるテンプレート集
情報セキュリティの観点から見る重要性
初心者が覚えておくべき重要ポイント
まとめ

Boolean.parseBoolean()とは何か

Javaで業務システムを開発していると、文字列として受け取った「true」「false」を真偽値（boolean型）として扱いたい場面が頻繁に登場します。

例えば、

設定ファイルの有効・無効フラグ
画面入力のチェックボックス
APIから取得したON/OFF情報
機能の有効化フラグ
権限管理設定
環境設定値

などです。

そのような場合に利用するのが Boolean.parseBoolean() です。

Boolean.parseBoolean(文字列)

Boolean.parseBoolean(文字列)

Java

このメソッドは文字列をboolean型へ変換します。

プログラムの条件分岐を扱う上で非常に重要なメソッドです。

boolean型とは何か

まずはboolean型を理解しましょう。

boolean型は「真（true）」または「偽（false）」のどちらか一方だけを表すデータ型です。

// true
boolean enabled = true;

// false
boolean enabled = false;

// true
boolean enabled = true;

// false
boolean enabled = false;

Java

主に条件分岐で利用されます。

// 有効なら処理実行
if (enabled) {

    System.out.println("実行");

}

// 有効なら処理実行
if (enabled) {

    System.out.println("実行");

}

Java

設定値や状態管理では非常によく利用される型です。

なぜ変換が必要なのか

実務では設定値や入力値を文字列として受け取ることが少なくありません。

// 設定ファイルから取得
String enabled = "true";

// 設定ファイルから取得
String enabled = "true";

Java

この状態ではString型です。

そのままif文には使えません。

// コンパイルエラー
if (enabled) {

}

// コンパイルエラー
if (enabled) {

}

Java

そこでBoolean.parseBoolean()を利用します。

// String → boolean
boolean flag =
        Boolean.parseBoolean(
                enabled
        );

// 条件分岐
if (flag) {

    System.out.println("有効");

}

// String → boolean
boolean flag =
        Boolean.parseBoolean(
                enabled
        );

// 条件分岐
if (flag) {

    System.out.println("有効");

}

Java

これで条件判定ができるようになります。

Boolean.parseBoolean()の基本構文

最も基本的な例を見てみましょう。

// 文字列
String text = "true";

// boolean変換
boolean result =
        Boolean.parseBoolean(text);

// 結果確認
System.out.println(result);

// 文字列
String text = "true";

// boolean変換
boolean result =
        Boolean.parseBoolean(text);

// 結果確認
System.out.println(result);

Java

実行結果

true

文字列の”true”がboolean型のtrueへ変換されました。

ステップバイステップで理解する

ステップ1：文字列を準備する

// 設定値
String setting = "true";

// 設定値
String setting = "true";

Java

現在はString型です。

ステップ2：Boolean.parseBoolean()を実行する

// booleanへ変換
boolean enabled =
        Boolean.parseBoolean(
                setting
        );

// booleanへ変換
boolean enabled =
        Boolean.parseBoolean(
                setting
        );

Java

ステップ3：条件分岐で利用する

// 有効なら実行
if (enabled) {

    System.out.println("機能ON");

}

// 有効なら実行
if (enabled) {

    System.out.println("機能ON");

}

Java

実行結果

機能ON

文字列から変換されたboolean値を利用して条件分岐できました。

変換結果を理解しよう

初心者が最も重要として覚えるべきポイントです。

Boolean.parseBoolean()は非常に特殊な動作をします。

入力値	結果
“true”	true
“TRUE”	true
“True”	true
“false”	false
“abc”	false
“123”	false
null	false

つまり、

「trueと解釈できる文字列だけがtrueになる」

という仕組みです。

大事な注意点：例外が発生しない

Integer.parseInt()やDouble.parseDouble()との大きな違いです。

例えば次のコードです。

// 意図しない文字列
boolean result =
        Boolean.parseBoolean(
                "Java"
        );

System.out.println(result);

// 意図しない文字列
boolean result =
        Boolean.parseBoolean(
                "Java"
        );

System.out.println(result);

Java

実行結果

false

例外は発生しません。

ただ単にfalseになります。

これは便利な反面、入力ミスに気付きにくいという側面もあります。

内部でどのように動いているのか

イメージとしては次のような実装です。

// イメージコード
return "true".equalsIgnoreCase(
        value
);

// イメージコード
return "true".equalsIgnoreCase(
        value
);

Java

つまり、

true → true
TRUE → true
True → true
それ以外 → false

というシンプルな処理です。

実務でよくある利用例

設定ファイルの読込み

// プロパティ取得
String debugMode =
        properties.getProperty(
                "debug.mode"
        );

// boolean変換
boolean enabled =
        Boolean.parseBoolean(
                debugMode
        );

// プロパティ取得
String debugMode =
        properties.getProperty(
                "debug.mode"
        );

// boolean変換
boolean enabled =
        Boolean.parseBoolean(
                debugMode
        );

Java

システム設定では頻出です。

機能フラグ管理

// 設定値
String featureFlag =
        config.getFeatureFlag();

// ON/OFF判定
if (Boolean.parseBoolean(
        featureFlag
)) {

    // 機能実行

}

// 設定値
String featureFlag =
        config.getFeatureFlag();

// ON/OFF判定
if (Boolean.parseBoolean(
        featureFlag
)) {

    // 機能実行

}

Java

環境変数の利用

// 環境変数取得
String cacheEnabled =
        System.getenv(
                "CACHE_ENABLED"
        );

// 有効判定
boolean enabled =
        Boolean.parseBoolean(
                cacheEnabled
        );

// 環境変数取得
String cacheEnabled =
        System.getenv(
                "CACHE_ENABLED"
        );

// 有効判定
boolean enabled =
        Boolean.parseBoolean(
                cacheEnabled
        );

Java

実務でよくある失敗例

yes/no を期待している

次のコードを見てください。

// yes
boolean result =
        Boolean.parseBoolean(
                "yes"
        );

System.out.println(result);

// yes
boolean result =
        Boolean.parseBoolean(
                "yes"
        );

System.out.println(result);

Java

実行結果

false

yesはtrueにはなりません。

Boolean.parseBoolean()がtrueと認識するのは「true」だけです。

1と0を期待している

// 1
boolean result =
        Boolean.parseBoolean(
                "1"
        );

// 1
boolean result =
        Boolean.parseBoolean(
                "1"
        );

Java

実行結果

false

1もtrueになりません。

データ仕様を確認することが重要です。

入力値の検証も重要

実務では「true」「false」以外の値を許可しないケースがあります。

// 入力値
String value = input;

// 検証
if (!"true".equalsIgnoreCase(value)
        &&
    !"false".equalsIgnoreCase(value)) {

    throw new IllegalArgumentException(
            "不正な真偽値です"
    );

}

// 入力値
String value = input;

// 検証
if (!"true".equalsIgnoreCase(value)
        &&
    !"false".equalsIgnoreCase(value)) {

    throw new IllegalArgumentException(
            "不正な真偽値です"
    );

}

Java

業務ルールに応じた検証が重要です。

Boolean.valueOf()との違い

よく混同されるメソッドです。

Boolean.parseBoolean()

// primitive型
boolean flag =
        Boolean.parseBoolean(
                "true"
        );

// primitive型
boolean flag =
        Boolean.parseBoolean(
                "true"
        );

Java

Boolean.valueOf()

// ラッパークラス
Boolean flag =
        Boolean.valueOf(
                "true"
        );

// ラッパークラス
Boolean flag =
        Boolean.valueOf(
                "true"
        );

Java

違いは戻り値の型です。

parseBoolean() → boolean型
valueOf() → Boolean型

実務で使えるテンプレート集

基本変換テンプレート

// String → boolean
boolean value =
        Boolean.parseBoolean(
                text
        );

// String → boolean
boolean value =
        Boolean.parseBoolean(
                text
        );

Java

設定値読込テンプレート

// 設定値取得
boolean enabled =
        Boolean.parseBoolean(
                configValue
        );

// 設定値取得
boolean enabled =
        Boolean.parseBoolean(
                configValue
        );

Java

機能フラグテンプレート

// ON/OFF判定
if (Boolean.parseBoolean(
        featureFlag
)) {

    // 機能実行

}

// ON/OFF判定
if (Boolean.parseBoolean(
        featureFlag
)) {

    // 機能実行

}

Java

入力値検証テンプレート

// 許可値確認
if ("true".equalsIgnoreCase(value)
        ||
    "false".equalsIgnoreCase(value)) {

    boolean flag =
            Boolean.parseBoolean(
                    value
            );

}

// 許可値確認
if ("true".equalsIgnoreCase(value)
        ||
    "false".equalsIgnoreCase(value)) {

    boolean flag =
            Boolean.parseBoolean(
                    value
            );

}