grid_editor.rs 17 KB

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