首页
/ Fluid Framework v2.32.0 版本深度解析:容器优化与树形数据结构增强

Fluid Framework v2.32.0 版本深度解析:容器优化与树形数据结构增强

2025-06-12 01:28:14作者:咎竹峻Karen

项目简介

Fluid Framework 是微软开发的一个开源分布式实时协作框架,它通过提供数据同步和协作功能,使开发者能够轻松构建多人实时协作应用。该框架采用基于操作转换(OT)的算法来保证数据一致性,并支持多种后端存储服务。

核心特性更新

默认支持分离容器中的 Blob 存储

在 v2.32.0 版本中,Fluid Framework 对 Blob 存储处理进行了重要改进。现在,当容器处于分离状态(detached)时,系统会自动提供 Blob 存储支持,无需开发者手动配置 detachedBlobStorage 参数。这一变化简化了开发流程,减少了配置复杂性。

技术实现上,框架内部现在默认集成了内存 Blob 存储功能。如果开发者需要保留旧有行为,可以通过设置 Fluid.Container.MemoryBlobStorageEnabledfalse 来禁用此功能。但需要注意的是,这一配置选项和原有的 IDetachedBlobStorage 接口都将在未来的 2.40.0 版本中被移除。

数据存储和 DDS 的短 ID 支持

为了优化性能和减少存储空间占用,新版本引入了短 ID 支持机制。当开发者在 IContainerRuntimeOptions 中设置 enableRuntimeIdCompressor:"on" 时,系统会为数据存储(DataStores)和分布式数据结构(DDSes)生成更短的标识符。

这一改进带来了多重好处:

  1. 显著减小了摘要(summary)和快照(snapshot)的大小
  2. 降低了内存占用
  3. 提升了运行时性能

SharedTree DDS 增强

树形数据结构 API 清理与重构

v2.32.0 对 SharedTree 的 API 进行了重要重构,引入了新的 TreeSchema 类型,它扩展了原有的 SimpleTreeSchema 但使用 TreeNodeSchema 替代了 SimpleNodeSchema。同时新增了 TreeViewConfigurationAlpha 类型,实现了新的 TreeSchema 接口。

结构上的主要变化包括:

  • SimpleTreeSchema 现在使用 root 属性替代直接实现 SimpleFieldSchema
  • generateSchemaFromSimpleSchema 现在返回新的 TreeSchema 类型
  • 统一了编码和解析选项为 TreeEncodingOptions
  • getJsonSchema 方法现在接受 ImplicitAllowedTypes 和新的 TreeSchemaEncodingOptions

无需兼容视图模式的树内容访问

新版本增加了 ITreeAlpha 接口,允许开发者在不需要兼容视图模式的情况下访问树内容和存储模式。这一特性使得开发者能够以通用方式检查 SharedTree 中保存的内容,无论其具体模式如何。

典型使用场景包括:

  1. 动态生成适用于任何 SharedTree 的视图
  2. 实现通用的树内容检查工具
  3. 构建模式无关的树操作工具

废弃功能说明

移除 ODSP 驱动中的容器包信息参数

createOdspCreateContainerRequest() 方法中的 containerPackageInfo 参数已被标记为废弃,并将在 2.40.0 版本中移除。这一变更简化了 API 设计,将容器包名称的配置移到了 OdspDriverUrlResolverForShareLink 的构造函数中。

技术影响与最佳实践

对于现有项目的升级建议:

  1. 移除所有对 detachedBlobStorage 的显式配置
  2. 在性能敏感场景中考虑启用短 ID 功能
  3. 逐步迁移 SharedTree 相关代码到新的 API 模式
  4. 更新 ODSP 驱动相关代码,使用新的容器包名称配置方式

对于新项目开发:

  1. 直接使用默认的 Blob 存储支持
  2. 在协作场景中优先考虑启用短 ID 功能
  3. 采用新的 SharedTree API 设计数据模型
  4. 避免使用已被废弃的 API

总结

Fluid Framework v2.32.0 版本在容器管理、数据存储和树形数据结构方面都带来了重要改进。这些变化既简化了开发者的使用体验,又提升了系统性能和灵活性。特别是对 SharedTree 的增强,为构建复杂的协作数据结构提供了更强大的工具集。建议开发者根据项目需求,合理评估和采用这些新特性,同时注意及时更新已废弃的 API 使用方式。

登录后查看全文
热门项目推荐
相关项目推荐