Optionalの正しい使い方・やってはいけない使い方：Java初心者のための完全ガイド

JavaのOptionalクラスは、「nullを使わずに、安全に値を扱う」ための便利なツールです。しかし、使い方を間違えると、逆にコードが読みにくくなったり、バグを招いたりすることも。

このブログでは、初心者でもわかるように、Optionalの「正しい使い方」と「やってはいけない使い方」を丁寧に解説します。Optionalをマスターして、安全で読みやすいJavaコードを書けるようになりましょう！

✅ 正しい使い方

「値があるかもしれない」「値がないかもしれない」といったケースにOptionalは最適です。

public Optional&lt;User&gt; findUserById(String id) {
    return userMap.containsKey(id) ? Optional.of(userMap.get(id)) : Optional.empty();
}

public Optional<User> findUserById(String id) {

return userMap.containsKey(id) ? Optional.of(userMap.get(id)) : Optional.empty();

}

呼び出し側ではOptionalを通じて、安全に値を扱えます。

nullを返すのではなく、Optional.empty()やOptional.ofNullable()を使って明示的に「空」であることを示します。

String maybe = getNullableString();
Optional&lt;String&gt; optional = Optional.ofNullable(maybe);

String maybe = getNullableString();

Optional<String> optional = Optional.ofNullable(maybe);

optional.ifPresent(name -&gt; System.out.println(name));

String name = optional.orElse("デフォルト名");

optional.ifPresent(name -> System.out.println(name));

String name = optional.orElse("デフォルト名");

安全に値を取り出せる方法を活用しましょう。

Optionalの中身を操作するにはmapやflatMapが便利です。

String name = optionalUser.map(User::getName)
                          .orElse("名無し");

String name = optionalUser.map(User::getName)

.orElse("名無し");

// これはNG
public void printUser(Optional&lt;User&gt; user) { ... }

// これはNG

public void printUser(Optional<User> user) { ... }

Optionalは戻り値で使うもの。引数に使うとコードが複雑になり、意図が伝わりづらくなります。

// これは推奨されません
private Optional&lt;Address&gt; address;

// これは推奨されません

private Optional<Address> address;

Optionalはフィールドには不向きです。代わりにnullまたはOptional.ofNullable()で処理するほうが自然です。

// NG例
List&lt;Optional&lt;User&gt;&gt; userList;

// NG例

List<Optional<User>> userList;

コレクションの要素にOptionalを使うと、扱いづらくなります。空要素を含めないようにフィルタ処理を行うのが適切です。

// これは例外の原因になります
User user = optionalUser.get();

// これは例外の原因になります

User user = optionalUser.get();

Optionalを使う意味がなくなってしまいます。必ずisPresentやorElseでチェックしましょう。

やるべきこと	やってはいけないこと
メソッドの戻り値に使う	メソッドの引数に使う
nullの代わりにOptional.ofNullable	Optionalをフィールドに使う
map, flatMap, orElseを使う	get()を無条件に使う
チェック付きで中身を使う	コレクションにOptionalを入れる

Optionalを上手に使えば、Javaのコードは驚くほど安全で読みやすくなります。「nullチェックだらけ」のコードとはおさらばしましょう！