使用 SOLIDWORKS API 在第三方存储中保存数据
第三方存储和第三方存储是外部应用程序(插件、宏、独立应用程序)用于在模型流中直接存储序列化数据的容器。
这种技术允许存储复杂的数据,并提供读写大量数据的最佳性能选项。
SOLIDWORKS 可以将数据存储在两个不同的容器中:
- 存储(流)
- 存储存储
如果将文件系统作为类比,存储将对应文件,而存储存储将对应文件夹。存储存储可以有子流或子存储。
下图解释了 SOLIDWORKS 模型存储的结构。红色元素表示由 SOLIDWORKS 直接管理的容器,而其他元素表示由第三方管理的容器。
{ width=550 }
第三方存储
这是一个通过 IStream 接口管理的容器。当应用程序只需要存储单个数据结构(例如 XML 树、文本、图像、二进制数据)时,可以使用此选项。
为了获取流的指针(用于读取或写入),需要调用 IModelDoc2::IGet3rdPartyStorage SOLIDWORKS API 方法并传递相应的标志。
注意事项
- 如果流以前从未被写入过,则 IModelDoc2::IGet3rdPartyStorage 方法返回 null。
- 在调用获取方法后,无论获取方法是否返回 null(即流以前未存储),都应始终释放流,使用 IModelDoc2::IRelease3rdPartyStorage 方法。
- 存储数据时不应调用 IStream::Commit 方法,否则将引发“方法未实现”异常。
生命周期
存储在 LoadFromStorage 通知和模型销毁之间可供读取。LoadFromStorageStore 可用于 part、assembly 和 drawing。
只有在 SaveToStorage 通知中,才能将存储用于写入 part、assembly 和 drawing。
第三方存储存储
这是一个通过 IStorage 接口管理的容器。当应用程序管理复杂的数据集并需要在特定时间访问某些部分时,可以使用此选项。存储容器允许创建子流和子存储以管理数据,并且只有在需要时才能访问特定流,避免将整个结构加载到内存中的需要。
要获取存储的指针,需要调用 IModelDocExtension::IGet3rdPartyStorageStore SOLIDWORKS API 方法。
注意事项
- 对于以前从未写入过的存储,IModelDocExtension::IGet3rdPartyStorageStore 返回 null。
- 与流类似,存储始终需要通过 IModelDocExtension::IRelease3rdPartyStorageStore 方法释放。
- 使用 IStorage 接口的方法创建子流和存储。
生命周期
存储在 LoadFromStorageStore 通知和模型销毁之间可供读取。LoadFromStorageStore 可用于 part、assembly 和 drawing。
只有在 SaveToStorageStore 通知中,才能将存储用于写入 part、assembly 和 drawing。
用法
通常,在添加功能(例如电气数据、PDM、安全性等)补充模型时,插件会使用第三方容器(存储和存储)。在这种情况下,此附加信息通常显示在特征树、任务窗格等中,并在打开模型时加载,并与模型一起保存,使此方法成为完全集成的解决方案。
SOLIDWORKS API 通知 SaveToStorage 和 SaveToStorageStore 直接在文件保存通知之后触发,这意味着无需实现自定义数据保存,因为它将通过用户保存自动触发。
最佳的附加保存和加载事件的位置应该在 DocumentLoadNotify 事件中。
当第三方数据被修改时(例如用户在第三方树中添加了新节点),建议通过 IModelDoc2::SetSaveFlag 将模型标记为脏,以指示需要用户保存模型。
存储和流命名冲突
存储和存储通过相应的名称访问。不同的开发人员可能对存储或存储使用相同的名称,这可能会导致冲突。在使用第三方容器时,建议通过 SOLIDWORKS API Support 注册存储或存储名称,并保留此名称。
有关如何使用 SwEx.AddIn 框架访问第三方容器的信息,请参阅 在 SOLIDWORKS 模型中使用 SwEx.AddIn 框架存储第三方数据 文章。