1. 服务类型相关的操作支持
方法(Method)
-
服务端:服务应用程序可以在 API 的基础上定义并实现能够执行特定操作且返回值的函数,例如在示例中的
Calibrate
方法,它接收一个配置字符串作为输入,经过内部处理后返回一个成功指示符作为输出。 -
客户端:客户端应用程序可以通过 API 提供的接口调用服务端的方法,如发起对服务端
Calibrate
方法的调用,传递相应的配置字符串参数,并获取服务端返回的处理结果。
事件(Event)
-
服务端:当服务应用程序中特定条件发生时(如示例中的
BrakeEvent
,当制动相关的条件满足时),它可以通过 API 发送包含特定值的事件。 -
客户端:客户端可以使用 API 提供的接口订阅服务端发出的事件,当服务端有相应事件发送时,客户端能够接收到这些事件并进行后续处理。
字段(Field)
-
服务端:服务应用程序可以定义具有特定值的字段(如
UpdateRate
),这些字段的值可以被修改(通过 set 操作)或者被读取(通过 get 操作)。 -
客户端:客户端可以通过 API 注册处理程序来响应服务端字段值的变化,同时也可以通过 API 提供的接口读取服务端字段的值(get 操作)或者修改其值(set 操作)。
2. 实例管理方面的支持
-
创建和销毁:API 定义了构造函数(ctors)和析构函数(dtor),用于创建和销毁代理类(Proxy Class)和骨架类(Skeleton Class)的实例。这使得客户端和服务端可以方便地管理与服务交互相关的实例,确保资源的合理分配和释放。例如,服务端在启动时可以创建服务实例,而在服务停止时可以销毁实例,客户端在连接服务时创建代理实例,在断开连接时销毁代理实例。
3. 服务管理方面的支持
-
提供和查找服务:API 提供了相应的方法来实现服务的提供和查找。服务端可以通过 API 将自身提供的服务注册到系统中,使得客户端能够发现这些服务;客户端则可以通过 API 提供的查找服务的方法,根据特定的条件(如服务类型、服务名称等)在系统中查找所需的服务,并获取服务的引用或者代理,从而建立与服务端的连接。
-
订阅和取消订阅事件:除了上述对事件的基本操作支持外,API 还专门提供了订阅和取消订阅事件的方法。客户端可以根据自身的需求,在需要接收特定事件时通过 API 进行订阅,当不再需要接收该事件时,可以通过 API 取消订阅,从而灵活地控制对服务端事件的接收。