grid_editor.rs 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484
  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 create_field(&self, params: CreateFieldParams) -> FlowyResult<()> {
  51. let CreateFieldParams {
  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. todo!()
  244. }
  245. pub async fn duplicate_row(&self, row_id: &str) -> FlowyResult<()> {
  246. todo!()
  247. }
  248. pub async fn get_cell(&self, params: &CellIdentifier) -> Option<Cell> {
  249. let field_meta = self.get_field_meta(&params.field_id).await?;
  250. let row_meta = self.block_meta_manager.get_row_meta(&params.row_id).await.ok()??;
  251. make_cell(&params.field_id, &field_meta, &row_meta)
  252. }
  253. pub async fn get_cell_meta(&self, row_id: &str, field_id: &str) -> FlowyResult<Option<CellMeta>> {
  254. let row_meta = self.block_meta_manager.get_row_meta(row_id).await?;
  255. match row_meta {
  256. None => Ok(None),
  257. Some(row_meta) => {
  258. let cell_meta = row_meta.cells.get(field_id).cloned();
  259. Ok(cell_meta)
  260. }
  261. }
  262. }
  263. pub async fn update_cell(&self, mut changeset: CellMetaChangeset) -> FlowyResult<()> {
  264. if changeset.data.as_ref().is_none() {
  265. return Ok(());
  266. }
  267. let cell_data_changeset = changeset.data.unwrap();
  268. let cell_meta = self.get_cell_meta(&changeset.row_id, &changeset.field_id).await?;
  269. match self.pad.read().await.get_field(&changeset.field_id) {
  270. None => {
  271. let msg = format!("Field not found with id: {}", &changeset.field_id);
  272. Err(FlowyError::internal().context(msg))
  273. }
  274. Some(field_meta) => {
  275. // Update the changeset.data property with the return value.
  276. changeset.data = Some(apply_cell_data_changeset(cell_data_changeset, cell_meta, field_meta)?);
  277. let _ = self.block_meta_manager.update_cell(changeset).await?;
  278. Ok(())
  279. }
  280. }
  281. }
  282. pub async fn get_blocks(&self, block_ids: Option<Vec<String>>) -> FlowyResult<RepeatedGridBlock> {
  283. let block_snapshots = self.grid_block_snapshots(block_ids.clone()).await?;
  284. make_grid_blocks(block_ids, block_snapshots)
  285. }
  286. pub async fn get_block_metas(&self) -> FlowyResult<Vec<GridBlockMeta>> {
  287. let grid_blocks = self.pad.read().await.get_block_metas();
  288. Ok(grid_blocks)
  289. }
  290. // pub async fn get_field_metas<T>(&self, field_ids: Option<Vec<T>>) -> FlowyResult<Vec<FieldMeta>>
  291. // where
  292. // T: Into<FieldOrder>,
  293. // {
  294. pub async fn delete_rows(&self, row_orders: Vec<RowOrder>) -> FlowyResult<()> {
  295. let changesets = self.block_meta_manager.delete_rows(row_orders).await?;
  296. for changeset in changesets {
  297. let _ = self.update_block(changeset).await?;
  298. }
  299. Ok(())
  300. }
  301. pub async fn grid_data(&self) -> FlowyResult<Grid> {
  302. let field_orders = self.pad.read().await.get_field_orders();
  303. let block_orders = self
  304. .pad
  305. .read()
  306. .await
  307. .get_block_metas()
  308. .into_iter()
  309. .map(|grid_block_meta| GridBlockOrder {
  310. block_id: grid_block_meta.block_id,
  311. })
  312. .collect::<Vec<_>>();
  313. Ok(Grid {
  314. id: self.grid_id.clone(),
  315. field_orders,
  316. block_orders,
  317. })
  318. }
  319. pub async fn grid_block_snapshots(&self, block_ids: Option<Vec<String>>) -> FlowyResult<Vec<GridBlockSnapshot>> {
  320. let block_ids = match block_ids {
  321. None => self
  322. .pad
  323. .read()
  324. .await
  325. .get_block_metas()
  326. .into_iter()
  327. .map(|block_meta| block_meta.block_id)
  328. .collect::<Vec<String>>(),
  329. Some(block_ids) => block_ids,
  330. };
  331. let snapshots = self.block_meta_manager.make_block_snapshots(block_ids).await?;
  332. Ok(snapshots)
  333. }
  334. pub async fn delta_bytes(&self) -> Bytes {
  335. self.pad.read().await.delta_bytes()
  336. }
  337. async fn modify<F>(&self, f: F) -> FlowyResult<()>
  338. where
  339. F: for<'a> FnOnce(&'a mut GridMetaPad) -> FlowyResult<Option<GridChangeset>>,
  340. {
  341. let mut write_guard = self.pad.write().await;
  342. if let Some(changeset) = f(&mut *write_guard)? {
  343. let _ = self.apply_change(changeset).await?;
  344. }
  345. Ok(())
  346. }
  347. async fn apply_change(&self, change: GridChangeset) -> FlowyResult<()> {
  348. let GridChangeset { delta, md5 } = change;
  349. let user_id = self.user.user_id()?;
  350. let (base_rev_id, rev_id) = self.rev_manager.next_rev_id_pair();
  351. let delta_data = delta.to_delta_bytes();
  352. let revision = Revision::new(
  353. &self.rev_manager.object_id,
  354. base_rev_id,
  355. rev_id,
  356. delta_data,
  357. &user_id,
  358. md5,
  359. );
  360. let _ = self
  361. .rev_manager
  362. .add_local_revision(&revision, Box::new(GridRevisionCompactor()))
  363. .await?;
  364. Ok(())
  365. }
  366. async fn block_id(&self) -> FlowyResult<String> {
  367. match self.pad.read().await.get_block_metas().last() {
  368. None => Err(FlowyError::internal().context("There is no grid block in this grid")),
  369. Some(grid_block) => Ok(grid_block.block_id.clone()),
  370. }
  371. }
  372. async fn notify_did_update_grid(&self) -> FlowyResult<()> {
  373. let field_metas = self.get_field_metas::<FieldOrder>(None).await?;
  374. let repeated_field: RepeatedField = field_metas.into_iter().map(Field::from).collect::<Vec<_>>().into();
  375. send_dart_notification(&self.grid_id, GridNotification::DidUpdateGrid)
  376. .payload(repeated_field)
  377. .send();
  378. Ok(())
  379. }
  380. #[tracing::instrument(level = "trace", skip_all, err)]
  381. async fn notify_did_update_field(&self, field_id: &str) -> FlowyResult<()> {
  382. let mut field_metas = self.get_field_metas(Some(vec![field_id])).await?;
  383. debug_assert!(field_metas.len() == 1);
  384. if let Some(field_meta) = field_metas.pop() {
  385. send_dart_notification(&field_id, GridNotification::DidUpdateField)
  386. .payload(field_meta)
  387. .send();
  388. }
  389. Ok(())
  390. }
  391. }
  392. #[cfg(feature = "flowy_unit_test")]
  393. impl ClientGridEditor {
  394. pub fn rev_manager(&self) -> Arc<RevisionManager> {
  395. self.rev_manager.clone()
  396. }
  397. }
  398. pub struct GridPadBuilder();
  399. impl RevisionObjectBuilder for GridPadBuilder {
  400. type Output = GridMetaPad;
  401. fn build_object(object_id: &str, revisions: Vec<Revision>) -> FlowyResult<Self::Output> {
  402. let pad = GridMetaPad::from_revisions(object_id, revisions)?;
  403. Ok(pad)
  404. }
  405. }
  406. struct GridRevisionCloudService {
  407. #[allow(dead_code)]
  408. token: String,
  409. }
  410. impl RevisionCloudService for GridRevisionCloudService {
  411. #[tracing::instrument(level = "trace", skip(self))]
  412. fn fetch_object(&self, _user_id: &str, _object_id: &str) -> FutureResult<Vec<Revision>, FlowyError> {
  413. FutureResult::new(async move { Ok(vec![]) })
  414. }
  415. }
  416. struct GridRevisionCompactor();
  417. impl RevisionCompactor for GridRevisionCompactor {
  418. fn bytes_from_revisions(&self, revisions: Vec<Revision>) -> FlowyResult<Bytes> {
  419. let delta = make_delta_from_revisions::<PlainTextAttributes>(revisions)?;
  420. Ok(delta.to_delta_bytes())
  421. }
  422. }
  423. struct TypeOptionJsonDeserializer(FieldType);
  424. impl JsonDeserializer for TypeOptionJsonDeserializer {
  425. fn deserialize(&self, type_option_data: Vec<u8>) -> CollaborateResult<String> {
  426. // The type_option_data sent from Dart is serialized by protobuf.
  427. let builder = type_option_builder_from_bytes(type_option_data, &self.0);
  428. Ok(builder.entry().json_str())
  429. }
  430. }