深入WhatTodo源码：从TaskBloc到ProjectDB的数据管理实现

【免费下载链接】WhatTodo A Simple Todo app design in Flutter to keep track of your task on daily basis. Its build on BLoC Pattern. You can add a project, labels, and due-date to your task also you can sort your task on the basis of project, label, and dates 项目地址: https://gitcode.com/gh_mirrors/wh/WhatTodo

WhatTodo是一款基于Flutter构建的简洁任务管理应用，采用BLoC模式设计，帮助用户高效跟踪日常任务。本文将深入解析其数据管理核心架构，从TaskBloc状态管理到ProjectDB本地存储的实现细节，揭示如何通过分层设计实现任务数据的流畅管理。

数据管理架构概览

WhatTodo采用经典的三层架构设计，将数据处理清晰分离为表现层、业务逻辑层和数据访问层：

• 表现层：通过UI组件响应用户操作
• 业务逻辑层：以BLoC组件为核心处理状态变化
• 数据访问层：通过DB类实现本地数据持久化

这种架构确保了数据流向的清晰可控，每个层次专注于单一职责，便于维护和扩展。

BLoC模式在任务管理中的应用

BLoC（Business Logic Component）模式是WhatTodo的核心设计模式，通过事件流管理应用状态。在任务管理模块中，TaskBloc作为核心业务逻辑组件，负责处理所有与任务相关的状态变化和数据操作。

WhatTodo的添加任务界面展示了任务数据的主要属性，包括项目、截止日期、优先级和标签等字段

TaskBloc：任务状态管理的核心

TaskBloc类位于lib/pages/tasks/bloc/task_bloc.dart，实现了BlocBase接口，是任务数据处理的中枢。其核心功能包括：

1. 数据流管理

TaskBloc通过两个StreamController管理数据流：

• _taskController：广播任务列表数据
• _cmdController：处理刷新命令

StreamController<List<Tasks>> _taskController = StreamController<List<Tasks>>.broadcast();
StreamController<int> _cmdController = StreamController<int>.broadcast();

2. 任务过滤系统

TaskBloc实现了多维度的任务过滤功能，支持按日期、项目、标签和状态筛选任务：

void filterTodayTasks() { /* 今日任务过滤逻辑 */ }
void filterTasksForNextWeek() { /* 下周任务过滤逻辑 */ }
void filterByProject(int projectId) { /* 按项目过滤逻辑 */ }
void filterByLabel(String labelName) { /* 按标签过滤逻辑 */ }
void filterByStatus(TaskStatus status) { /* 按状态过滤逻辑 */ }

3. 状态同步机制

通过_lastFilterStatus记录当前过滤状态，确保数据刷新时保持一致的过滤条件：

void refresh() {
  switch (_lastFilterStatus.filterStatus!) {
    case FilterStatus.BY_TODAY:
      filterTodayTasks();
      break;
    case FilterStatus.BY_WEEK:
      filterTasksForNextWeek();
      break;
    // 其他过滤状态处理...
  }
}

ProjectDB：项目数据持久化实现

ProjectDB类位于lib/pages/projects/project_db.dart，负责项目数据的本地存储管理，采用单例模式设计确保数据访问的一致性：

1. 单例模式实现

static final ProjectDB _projectDb = ProjectDB._internal(AppDatabase.get());
ProjectDB._internal(this._appDatabase);
static ProjectDB get() { return _projectDb; }

2. 核心数据库操作

ProjectDB封装了完整的CRUD操作：

• 查询项目：getProjects()方法支持获取所有项目数据
• 插入/更新项目：insertOrReplace()方法处理项目数据的添加和更新
• 删除项目：deleteProject()方法安全删除指定项目

3. SQL操作实现

以项目查询为例，展示SQLite操作的具体实现：

Future<List<Project>> getProjects({bool isInboxVisible = true}) async {
  var db = await _appDatabase.getDb();
  var whereClause = isInboxVisible ? ";" : " WHERE ${Project.dbId}!=1;";
  var result = await db.rawQuery('SELECT * FROM ${Project.tblProject} $whereClause');
  List<Project> projects = [];
  for (Map<String, dynamic> item in result) {
    var myProject = Project.fromMap(item);
    projects.add(myProject);
  }
  return projects;
}

数据流转：从UI到数据库的完整链路

WhatTodo的数据流转遵循严格的单向数据流原则，以添加任务为例，完整流程如下：

1. 用户在UI界面输入任务信息（如截图所示的"Add Task"界面）
2. AddTaskBloc接收并处理用户输入
3. 调用TaskDB的插入方法将任务数据持久化
4. TaskBloc监听数据变化并更新任务列表流
5. UI组件响应数据流变化，刷新任务列表

这一流程确保了数据变化的可预测性和一致性，是BLoC模式优势的集中体现。

总结：WhatTodo数据管理的设计启示

WhatTodo通过BLoC模式与本地数据库的结合，实现了高效、清晰的任务数据管理。其设计亮点包括：

• 职责分离：清晰划分UI、业务逻辑和数据访问层
• 响应式设计：通过Stream实现数据的实时响应
• 本地持久化：高效的SQLite操作确保数据安全
• 可扩展性：模块化设计便于功能扩展和维护

对于希望学习Flutter本地应用开发的开发者，WhatTodo的数据流管理实现提供了宝贵的参考范例，展示了如何在实际项目中应用BLoC模式和本地数据库技术。

要开始使用WhatTodo，可通过以下命令克隆项目代码：

git clone https://gitcode.com/gh_mirrors/wh/WhatTodo

通过深入研究lib/pages/tasks/bloc/task_bloc.dart和lib/pages/projects/project_db.dart等核心文件，开发者可以进一步理解Flutter应用中数据管理的最佳实践。

【免费下载链接】WhatTodo A Simple Todo app design in Flutter to keep track of your task on daily basis. Its build on BLoC Pattern. You can add a project, labels, and due-date to your task also you can sort your task on the basis of project, label, and dates 项目地址: https://gitcode.com/gh_mirrors/wh/WhatTodo