database_controller.dart 12 KB

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