Microsoft 信息保护 SDK - 观察程序概念

MIP SDK 几乎完全采用异步方式。 例如,SDK 执行任何导致网络或文件 I/O 异步的操作。 为了处理这些异步事件的事件通知,SDK 使用 观察程序模式。

实现概述

构造执行异步操作的对象时,实现类 Observer 。 观察程序接收与 MIP SDK 中各种异步操作相关的通知事件,并向调用方提供结果。

你可以在各个 Observer 类中重写虚函数,以实现首选的异步模式。 SDK 使用 std::promise 和 std::future实现事件通知观察程序模式。

每个类专用观察器都包含一组针对异步操作结果的成功和错误/失败处理函数。 “成功”功能会返回与操作关联的对象。 “错误”/“失败”功能会返回一个异常,其中包含有关操作失败原因的详细信息。

例如, FileProfile 支持以下两个操作:

  • 它可以通过使用 FileProfile::AddEngineAsync 向配置文件添加一个新引擎。
  • 它可以通过使用 FileProfile::UnloadEngineAsync 从配置文件中卸载引擎。

由于 SDK 为每个异步操作实现两 Observer 个函数,因此可以假定 四Observer 种方法与 FileProfile以下两种方法相关联:

  • FileProfileObserver::OnAddEngineSuccess()
  • FileProfileObserver::OnAddEngineError()
  • FileProfileObserver::OnUnloadEngineSuccess
  • FileProfileObserver::OnUnloadEngineError()

MIP SDK 观察者类

MIP 文件 SDK 包含两个观察者:

  • mip::FileProfile::Observer
  • mip::FileHandler::Observer

MIP 策略 SDK 有一个观察程序:

  • mip::Profile::Observer

MIP 保护 SDK 有三个观察者:

  • mip::ProtectionProfile::Observer
  • mip::ProtectionEngine::Observer
  • mip::ProtectionHandler::Observer

后续步骤

详细了解各种 SDK 如何实现和使用观察程序: