跳到正文
教程首页
FlutterCH 16ch16_bookmarks

ch16-bookmarks

综合项目(上):架构设计、数据层、依赖注入。完整工程共 116 个文件,其中 76 个文本源文件可在下面在线阅读。

76

在线文本文件

5,837

源码行数

dart / c / yaml

语言

301 KB

打包体积

在线阅读源码

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

textdartxmljsonkotlin

76 text files · 5,837 lines

dartlib/src/data/remote_api.dart
// 数据层(二):远程 API。
//
// 只做一件事:HTTP → 领域草稿(BookmarkDraft)。错误统一翻译成 SyncException。
import 'dart:async';
import 'dart:convert';

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

import '../core/config.dart';
import '../domain/bookmark.dart';
import '../domain/bookmark_repository.dart';

class HttpBookmarkRemoteApi implements BookmarkRemoteApi {
  HttpBookmarkRemoteApi({required this.client, required this.config});

  final http.Client client;
  final AppConfig config;

  @override
  Future<List<BookmarkDraft>> fetchDrafts({int limit = 10}) async {
    final Uri uri = Uri.parse('${config.baseUrl}/posts?_limit=$limit');
    try {
      final http.Response response = await client
          .get(uri, headers: <String, String>{'Accept': 'application/json'})
          .timeout(config.requestTimeout);

      if (response.statusCode < 200 || response.statusCode >= 300) {
        throw SyncException('服务器返回 ${response.statusCode}');
      }
      final Object? decoded = jsonDecode(utf8.decode(response.bodyBytes));
      if (decoded is! List<Object?>) {
        throw const SyncException('响应格式错误:期望数组');
      }
      return <BookmarkDraft>[
        for (final Object? raw in decoded)
          if (raw is Map<String, Object?>)
            BookmarkDraft(
              title: (raw['title'] as String? ?? '无标题').trim(),
              url: 'https://jsonplaceholder.typicode.com/posts/${raw['id']}',
              note: (raw['body'] as String? ?? '').trim(),
            ),
      ];
    } on SyncException {
      rethrow;
    } on TimeoutException catch (e) {
      throw SyncException('同步超时,请稍后重试', cause: e);
    } on FormatException catch (e) {
      throw SyncException('响应不是合法 JSON', cause: e);
    } on Exception catch (e) {
      throw SyncException('网络不可用:$e', cause: e);
    }
  }
}

代码构成:text 77 KB · dart 69 KB · xml 41 KB · json 4 KB

本地运行

zip → 解压 → 执行
$cd examples/ch16-bookmarks && flutter run -d macos

这个 zip 里有什么

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

已验证

  • flutter analyze 0 告警、flutter test 20 个用例全绿、debug 与 **release** 构建均真实启动成功
查看全部示例