こんにちは！Dartの世界へようこそ。
Flutterを使ったアプリ開発や、サーバーサイドDartでのAPI連携をしていると、避けて通れないのが「外部から送られてくるJSONデータのハンドリング」ですよね。
「APIから受け取った動的なデータを、安全にアプリ内のドメインモデル（型のあるオブジェクト）に変換したい」
「でも、毎回 `as Map
そんな悩みを抱えていませんか？
ご安心ください。Dart 3で導入されたパターンマッチング（Pattern Matching）を使いこなせるようになると、JSONのバリデーションと型安全な変換が、驚くほど美しく、そして堅牢に書けるようになります。
ここをクリアすれば、あなたのDartコードはワンランク上の「プロのそれ」になりますよ。さあ、一緒に本質をマスターしていきましょう！
—
1. 従来のJSONパレードの何が辛いのか？
まず、私たちが普段やりがちな「従来のコード」を思い出してみましょう。外部APIから以下のようなユーザー情報のJSONが返ってくるとします。
{
“id”: 42,
“name”: “Alice”,
“role”: “admin”,
“permissions”: [“read”, “write”]
}
これをDartのオブジェクトに安全に変換しようとすると、大体こんなコードになりますよね。
// 従来の愚直なアプローチ（非推奨）
User parseUser(Map
final id = json[‘id’];
if (id is! int) {
throw FormatException(‘Invalid or missing id’);
}
final name = json[‘name’];
if (name is! String) {
throw FormatException(‘Invalid or missing name’);
}
final role = json[‘role’];
if (role is! String) {
throw FormatException(‘Invalid or missing role’);
}
// リストの型チェックまでやろうとすると…さらにネストが深くなる
return User(id: id, name: name, role: role);
}
…見るだけで肩が凝りませんか？型チェック（`is!`）とキャストの連続で、肝心のビジネスロジックが埋もれてしまいます。
—
2. Dart 3 パターンマッチングによる革命
Dart 3では、言語仕様としてパターン（Patterns）とスイッチ式（Switch Expressions）が導入されました。これにより、データの「構造」そのものをコードの形で表現し、一撃でマッチングと型安全な変数バインド（取り出し）を行えるようになりました。
百聞は一見に如かず。まずは、先ほどのJSONをDart 3の `switch` 式とパターンを使って華麗にバリデーション・変換するコードを見てみてください。
sealed class UserRole {}
class Admin extends UserRole {}
class Guest extends UserRole {}
class User {
final int id;
final String name;
final UserRole role;
User({required this.id, required this.name, required this.role});
}
// 🎯 Dart 3 パターンマッチングを使った堅牢なパーサー
User parseJsonToUser(Object? json) {
// 1. jsonが Map
return switch (json) {
{
‘id’: int id,
‘name’: String name,
‘role’: String roleStr,
} =>
User(
id: id,
name: name,
role: switch (roleStr) {
‘admin’ => Admin(),
_ => Guest(),
},
),
// 2. 構造や型が一致しない場合は、即座に安全な例外をスロー
_ => throw FormatException(‘不健全なJSONデータが検出されました: $json’),
};
}
どうですか、この圧倒的な見通しの良さは！
コードの意味を一つずつ解き明かしていきましょう。
—
3. コードの仕組み：何が起きているのか？
上記の `parseJsonToUser` 関数で使われているDart 3の核心技術を整理します。
① オブジェクトパターンの構造分解（Destructuring）
{
‘id’: int id,
‘name’: String name,
‘role’: String roleStr,
}
この部分がパターンマッチングの真骨頂です。
- `json` が `Map` であり、キー `’id’`, `’name’`, `’role’` を持っているかを確認します。
- 同時に、それぞれの値が `int` や `String` という期待する型であるかをチェックしつつ、一致していれば自動的に `id`, `name`, `roleStr` というローカル変数に値を束縛（代入）します。
もし型が違ったり、キーが欠損していた場合は、この `case` にはヒットせず、次の `_`（デフォルトケース）へと流れます。
② スイッチ式（Switch Expression）による簡潔さ
従来の `switch (x) { case A: … }` は文（Statement）でしたが、Dart 3のスイッチは式（Expression）です。つまり、値として直接 `return` したり、変数に代入したりできます。コードが関数型言語のようにエレガントになるのはこのためです。
—
4. 実戦投入：ネストした複雑なJSONを攻略する
実際のAPIレスポンスは、もう少し複雑で、ネスト（入れ子）構造やオプショナルなフィールドを含んでいることが多いですよね。
もう少し実用的な例として、「メタデータ」や「タグリスト」を含むJSONを処理するパターンを見てみましょう。
class Article {
final String title;
final List
final int? viewCount; // Nullableなフィールド
Article({required this.title, required this.tags, this.viewCount});
}
Article parseArticle(Object? json) {
return switch (json) {
{
‘title’: String title,
// リストの型安全な検証（List
‘tags’: List
// オプショナルなキー（存在しなくてもよい、またはnullでもよい）
‘view_count’: int? viewCount,
} =>
Article(
title: title,
// リストの要素がすべてStringであるかを保証しつつ変換
tags: rawTags.whereType
viewCount: viewCount,
),
_ => throw FormatException(‘ArticleのJSON構造が不正です’),
};
}
💡 ここがポイント：`List` の扱い
外部からのJSONは、Dart VMから見ると単なる `List
—
5. 陥りがちな罠とエラー回避の知見
Dartのパターンマッチングは非常に強力ですが、初学者がハマりやすい「落とし穴」もあります。
罠1: `Map` 型の厳密性
Dartの型システムにおいて、`Object?` や `Map` をパターンマッチングする際、キーの型は基本的に文字列（`String`）として扱われますが、JSONパーサーを通した直後のオブジェクトは `Map
そのため、関数に渡す引数は `Object? json` または `Map
罠2: 網羅性（Exhaustiveness）の重要性
Dart 3のスイッチ式は非常に賢く、「あらゆる可能性が網羅されているか」をコンパイル時にチェックしてくれます。
もし `_ => …`（デフォルトケース、ワイルドカードパターン）を書き忘れた場合、もし想定外のJSONが渡ってきたときにコンパイルエラーや実行時エラー（`type ‘Null’ is not a subtype of type ‘Article’` のような分かりにくいエラー）を引き起こします。
> プロからのアドバイス:
> JSONのバリデーションにおいては、必ず最後に `_ => throw FormatException(…)` を置くように習慣づけましょう。「何が来ても、想定内か例外か」を明示的にハンドリングするのが、堅牢なアーキテクチャの第一歩です。
—
まとめ
今回は、Dart 3のパターンマッチングを用いた、型安全かつエレガントなJSONバリデーションの手法を解説しました。
- 従来の `if` 文による泥臭い型チェックから解放される
- 構造の分解（Destructuring）と型チェックを同時に行える
- スイッチ式でボイラープレートを激減させ、可読性を飛躍的に高められる
ここをクリアすれば、あなたはもうただのDart初心者ではありません。堅牢なデータレイヤーを設計できる優れたエンジニアへの道を確実に歩んでいますよ。
ぜひ、次作るFlutterアプリやサーバーサイドDartのコードで試してみてくださいね。それでは、快適なDartライフを！