database_controller.dart 11 KB

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