API 中的回调方法

在线编辑

Rhapsody® API 包含可用于响应 Rhapsody中发生的事件的方法。 您可以使用这些方法来触发外部应用程序中的操作。 其中一些方法还可用于阻止 Rhapsody 继续执行特定操作。

对于具有布尔值返回值的方法，客户机应用程序可以返回值 False ，以阻止 Rhapsody 继续执行连接到事件的操作，例如，阻止打开图。

注: 多个客户机可以注册任何给定回调，但是，不保证将以特定顺序通知这些客户机。 在注册了多个客户机时，如果一个客户机通过取消关联的操作进行响应，那么不会对剩余客户机调用方法。

下面这些类中包含了各种回调方法：

  • RPApplicationListener
  • RPCodeGeneratorListener
  • RPRoundTripListener

可以在 Rhapsody 安装的 Samples 目录中找到使用回调 API 来响应事件的样本客户机应用程序。 提供了多种不同语言的样本。

Rhapsody 可以记录调用的所有回调。 对于可以由客户机取消的操作，它还记录所执行的操作。 要启用对回调事件和可取消操作进行日志记录，请将变量 EnableCallbackLogging 添加到 rhapsody.ini 文件中名为 [Callback] 的部分，并将该变量的值设置为 TRUE。

启用日志记录后，事件和操作将记录到系统临时目录中名为 callback_log.txt 的文件内。

通过将变量 EnableEventListening 添加到 rhapsody.ini 文件的 [Callback] 部分，并将该变量的值设置为 False，可以完全禁用回调类提供的功能。 通过添加下列一个或多个变量并将这些变量的值设置为 FALSE，可以禁用个别回调类提供的功能：EnableApplicationEventListening、EnableCodeGenerationEventListening 和 EnableRoundTripEventListening。