跳到正文
教程首页
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/providers.dart
/// Riverpod 集成:把 HTTP 客户端、API、状态串起来。
///
/// 层次:
///   httpClientProvider —— 底层 client(可被测试替换)
///   postsApiProvider   —— 业务 API(可被测试替换)
///   postsProvider      —— AsyncNotifier:loading / error / data 三态
library;

import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:http/http.dart' as http;

import 'api_exception.dart';
import 'post.dart';
import 'posts_api.dart';

/// 共享一个 `http.Client`(连接池复用)。`ref.onDispose` 负责关闭。
final httpClientProvider = Provider<http.Client>((Ref ref) {
  final http.Client client = http.Client();
  ref.onDispose(client.close);
  return client;
});

/// 接口地址可在构建/运行时注入:
///   flutter run -d macos --dart-define=POSTS_API=http://127.0.0.1:8080
const String _baseUrl = String.fromEnvironment(
  'POSTS_API',
  defaultValue: 'https://jsonplaceholder.typicode.com',
);

final postsApiProvider = Provider<PostsApi>(
  (Ref ref) => PostsApi(client: ref.watch(httpClientProvider), baseUrl: _baseUrl),
);

/// 文章列表。`build()` 返回 Future → Riverpod 自动包成 `AsyncValue`。
class PostsNotifier extends AsyncNotifier<List<Post>> {
  @override
  Future<List<Post>> build() => ref.watch(postsApiProvider).fetchPosts();

  /// 手动刷新:先切回 loading,再用 `AsyncValue.guard` 捕获异常。
  /// 这样 UI 不需要写 try/catch。
  Future<void> refresh() async {
    state = const AsyncLoading<List<Post>>();
    state = await AsyncValue.guard<List<Post>>(
      () => ref.read(postsApiProvider).fetchPosts(),
    );
  }
}

final postsProvider =
    AsyncNotifierProvider<PostsNotifier, List<Post>>(PostsNotifier.new);

/// 单篇文章:`family` 按 id 缓存,每个详情页独立加载。
final postProvider = FutureProvider.family<Post, int>((Ref ref, int id) {
  return ref.watch(postsApiProvider).fetchPost(id);
});

/// 把异常翻译成用户文案的便捷 provider(演示"UI 不该认识 ApiException")。
final errorMessageProvider = Provider.family<String, Object>((Ref ref, Object error) {
  if (error is ApiException) return error.userMessage;
  return '出现未知错误';
});

代码构成: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 行
查看全部示例