9.3 Basic Notification Interface
Section 9.3.1 briefly introduces the Basic Notification Interface of the [WS-BaseNotification] specification. Section 9.3.2 summarizes the mandatory and the optional interfaces of the [WS BaseNotification] specification. Please refer for a full documentation of the Basic Notification Interface to the [WS-BaseNotification] specification.
第9.3.1节简要介绍了[WS-BaseNotification]规范的基本通知接口。 第9.3.2节概述了[WS BaseNotification]规范的强制性和可选接口。 请参考[WS-BaseNotification]规范的基本通知接口的完整文档。
9.3.1 Introduction
以下逻辑实体(entities)参与了通知模式(pattern):
客户端:实现NotificationConsumer接口。
事件服务(Service):实现NotificationProducer接口。
订阅管理器:实现BaseSubscriptionManager接口。
事件服务和订阅管理器应在设备上实例化。
图6的时序图中显示了实体之间交换的典型消息。首先,客户端建立与事件服务的连接。然后,客户端可以通过发送SubscriptionRequest订阅某些通知。如果事件服务接受订阅,则它将动态实例化代表该订阅的SubscriptionManager。事件服务应在SubscriptionResponse中返回SubscriptionManager的WS-Endpoint-Address。
为了传输与订阅匹配的通知,从事件服务到客户端建立了另一个连接。通过此连接,事件服务将单向通知消息发送到客户端的NotificationConsumer接口。订阅处于活动状态时,事件服务可以随时将相应的通知发送到客户端。
为了控制Subscription,客户端可以直接寻址SubscriptionResponse中返回的SubscriptionManager。客户端可以在SubscriptionRequest中指定终止时间。达到终止时间后,SubscriptionManager会自动销毁。客户端可以发起RenewRequest,以延迟终止时间。客户端还可以通过发送UnsubscribeRequest显式终止SubscriptionManager。成功取消订阅后,SubscriptionManager不再存在。
[WS-BaseNotification]不进一步指定EventService和SubscriptionManager之间的交互,并且取决于设备的实现。
9.3.2 Requirements
本节详细介绍了设备应提供的[WS-BaseNotification]的那些接口。
如果功能MaxNotificationProducers不为零,则符合ONVIF的设备应支持[WS BaseNotification]的NotificationProducer接口。
设备应支持带有9.6.3中描述的方言(dialects)的TopicExpression过滤器。
通过GetEventProperties方法表示对MessageContent筛选器(filters)的支持。
如果设备不接受某个subscription的InitialTerminationTime,则它将在故障消息中提供有效的InitialTerminationTime。
设备应能够使用[WS-BaseNotification]规范的Notify包装器(wrapper)提供通知。
SubscriptionPolicy wsnt:UseRaw对于设备是可选的。
尽管[WS BaseNotification]在SubscribeResponse和RenewResponse中将CurrentTime和TerminationTime作为可选元素,但兼容ONVIF的设备应在SubscribeResponses和RenewResponse中列出它们。设备可以使用任何故障消息来响应任何GetCurrentMessage请求,该故障消息指示在请求的主题上没有可用的当前消息。
设备上[WS-BaseNotification]的Pull-Point接口的实现是可选的。
兼容ONVIF的设备应实现[WS-BaseNotification]规范的基本订阅管理器接口,该接口由Renew和Unsubscribe操作组成。暂停订阅管理器界面是可选的。如同(as)WS-Resources的订阅的实现是可选的。
符合ONVIF要求的设备应支持utc中带有Z指示符的请求参数中的时间值,并响应包括Z指示符的utc响应所有时间值。