grid_editor.rs 19 KB

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