从 JSON 创建列表

本课属于 Coddy Flutter 学习旅程的“数据与网络”单元。第 18 课，共 27 课。

很多响应都是列表：每一本书、每条消息、预报中的每一天。在 JSON 中，列表写在方括号里，这里的每一项都是一个对象：

[
  {"title": "Frankenstein", "author": "Mary Shelley"},
  {"title": "Pride and Prejudice", "author": "Jane Austen"}
]

jsonDecode 会把方括号解析成一个 List。它的每一项也是 dynamic，所以用 as 声明你期望的类型：列表使用 List<dynamic>，每一项使用 Map<String, dynamic>。

然后用 map 将每一项转换成一个 Book，再用 toList() 收集结果：

final items = jsonDecode(body) as List<dynamic>;
return items
    .map((item) => Book.fromJson(item as Map<String, dynamic>))
    .toList();

单独使用 map 得到的是惰性 Iterable，而不是 List，所以这里需要 toList()。这样，屏幕就有了一个供 ListView.builder 使用的 List<Book>。

挑战

中等

书架上只显示了第一本书。使用 items.map(...) 和 .toList()，让 loadBooks 将列表中的每个项目都转换为 Book。

亲手试试

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 [Book.fromJson(items[0] as Map<String, dynamic>)];
  }

  @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.author),
                );
              },
            );
          }
          return const Center(child: CircularProgressIndicator());
        },
      ),
    );
  }
}

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

  final String title;
  final String author;

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

自我测试

这节课包含一个小测验。开始学习即可作答，并记录你的进度。

自己练习： Flutter 在线编译器

从 JSON 创建列表

数据与网络中的所有课