跳到正文
教程首页
FlutterCH 13ch13_network

ch13-network

网络请求:http / dio、超时重试、流式响应、Riverpod 集成。完整工程共 109 个文件,其中 69 个文本源文件可在下面在线阅读。

69

在线文本文件

4,639

源码行数

dart / c / yaml

语言

290 KB

打包体积

在线阅读源码

左侧按目录浏览,点击文件切换。右上角可复制代码、复制路径或单独下载文件。在线视图只覆盖文本源码,完整工程请下载 zip。

textdartxmljsonkotlin

69 text files · 4,639 lines

dartlib/src/future_builder_page.dart
// FutureBuilder:最基础的"异步 → UI"写法。
//
// 与 Riverpod 的 AsyncValue 相比:
//   - Future 必须**在 initState 里创建**,绝不能在 build 里创建(每次重建都会重新发请求);
//   - 只有一个 Future,"刷新"要手动 setState 换一个新的;
//   - 不能跨页面共享。
// 本章主体用 Riverpod,这里保留 FutureBuilder 是因为读第三方代码时天天遇到它。
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';

import 'post.dart';
import 'providers.dart';

class FutureBuilderPage extends ConsumerStatefulWidget {
  const FutureBuilderPage({super.key});

  @override
  ConsumerState<FutureBuilderPage> createState() => _FutureBuilderPageState();
}

class _FutureBuilderPageState extends ConsumerState<FutureBuilderPage> {
  late Future<Post> _future;

  @override
  void initState() {
    super.initState();
    _future = ref.read(postsApiProvider).fetchPost(1); // 只创建一次
  }

  void _reload() {
    setState(() {
      _future = ref.read(postsApiProvider).fetchPost(1);
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('FutureBuilder 示例'),
        actions: [
          IconButton(
            key: const Key('future-reload'),
            onPressed: _reload,
            icon: const Icon(Icons.refresh),
          ),
        ],
      ),
      body: FutureBuilder<Post>(
        future: _future,
        builder: (BuildContext context, AsyncSnapshot<Post> snapshot) {
          if (snapshot.connectionState != ConnectionState.done) {
            return const Center(child: CircularProgressIndicator(key: Key('future-loading')));
          }
          if (snapshot.hasError) {
            return Center(child: Text('出错了:${snapshot.error}', key: const Key('future-error')));
          }
          final Post post = snapshot.data!;
          return Padding(
            padding: const EdgeInsets.all(16),
            child: Column(
              crossAxisAlignment: CrossAxisAlignment.start,
              children: [
                Text(post.title, key: const Key('future-title'), style: Theme.of(context).textTheme.titleLarge),
                const SizedBox(height: 8),
                Text(post.body),
              ],
            ),
          );
        },
      ),
    );
  }
}

代码构成:text 64 KB · dart 48 KB · xml 41 KB · json 4 KB

本地运行

zip → 解压 → 执行
$cd examples/ch13-network && flutter run -d macos(需要联网;接口是 jsonplaceholder.typicode.com)

这个 zip 里有什么

  • • 完整工程目录(含 Android / iOS / 桌面平台脚手架)
  • • lib / bin / test / native 全部源码与测试
  • • pubspec.yaml、锁文件与平台配置文件
  • • 已排除 .dart_tool / build / target / ephemeral 等构建产物

已验证

  • flutter analyze 0 告警、flutter test 30 个用例全绿(全部用 mock,不依赖真实外网)、flutter build macos --debug 真实构建并启动成功
  • 真实请求 GET /posts?_limit=2 返回 200 / 2 行
查看全部示例