Java 文字列の null 安全な扱い方と実装パターンまとめ

import java.util.Objects;
import java.util.Optional;

public class NullSafeStringHandler {

    /** null・空文字・空白のいずれかならデフォルト値を返す */
    public static String blankToDefault(String value, String defaultValue) {
        if (value == null || value.isBlank()) {
            return defaultValue;
        }
        return value;
    }

    /** null 安全な equals（定数を左辺に置く） */
    public static boolean safeEquals(String target, String value) {
        return target.equals(value);
    }

    /** Objects.toString でデフォルト値付きの変換 */
    public static String toStringOrDefault(Object obj, String defaultValue) {
        return Objects.toString(obj, defaultValue);
    }

    /** Optional で null と空白を排除し、変換を適用する */
    public static String transformOrDefault(String input, String defaultValue) {
        return Optional.ofNullable(input)
                .filter(s -> !s.isBlank())
                .map(String::trim)
                .orElse(defaultValue);
    }

    public static void main(String[] args) {
        // null / 空文字 / 空白のデフォルト値変換
        System.out.println(blankToDefault(null, "未入力"));     // 未入力
        System.out.println(blankToDefault("", "未入力"));       // 未入力
        System.out.println(blankToDefault("  ", "未入力"));     // 未入力
        System.out.println(blankToDefault("山田", "未入力"));   // 山田

        // null 安全な比較
        System.out.println(safeEquals("admin", null));          // false
        System.out.println(safeEquals("admin", "admin"));       // true

        // Objects.toString
        System.out.println(toStringOrDefault(null, "N/A"));     // N/A
        System.out.println(toStringOrDefault(42, "N/A"));       // 42

        // Optional を使った変換
        System.out.println(transformOrDefault("  hello  ", "空")); // hello
        System.out.println(transformOrDefault(null, "空"));        // 空
        System.out.println(transformOrDefault("   ", "空"));       // 空
    }
}