JSONのフィールドが欠けている場合

CoddyのFlutterジャーニー「データとネットワーク」セクションの一部。レッスン 19/27。

実際のデータには欠けている項目があります。/booksでは、2冊の本に"subtitle"がありますが、Pride and Prejudiceにはありません。存在しないキーに対してjson['subtitle']はnullを返し、null as Stringは失敗します。その結果、リスト全体の読み込みがtype 'Null' is not a subtype of type 'String'というエラーで失敗します。

型の後ろに?を付けると、nullも格納できます。String?は「文字列、または何もない」という意味です。

final String? subtitle;

subtitle: json['subtitle'] as String?,

そのためDartでは、使う場所ごとに欠けている場合への対処が必要です。??を使うと、nullの場合の代替値を指定できます。

Text(book.subtitle ?? 'No subtitle')

book.subtitle!と書くこともできます。これはDartに「信じて。これはnullではない」と伝えるものです。サーバーからのデータに対しては、守れない約束です。字幕がない本で!を使うと、画面がクラッシュします。hasDataを確認した後のsnapshot.data!のように、確認済みの場所で!を使いましょう。

チャレンジ

中級

本棚の読み込みに失敗します。1冊の本にサブタイトルがないためです。サブタイトルを省略可能にしましょう。

フィールドの型は String? で、as String? として読み取ります
サブタイトルがない本には、リストに No subtitle と表示します

自分で試してみよう

import 'dart:convert';

import 'package:flutter/material.dart';

import 'api.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(
      debugShowCheckedModeBanner: false,
      home: BooksScreen(),
    );
  }
}

class BooksScreen extends StatefulWidget {
  const BooksScreen({super.key});

  @override
  State<BooksScreen> createState() => _BooksScreenState();
}

class _BooksScreenState extends State<BooksScreen> {
  late Future<List<Book>> _books;

  @override
  void initState() {
    super.initState();
    _books = loadBooks();
  }

  Future<List<Book>> loadBooks() async {
    final body = await fetch('/books');
    final items = jsonDecode(body) as List<dynamic>;
    return items.map((item) => Book.fromJson(item as Map<String, dynamic>)).toList();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Books')),
      body: FutureBuilder<List<Book>>(
        future: _books,
        builder: (context, snapshot) {
          if (snapshot.hasError) {
            return Center(child: Text('Could not load: ${snapshot.error}'));
          }
          if (snapshot.hasData) {
            final books = snapshot.data!;
            return ListView.builder(
              itemCount: books.length,
              itemBuilder: (context, index) {
                final book = books[index];
                return ListTile(
                  title: Text(book.title),
                  subtitle: Text(book.subtitle),
                );
              },
            );
          }
          return const Center(child: CircularProgressIndicator());
        },
      ),
    );
  }
}

class Book {
  Book({required this.title, required this.subtitle});

  final String title;
  final String subtitle;

  factory Book.fromJson(Map<String, dynamic> json) {
    return Book(
      title: json['title'] as String,
      subtitle: json['subtitle'] as String,
    );
  }
}