database_controller.dart 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412
  1. import 'package:appflowy/plugins/database_view/application/field/field_controller.dart';
  2. import 'package:appflowy/plugins/database_view/application/view/view_cache.dart';
  3. import 'package:appflowy_backend/log.dart';
  4. import 'package:appflowy_backend/protobuf/flowy-database2/calendar_entities.pb.dart';
  5. import 'package:appflowy_backend/protobuf/flowy-database2/database_entities.pb.dart';
  6. import 'package:appflowy_backend/protobuf/flowy-database2/field_entities.pbenum.dart';
  7. import 'package:appflowy_backend/protobuf/flowy-database2/group.pb.dart';
  8. import 'package:appflowy_backend/protobuf/flowy-database2/group_changeset.pb.dart';
  9. import 'package:appflowy_backend/protobuf/flowy-database2/row_entities.pb.dart';
  10. import 'package:appflowy_backend/protobuf/flowy-database2/setting_entities.pb.dart';
  11. import 'package:appflowy_backend/protobuf/flowy-error/errors.pb.dart';
  12. import 'package:appflowy_backend/protobuf/flowy-folder2/view.pb.dart';
  13. import 'package:collection/collection.dart';
  14. import 'dart:async';
  15. import 'package:dartz/dartz.dart';
  16. import 'package:flutter/material.dart';
  17. import 'database_view_service.dart';
  18. import 'defines.dart';
  19. import 'field/field_info.dart';
  20. import 'layout/layout_service.dart';
  21. import 'layout/layout_setting_listener.dart';
  22. import 'row/row_cache.dart';
  23. import 'group/group_listener.dart';
  24. import 'row/row_service.dart';
  25. typedef OnGroupByField = void Function(List<GroupPB>);
  26. typedef OnUpdateGroup = void Function(List<GroupPB>);
  27. typedef OnDeleteGroup = void Function(List<String>);
  28. typedef OnInsertGroup = void Function(InsertedGroupPB);
  29. class GroupCallbacks {
  30. final OnGroupByField? onGroupByField;
  31. final OnUpdateGroup? onUpdateGroup;
  32. final OnDeleteGroup? onDeleteGroup;
  33. final OnInsertGroup? onInsertGroup;
  34. GroupCallbacks({
  35. this.onGroupByField,
  36. this.onUpdateGroup,
  37. this.onDeleteGroup,
  38. this.onInsertGroup,
  39. });
  40. }
  41. class DatabaseLayoutSettingCallbacks {
  42. final void Function(DatabaseLayoutSettingPB) onLayoutChanged;
  43. final void Function(DatabaseLayoutSettingPB) onLoadLayout;
  44. DatabaseLayoutSettingCallbacks({
  45. required this.onLayoutChanged,
  46. required this.onLoadLayout,
  47. });
  48. }
  49. class DatabaseCallbacks {
  50. OnDatabaseChanged? onDatabaseChanged;
  51. OnFieldsChanged? onFieldsChanged;
  52. OnFiltersChanged? onFiltersChanged;
  53. OnSortsChanged? onSortsChanged;
  54. OnNumOfRowsChanged? onNumOfRowsChanged;
  55. OnRowsDeleted? onRowsDeleted;
  56. OnRowsUpdated? onRowsUpdated;
  57. OnRowsCreated? onRowsCreated;
  58. DatabaseCallbacks({
  59. this.onDatabaseChanged,
  60. this.onNumOfRowsChanged,
  61. this.onFieldsChanged,
  62. this.onFiltersChanged,
  63. this.onSortsChanged,
  64. this.onRowsUpdated,
  65. this.onRowsDeleted,
  66. this.onRowsCreated,
  67. });
  68. }
  69. class DatabaseController {
  70. final String viewId;
  71. final DatabaseViewBackendService _databaseViewBackendSvc;
  72. final FieldController fieldController;
  73. DatabaseLayoutPB databaseLayout;
  74. DatabaseLayoutSettingPB? databaseLayoutSetting;
  75. late DatabaseViewCache _viewCache;
  76. // Callbacks
  77. final List<DatabaseCallbacks> _databaseCallbacks = [];
  78. final List<GroupCallbacks> _groupCallbacks = [];
  79. final List<DatabaseLayoutSettingCallbacks> _layoutCallbacks = [];
  80. // Getters
  81. RowCache get rowCache => _viewCache.rowCache;
  82. // Listener
  83. final DatabaseGroupListener _groupListener;
  84. final DatabaseLayoutSettingListener _layoutListener;
  85. final ValueNotifier<bool> _isLoading = ValueNotifier(true);
  86. DatabaseController({required ViewPB view})
  87. : viewId = view.id,
  88. _databaseViewBackendSvc = DatabaseViewBackendService(viewId: view.id),
  89. fieldController = FieldController(viewId: view.id),
  90. _groupListener = DatabaseGroupListener(view.id),
  91. databaseLayout = databaseLayoutFromViewLayout(view.layout),
  92. _layoutListener = DatabaseLayoutSettingListener(view.id) {
  93. _viewCache = DatabaseViewCache(
  94. viewId: viewId,
  95. fieldController: fieldController,
  96. );
  97. _listenOnRowsChanged();
  98. _listenOnFieldsChanged();
  99. _listenOnGroupChanged();
  100. _listenOnLayoutChanged();
  101. }
  102. void setIsLoading(bool isLoading) {
  103. _isLoading.value = isLoading;
  104. }
  105. ValueNotifier<bool> get isLoading => _isLoading;
  106. void addListener({
  107. DatabaseCallbacks? onDatabaseChanged,
  108. DatabaseLayoutSettingCallbacks? onLayoutChanged,
  109. GroupCallbacks? onGroupChanged,
  110. }) {
  111. if (onLayoutChanged != null) {
  112. _layoutCallbacks.add(onLayoutChanged);
  113. }
  114. if (onDatabaseChanged != null) {
  115. _databaseCallbacks.add(onDatabaseChanged);
  116. }
  117. if (onGroupChanged != null) {
  118. _groupCallbacks.add(onGroupChanged);
  119. }
  120. }
  121. Future<Either<Unit, FlowyError>> open() async {
  122. return _databaseViewBackendSvc.openDatabase().then((result) {
  123. return result.fold(
  124. (DatabasePB database) async {
  125. databaseLayout = database.layoutType;
  126. // Load the actual database field data.
  127. final fieldsOrFail = await fieldController.loadFields(
  128. fieldIds: database.fields,
  129. );
  130. return fieldsOrFail.fold(
  131. (fields) {
  132. // Notify the database is changed after the fields are loaded.
  133. // The database won't can't be used until the fields are loaded.
  134. for (final callback in _databaseCallbacks) {
  135. callback.onDatabaseChanged?.call(database);
  136. }
  137. _viewCache.rowCache.setInitialRows(database.rows);
  138. return Future(() async {
  139. await _loadGroups();
  140. await _loadLayoutSetting();
  141. return left(fields);
  142. });
  143. },
  144. (err) {
  145. Log.error(err);
  146. return right(err);
  147. },
  148. );
  149. },
  150. (err) => right(err),
  151. );
  152. });
  153. }
  154. Future<Either<RowMetaPB, FlowyError>> createRow({
  155. RowId? startRowId,
  156. String? groupId,
  157. void Function(RowDataBuilder builder)? withCells,
  158. }) {
  159. Map<String, String>? cellDataByFieldId;
  160. if (withCells != null) {
  161. final rowBuilder = RowDataBuilder();
  162. withCells(rowBuilder);
  163. cellDataByFieldId = rowBuilder.build();
  164. }
  165. return _databaseViewBackendSvc.createRow(
  166. startRowId: startRowId,
  167. groupId: groupId,
  168. cellDataByFieldId: cellDataByFieldId,
  169. );
  170. }
  171. Future<Either<Unit, FlowyError>> moveGroupRow({
  172. required RowMetaPB fromRow,
  173. required String groupId,
  174. RowMetaPB? toRow,
  175. }) {
  176. return _databaseViewBackendSvc.moveGroupRow(
  177. fromRowId: fromRow.id,
  178. toGroupId: groupId,
  179. toRowId: toRow?.id,
  180. );
  181. }
  182. Future<Either<Unit, FlowyError>> moveRow({
  183. required String fromRowId,
  184. required String toRowId,
  185. }) {
  186. return _databaseViewBackendSvc.moveRow(
  187. fromRowId: fromRowId,
  188. toRowId: toRowId,
  189. );
  190. }
  191. Future<Either<Unit, FlowyError>> moveGroup({
  192. required String fromGroupId,
  193. required String toGroupId,
  194. }) {
  195. return _databaseViewBackendSvc.moveGroup(
  196. fromGroupId: fromGroupId,
  197. toGroupId: toGroupId,
  198. );
  199. }
  200. Future<void> updateLayoutSetting(
  201. CalendarLayoutSettingPB calendarlLayoutSetting,
  202. ) async {
  203. await _databaseViewBackendSvc
  204. .updateLayoutSetting(
  205. calendarLayoutSetting: calendarlLayoutSetting,
  206. layoutType: databaseLayout,
  207. )
  208. .then((result) {
  209. result.fold((l) => null, (r) => Log.error(r));
  210. });
  211. }
  212. Future<void> dispose() async {
  213. await _databaseViewBackendSvc.closeView();
  214. await fieldController.dispose();
  215. await _groupListener.stop();
  216. await _viewCache.dispose();
  217. _databaseCallbacks.clear();
  218. _groupCallbacks.clear();
  219. _layoutCallbacks.clear();
  220. }
  221. Future<void> _loadGroups() async {
  222. final result = await _databaseViewBackendSvc.loadGroups();
  223. return Future(
  224. () => result.fold(
  225. (groups) {
  226. for (final callback in _groupCallbacks) {
  227. callback.onGroupByField?.call(groups.items);
  228. }
  229. },
  230. (err) => Log.error(err),
  231. ),
  232. );
  233. }
  234. Future<void> _loadLayoutSetting() async {
  235. _databaseViewBackendSvc.getLayoutSetting(databaseLayout).then((result) {
  236. result.fold(
  237. (newDatabaseLayoutSetting) {
  238. databaseLayoutSetting = newDatabaseLayoutSetting;
  239. databaseLayoutSetting?.freeze();
  240. for (final callback in _layoutCallbacks) {
  241. callback.onLoadLayout(newDatabaseLayoutSetting);
  242. }
  243. },
  244. (r) => Log.error(r),
  245. );
  246. });
  247. }
  248. void _listenOnRowsChanged() {
  249. final callbacks = DatabaseViewCallbacks(
  250. onNumOfRowsChanged: (rows, rowByRowId, reason) {
  251. for (final callback in _databaseCallbacks) {
  252. callback.onNumOfRowsChanged?.call(rows, rowByRowId, reason);
  253. }
  254. },
  255. onRowsDeleted: (ids) {
  256. for (final callback in _databaseCallbacks) {
  257. callback.onRowsDeleted?.call(ids);
  258. }
  259. },
  260. onRowsUpdated: (ids, reason) {
  261. for (final callback in _databaseCallbacks) {
  262. callback.onRowsUpdated?.call(ids, reason);
  263. }
  264. },
  265. onRowsCreated: (ids) {
  266. for (final callback in _databaseCallbacks) {
  267. callback.onRowsCreated?.call(ids);
  268. }
  269. },
  270. );
  271. _viewCache.addListener(callbacks);
  272. }
  273. void _listenOnFieldsChanged() {
  274. fieldController.addListener(
  275. onReceiveFields: (fields) {
  276. for (final callback in _databaseCallbacks) {
  277. callback.onFieldsChanged?.call(UnmodifiableListView(fields));
  278. }
  279. },
  280. onSorts: (sorts) {
  281. for (final callback in _databaseCallbacks) {
  282. callback.onSortsChanged?.call(sorts);
  283. }
  284. },
  285. onFilters: (filters) {
  286. for (final callback in _databaseCallbacks) {
  287. callback.onFiltersChanged?.call(filters);
  288. }
  289. },
  290. );
  291. }
  292. void _listenOnGroupChanged() {
  293. _groupListener.start(
  294. onNumOfGroupsChanged: (result) {
  295. result.fold(
  296. (changeset) {
  297. if (changeset.updateGroups.isNotEmpty) {
  298. for (final callback in _groupCallbacks) {
  299. callback.onUpdateGroup?.call(changeset.updateGroups);
  300. }
  301. }
  302. if (changeset.deletedGroups.isNotEmpty) {
  303. for (final callback in _groupCallbacks) {
  304. callback.onDeleteGroup?.call(changeset.deletedGroups);
  305. }
  306. }
  307. for (final insertedGroup in changeset.insertedGroups) {
  308. for (final callback in _groupCallbacks) {
  309. callback.onInsertGroup?.call(insertedGroup);
  310. }
  311. }
  312. },
  313. (r) => Log.error(r),
  314. );
  315. },
  316. onGroupByNewField: (result) {
  317. result.fold(
  318. (groups) {
  319. for (final callback in _groupCallbacks) {
  320. callback.onGroupByField?.call(groups);
  321. }
  322. },
  323. (r) => Log.error(r),
  324. );
  325. },
  326. );
  327. }
  328. void _listenOnLayoutChanged() {
  329. _layoutListener.start(
  330. onLayoutChanged: (result) {
  331. result.fold(
  332. (newLayout) {
  333. databaseLayoutSetting = newLayout;
  334. databaseLayoutSetting?.freeze();
  335. for (final callback in _layoutCallbacks) {
  336. callback.onLayoutChanged(newLayout);
  337. }
  338. },
  339. (r) => Log.error(r),
  340. );
  341. },
  342. );
  343. }
  344. }
  345. class RowDataBuilder {
  346. final _cellDataByFieldId = <String, String>{};
  347. void insertText(FieldInfo fieldInfo, String text) {
  348. assert(fieldInfo.fieldType == FieldType.RichText);
  349. _cellDataByFieldId[fieldInfo.field.id] = text;
  350. }
  351. void insertNumber(FieldInfo fieldInfo, int num) {
  352. assert(fieldInfo.fieldType == FieldType.Number);
  353. _cellDataByFieldId[fieldInfo.field.id] = num.toString();
  354. }
  355. void insertDate(FieldInfo fieldInfo, DateTime date) {
  356. assert(
  357. [
  358. FieldType.DateTime,
  359. FieldType.LastEditedTime,
  360. FieldType.CreatedTime,
  361. ].contains(fieldInfo.fieldType),
  362. );
  363. final timestamp = date.millisecondsSinceEpoch ~/ 1000;
  364. _cellDataByFieldId[fieldInfo.field.id] = timestamp.toString();
  365. }
  366. Map<String, String> build() {
  367. return _cellDataByFieldId;
  368. }
  369. }