grid_editor.rs 20 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529
  1. use crate::dart_notification::{send_dart_notification, GridNotification};
  2. use crate::manager::GridUser;
  3. use crate::services::block_meta_manager::GridBlockMetaEditorManager;
  4. use crate::services::cell::CellIdentifier;
  5. use crate::services::field::{default_type_option_builder_from_type, type_option_builder_from_bytes, FieldBuilder};
  6. use crate::services::persistence::block_index::BlockIndexPersistence;
  7. use crate::services::row::*;
  8. use bytes::Bytes;
  9. use flowy_error::{ErrorCode, FlowyError, FlowyResult};
  10. use flowy_grid_data_model::entities::*;
  11. use flowy_revision::{RevisionCloudService, RevisionCompactor, RevisionManager, RevisionObjectBuilder};
  12. use flowy_sync::client_grid::{GridChangeset, GridMetaPad, JsonDeserializer};
  13. use flowy_sync::entities::revision::Revision;
  14. use flowy_sync::errors::CollaborateResult;
  15. use flowy_sync::util::make_delta_from_revisions;
  16. use lib_infra::future::FutureResult;
  17. use lib_ot::core::PlainTextAttributes;
  18. use std::collections::HashMap;
  19. use std::sync::Arc;
  20. use tokio::sync::RwLock;
  21. pub struct ClientGridEditor {
  22. grid_id: String,
  23. user: Arc<dyn GridUser>,
  24. pad: Arc<RwLock<GridMetaPad>>,
  25. rev_manager: Arc<RevisionManager>,
  26. block_meta_manager: Arc<GridBlockMetaEditorManager>,
  27. }
  28. impl ClientGridEditor {
  29. pub async fn new(
  30. grid_id: &str,
  31. user: Arc<dyn GridUser>,
  32. mut rev_manager: RevisionManager,
  33. persistence: Arc<BlockIndexPersistence>,
  34. ) -> FlowyResult<Arc<Self>> {
  35. let token = user.token()?;
  36. let cloud = Arc::new(GridRevisionCloudService { token });
  37. let grid_pad = rev_manager.load::<GridPadBuilder>(Some(cloud)).await?;
  38. let rev_manager = Arc::new(rev_manager);
  39. let pad = Arc::new(RwLock::new(grid_pad));
  40. let blocks = pad.read().await.get_block_metas();
  41. let block_meta_manager = Arc::new(GridBlockMetaEditorManager::new(grid_id, &user, blocks, persistence).await?);
  42. Ok(Arc::new(Self {
  43. grid_id: grid_id.to_owned(),
  44. user,
  45. pad,
  46. rev_manager,
  47. block_meta_manager,
  48. }))
  49. }
  50. pub async fn insert_field(&self, params: InsertFieldParams) -> FlowyResult<()> {
  51. let InsertFieldParams {
  52. field,
  53. type_option_data,
  54. start_field_id,
  55. grid_id,
  56. } = params;
  57. let field_id = field.id.clone();
  58. if self.contain_field(&field_id).await {
  59. let _ = self
  60. .modify(|grid| {
  61. let deserializer = TypeOptionJsonDeserializer(field.field_type.clone());
  62. let changeset = FieldChangesetParams {
  63. field_id: field.id,
  64. grid_id,
  65. name: Some(field.name),
  66. desc: Some(field.desc),
  67. field_type: Some(field.field_type),
  68. frozen: Some(field.frozen),
  69. visibility: Some(field.visibility),
  70. width: Some(field.width),
  71. type_option_data: Some(type_option_data),
  72. };
  73. Ok(grid.update_field_meta(changeset, deserializer)?)
  74. })
  75. .await?;
  76. let _ = self.notify_grid_did_update_field(&field_id).await?;
  77. } else {
  78. let _ = self
  79. .modify(|grid| {
  80. let builder = type_option_builder_from_bytes(type_option_data, &field.field_type);
  81. let field_meta = FieldBuilder::from_field(field, builder).build();
  82. Ok(grid.create_field_meta(field_meta, start_field_id)?)
  83. })
  84. .await?;
  85. let _ = self.notify_grid_did_insert_field(&field_id).await?;
  86. }
  87. Ok(())
  88. }
  89. pub async fn create_next_field_meta(&self, field_type: &FieldType) -> FlowyResult<FieldMeta> {
  90. let name = format!("Property {}", self.pad.read().await.fields().len() + 1);
  91. let field_meta = FieldBuilder::from_field_type(field_type).name(&name).build();
  92. Ok(field_meta)
  93. }
  94. pub async fn contain_field(&self, field_id: &str) -> bool {
  95. self.pad.read().await.contain_field(field_id)
  96. }
  97. pub async fn update_field(&self, params: FieldChangesetParams) -> FlowyResult<()> {
  98. let field_id = params.field_id.clone();
  99. let json_deserializer = match self.pad.read().await.get_field_meta(params.field_id.as_str()) {
  100. None => return Err(ErrorCode::FieldDoesNotExist.into()),
  101. Some((_, field_meta)) => TypeOptionJsonDeserializer(field_meta.field_type.clone()),
  102. };
  103. let _ = self
  104. .modify(|grid| Ok(grid.update_field_meta(params, json_deserializer)?))
  105. .await?;
  106. let _ = self.notify_grid_did_update_field(&field_id).await?;
  107. Ok(())
  108. }
  109. pub async fn replace_field(&self, field_meta: FieldMeta) -> FlowyResult<()> {
  110. let field_id = field_meta.id.clone();
  111. let _ = self.modify(|pad| Ok(pad.replace_field_meta(field_meta)?)).await?;
  112. let _ = self.notify_grid_did_update_field(&field_id).await?;
  113. Ok(())
  114. }
  115. pub async fn delete_field(&self, field_id: &str) -> FlowyResult<()> {
  116. let _ = self.modify(|grid| Ok(grid.delete_field_meta(field_id)?)).await?;
  117. let field_order = FieldOrder::from(field_id);
  118. let notified_changeset = GridFieldChangeset::delete(&self.grid_id, vec![field_order]);
  119. let _ = self.notify_did_update_grid(notified_changeset).await?;
  120. Ok(())
  121. }
  122. pub async fn switch_to_field_type(&self, field_id: &str, field_type: &FieldType) -> FlowyResult<()> {
  123. // let block_ids = self
  124. // .get_block_metas()
  125. // .await?
  126. // .into_iter()
  127. // .map(|block_meta| block_meta.block_id)
  128. // .collect();
  129. // let cell_metas = self
  130. // .block_meta_manager
  131. // .get_cell_metas(block_ids, field_id, None)
  132. // .await?;
  133. let type_option_json_builder = |field_type: &FieldType| -> String {
  134. return default_type_option_builder_from_type(field_type).entry().json_str();
  135. };
  136. let _ = self
  137. .modify(|grid| Ok(grid.switch_to_field(field_id, field_type.clone(), type_option_json_builder)?))
  138. .await?;
  139. let _ = self.notify_grid_did_update_field(&field_id).await?;
  140. Ok(())
  141. }
  142. pub async fn duplicate_field(&self, field_id: &str) -> FlowyResult<()> {
  143. let duplicated_field_id = gen_field_id();
  144. let _ = self
  145. .modify(|grid| Ok(grid.duplicate_field_meta(field_id, &duplicated_field_id)?))
  146. .await?;
  147. let _ = self.notify_grid_did_insert_field(field_id).await?;
  148. Ok(())
  149. }
  150. pub async fn get_field_meta(&self, field_id: &str) -> Option<FieldMeta> {
  151. let field_meta = self.pad.read().await.get_field_meta(field_id)?.1.clone();
  152. Some(field_meta)
  153. }
  154. pub async fn get_field_metas<T>(&self, field_ids: Option<Vec<T>>) -> FlowyResult<Vec<FieldMeta>>
  155. where
  156. T: Into<FieldOrder>,
  157. {
  158. if field_ids.is_none() {
  159. let field_metas = self.pad.read().await.get_field_metas(None)?;
  160. return Ok(field_metas);
  161. }
  162. let to_field_orders = |item: Vec<T>| item.into_iter().map(|data| data.into()).collect();
  163. let field_orders = field_ids.map_or(vec![], to_field_orders);
  164. let expected_len = field_orders.len();
  165. let field_metas = self.pad.read().await.get_field_metas(Some(field_orders))?;
  166. if expected_len != 0 && field_metas.len() != expected_len {
  167. tracing::error!(
  168. "This is a bug. The len of the field_metas should equal to {}",
  169. expected_len
  170. );
  171. debug_assert!(field_metas.len() == expected_len);
  172. }
  173. Ok(field_metas)
  174. }
  175. pub async fn create_block(&self, grid_block: GridBlockMeta) -> FlowyResult<()> {
  176. let _ = self.modify(|grid| Ok(grid.create_block_meta(grid_block)?)).await?;
  177. Ok(())
  178. }
  179. pub async fn update_block(&self, changeset: GridBlockMetaChangeset) -> FlowyResult<()> {
  180. let _ = self.modify(|grid| Ok(grid.update_block_meta(changeset)?)).await?;
  181. Ok(())
  182. }
  183. pub async fn create_row(&self, start_row_id: Option<String>) -> FlowyResult<RowOrder> {
  184. let field_metas = self.pad.read().await.get_field_metas(None)?;
  185. let block_id = self.block_id().await?;
  186. // insert empty row below the row whose id is upper_row_id
  187. let row_meta_ctx = CreateRowMetaBuilder::new(&field_metas).build();
  188. let row_meta = make_row_meta_from_context(&block_id, row_meta_ctx);
  189. let row_order = RowOrder::from(&row_meta);
  190. // insert the row
  191. let row_count = self
  192. .block_meta_manager
  193. .create_row(&block_id, row_meta, start_row_id)
  194. .await?;
  195. // update block row count
  196. let changeset = GridBlockMetaChangeset::from_row_count(&block_id, row_count);
  197. let _ = self.update_block(changeset).await?;
  198. Ok(row_order)
  199. }
  200. pub async fn insert_rows(&self, contexts: Vec<CreateRowMetaPayload>) -> FlowyResult<Vec<RowOrder>> {
  201. let block_id = self.block_id().await?;
  202. let mut rows_by_block_id: HashMap<String, Vec<RowMeta>> = HashMap::new();
  203. let mut row_orders = vec![];
  204. for ctx in contexts {
  205. let row_meta = make_row_meta_from_context(&block_id, ctx);
  206. row_orders.push(RowOrder::from(&row_meta));
  207. rows_by_block_id
  208. .entry(block_id.clone())
  209. .or_insert_with(Vec::new)
  210. .push(row_meta);
  211. }
  212. let changesets = self.block_meta_manager.insert_row(rows_by_block_id).await?;
  213. for changeset in changesets {
  214. let _ = self.update_block(changeset).await?;
  215. }
  216. Ok(row_orders)
  217. }
  218. pub async fn update_row(&self, changeset: RowMetaChangeset) -> FlowyResult<()> {
  219. self.block_meta_manager.update_row(changeset).await
  220. }
  221. pub async fn get_rows(&self, block_id: &str) -> FlowyResult<RepeatedRow> {
  222. let block_ids = vec![block_id.to_owned()];
  223. let mut grid_block_snapshot = self.grid_block_snapshots(Some(block_ids)).await?;
  224. // For the moment, we only support one block.
  225. // We can save the rows into multiple blocks and load them asynchronously in the future.
  226. debug_assert_eq!(grid_block_snapshot.len(), 1);
  227. if grid_block_snapshot.len() == 1 {
  228. let snapshot = grid_block_snapshot.pop().unwrap();
  229. let field_metas = self.get_field_metas::<FieldOrder>(None).await?;
  230. let rows = make_rows_from_row_metas(&field_metas, &snapshot.row_metas);
  231. Ok(rows.into())
  232. } else {
  233. Ok(vec![].into())
  234. }
  235. }
  236. pub async fn get_row(&self, row_id: &str) -> FlowyResult<Option<Row>> {
  237. match self.block_meta_manager.get_row_meta(row_id).await? {
  238. None => Ok(None),
  239. Some(row_meta) => {
  240. let field_metas = self.get_field_metas::<FieldOrder>(None).await?;
  241. let row_metas = vec![row_meta];
  242. let mut rows = make_rows_from_row_metas(&field_metas, &row_metas);
  243. debug_assert!(rows.len() == 1);
  244. Ok(rows.pop())
  245. }
  246. }
  247. }
  248. pub async fn delete_row(&self, row_id: &str) -> FlowyResult<()> {
  249. let _ = self.block_meta_manager.delete_row(row_id).await?;
  250. Ok(())
  251. }
  252. pub async fn duplicate_row(&self, _row_id: &str) -> FlowyResult<()> {
  253. Ok(())
  254. }
  255. pub async fn get_cell(&self, params: &CellIdentifier) -> Option<Cell> {
  256. let field_meta = self.get_field_meta(&params.field_id).await?;
  257. let row_meta = self.block_meta_manager.get_row_meta(&params.row_id).await.ok()??;
  258. make_cell(&params.field_id, &field_meta, &row_meta)
  259. }
  260. pub async fn get_cell_meta(&self, row_id: &str, field_id: &str) -> FlowyResult<Option<CellMeta>> {
  261. let row_meta = self.block_meta_manager.get_row_meta(row_id).await?;
  262. match row_meta {
  263. None => Ok(None),
  264. Some(row_meta) => {
  265. let cell_meta = row_meta.cells.get(field_id).cloned();
  266. Ok(cell_meta)
  267. }
  268. }
  269. }
  270. #[tracing::instrument(level = "trace", skip_all, err)]
  271. pub async fn update_cell(&self, mut changeset: CellChangeset) -> FlowyResult<()> {
  272. if changeset.data.as_ref().is_none() {
  273. return Ok(());
  274. }
  275. let cell_data_changeset = changeset.data.unwrap();
  276. let cell_meta = self.get_cell_meta(&changeset.row_id, &changeset.field_id).await?;
  277. tracing::trace!("{}: {:?}", &changeset.field_id, cell_meta);
  278. match self.pad.read().await.get_field_meta(&changeset.field_id) {
  279. None => {
  280. let msg = format!("Field not found with id: {}", &changeset.field_id);
  281. Err(FlowyError::internal().context(msg))
  282. }
  283. Some((_, field_meta)) => {
  284. // Update the changeset.data property with the return value.
  285. changeset.data = Some(apply_cell_data_changeset(cell_data_changeset, cell_meta, field_meta)?);
  286. let _ = self.block_meta_manager.update_cell(changeset).await?;
  287. Ok(())
  288. }
  289. }
  290. }
  291. pub async fn get_blocks(&self, block_ids: Option<Vec<String>>) -> FlowyResult<RepeatedGridBlock> {
  292. let block_snapshots = self.grid_block_snapshots(block_ids.clone()).await?;
  293. make_grid_blocks(block_ids, block_snapshots)
  294. }
  295. pub async fn get_block_metas(&self) -> FlowyResult<Vec<GridBlockMeta>> {
  296. let grid_blocks = self.pad.read().await.get_block_metas();
  297. Ok(grid_blocks)
  298. }
  299. pub async fn delete_rows(&self, row_orders: Vec<RowOrder>) -> FlowyResult<()> {
  300. let changesets = self.block_meta_manager.delete_rows(row_orders).await?;
  301. for changeset in changesets {
  302. let _ = self.update_block(changeset).await?;
  303. }
  304. Ok(())
  305. }
  306. pub async fn grid_data(&self) -> FlowyResult<Grid> {
  307. let pad_read_guard = self.pad.read().await;
  308. let field_orders = pad_read_guard.get_field_orders();
  309. let mut block_orders = vec![];
  310. for block_order in pad_read_guard.get_block_metas() {
  311. let row_orders = self.block_meta_manager.get_row_orders(&block_order.block_id).await?;
  312. let block_order = GridBlockOrder {
  313. block_id: block_order.block_id,
  314. row_orders,
  315. };
  316. block_orders.push(block_order);
  317. }
  318. Ok(Grid {
  319. id: self.grid_id.clone(),
  320. field_orders,
  321. block_orders,
  322. })
  323. }
  324. pub async fn grid_block_snapshots(&self, block_ids: Option<Vec<String>>) -> FlowyResult<Vec<GridBlockSnapshot>> {
  325. let block_ids = match block_ids {
  326. None => self
  327. .pad
  328. .read()
  329. .await
  330. .get_block_metas()
  331. .into_iter()
  332. .map(|block_meta| block_meta.block_id)
  333. .collect::<Vec<String>>(),
  334. Some(block_ids) => block_ids,
  335. };
  336. let snapshots = self.block_meta_manager.make_block_snapshots(block_ids).await?;
  337. Ok(snapshots)
  338. }
  339. pub async fn move_item(&self, params: MoveItemParams) -> FlowyResult<()> {
  340. match params.ty {
  341. MoveItemType::MoveField => {
  342. self.move_field(params.from_index, params.to_index, &params.item_id)
  343. .await
  344. }
  345. MoveItemType::MoveRow => self.move_row(params.from_index, params.to_index, &params.item_id).await,
  346. }
  347. }
  348. pub async fn move_field(&self, from: i32, to: i32, field_id: &str) -> FlowyResult<()> {
  349. // GridFieldChangeset
  350. todo!()
  351. }
  352. pub async fn move_row(&self, from: i32, to: i32, row_id: &str) -> FlowyResult<()> {
  353. // GridRowsChangeset
  354. todo!()
  355. }
  356. pub async fn delta_bytes(&self) -> Bytes {
  357. self.pad.read().await.delta_bytes()
  358. }
  359. async fn modify<F>(&self, f: F) -> FlowyResult<()>
  360. where
  361. F: for<'a> FnOnce(&'a mut GridMetaPad) -> FlowyResult<Option<GridChangeset>>,
  362. {
  363. let mut write_guard = self.pad.write().await;
  364. if let Some(changeset) = f(&mut *write_guard)? {
  365. let _ = self.apply_change(changeset).await?;
  366. }
  367. Ok(())
  368. }
  369. async fn apply_change(&self, change: GridChangeset) -> FlowyResult<()> {
  370. let GridChangeset { delta, md5 } = change;
  371. let user_id = self.user.user_id()?;
  372. let (base_rev_id, rev_id) = self.rev_manager.next_rev_id_pair();
  373. let delta_data = delta.to_delta_bytes();
  374. let revision = Revision::new(
  375. &self.rev_manager.object_id,
  376. base_rev_id,
  377. rev_id,
  378. delta_data,
  379. &user_id,
  380. md5,
  381. );
  382. let _ = self
  383. .rev_manager
  384. .add_local_revision(&revision, Box::new(GridRevisionCompactor()))
  385. .await?;
  386. Ok(())
  387. }
  388. async fn block_id(&self) -> FlowyResult<String> {
  389. match self.pad.read().await.get_block_metas().last() {
  390. None => Err(FlowyError::internal().context("There is no grid block in this grid")),
  391. Some(grid_block) => Ok(grid_block.block_id.clone()),
  392. }
  393. }
  394. #[tracing::instrument(level = "trace", skip_all, err)]
  395. async fn notify_grid_did_insert_field(&self, field_id: &str) -> FlowyResult<()> {
  396. if let Some((index, field_meta)) = self.pad.read().await.get_field_meta(field_id) {
  397. let index_field = IndexField::from_field_meta(field_meta, index);
  398. let notified_changeset = GridFieldChangeset::insert(&self.grid_id, vec![index_field]);
  399. let _ = self.notify_did_update_grid(notified_changeset).await?;
  400. }
  401. Ok(())
  402. }
  403. #[tracing::instrument(level = "trace", skip_all, err)]
  404. async fn notify_grid_did_update_field(&self, field_id: &str) -> FlowyResult<()> {
  405. let mut field_metas = self.get_field_metas(Some(vec![field_id])).await?;
  406. debug_assert!(field_metas.len() == 1);
  407. if let Some(field_meta) = field_metas.pop() {
  408. let updated_field = Field::from(field_meta);
  409. let notified_changeset = GridFieldChangeset::update(&self.grid_id, vec![updated_field.clone()]);
  410. let _ = self.notify_did_update_grid(notified_changeset).await?;
  411. send_dart_notification(field_id, GridNotification::DidUpdateField)
  412. .payload(updated_field)
  413. .send();
  414. }
  415. Ok(())
  416. }
  417. async fn notify_did_update_grid(&self, changeset: GridFieldChangeset) -> FlowyResult<()> {
  418. send_dart_notification(&self.grid_id, GridNotification::DidUpdateGrid)
  419. .payload(changeset)
  420. .send();
  421. Ok(())
  422. }
  423. }
  424. #[cfg(feature = "flowy_unit_test")]
  425. impl ClientGridEditor {
  426. pub fn rev_manager(&self) -> Arc<RevisionManager> {
  427. self.rev_manager.clone()
  428. }
  429. }
  430. pub struct GridPadBuilder();
  431. impl RevisionObjectBuilder for GridPadBuilder {
  432. type Output = GridMetaPad;
  433. fn build_object(object_id: &str, revisions: Vec<Revision>) -> FlowyResult<Self::Output> {
  434. let pad = GridMetaPad::from_revisions(object_id, revisions)?;
  435. Ok(pad)
  436. }
  437. }
  438. struct GridRevisionCloudService {
  439. #[allow(dead_code)]
  440. token: String,
  441. }
  442. impl RevisionCloudService for GridRevisionCloudService {
  443. #[tracing::instrument(level = "trace", skip(self))]
  444. fn fetch_object(&self, _user_id: &str, _object_id: &str) -> FutureResult<Vec<Revision>, FlowyError> {
  445. FutureResult::new(async move { Ok(vec![]) })
  446. }
  447. }
  448. struct GridRevisionCompactor();
  449. impl RevisionCompactor for GridRevisionCompactor {
  450. fn bytes_from_revisions(&self, revisions: Vec<Revision>) -> FlowyResult<Bytes> {
  451. let delta = make_delta_from_revisions::<PlainTextAttributes>(revisions)?;
  452. Ok(delta.to_delta_bytes())
  453. }
  454. }
  455. struct TypeOptionJsonDeserializer(FieldType);
  456. impl JsonDeserializer for TypeOptionJsonDeserializer {
  457. fn deserialize(&self, type_option_data: Vec<u8>) -> CollaborateResult<String> {
  458. // The type_option_data sent from Dart is serialized by protobuf.
  459. let builder = type_option_builder_from_bytes(type_option_data, &self.0);
  460. let json = builder.entry().json_str();
  461. tracing::trace!("Deserialize type option data to: {}", json);
  462. Ok(json)
  463. }
  464. }