Web Services Base Notification 1.3
(WS-BaseNotification)

OASIS Standard, 1 October 2006

 

Document identifier

wsn-ws_base_notification-1.3-spec-os

Location:

http://docs.oasis-open.org/wsn/wsn-ws_base_notification-1.3-spec-os.pdf

Editors:

Steve Graham, IBM <sggraham@us.ibm.com>

David Hull, Tibco <dmh@tibco.com>

Bryan Murray, Hewlett-Packard Company <bryan.murray@hp.com>

Abstract:

The Event-driven, or Notification-based, interaction pattern is a commonly used pattern for inter-object communications. Examples exist in many domains, for example in publish/subscribe systems provided by Message Oriented Middleware vendors, or in system and device management domains. This notification pattern is increasingly being used in a Web services context.

WS-Notification is a family of related specifications that define a standard Web services approach to notification using a topic-based publish/subscribe pattern. It includes: standard message exchanges to be implemented by service providers that wish to participate in Notifications, standard message exchanges for a notification broker service provider (allowing publication of messages from entities that are not themselves service providers), operational requirements expected of service providers and requestors that participate in notifications, and an XML model that describes topics. The WS-Notification family of documents includes three normative specifications: WS-BaseNotification, [WS-BrokeredNotification], and [WS-Topics].

Status:

This document is an OASIS standard.

Committee members should send comments on this specification to the wsn@lists.oasis-open.org list. Others may submit comments to the TC via the web form found on the TC's web page at http://www.oasis-open.org/committees/wsn. Click the button for "Send A Comment" at the top of the page. Submitted comments (for this work as well as other works of the TC) are publicly archived and can be viewed at:
http://lists.oasis-open.org/archives/wsn-comment/.

For information on whether any patents have been disclosed that may be essential to implementing this specification, and any offers of patent licensing terms, please refer to the Intellectual Property Rights section of the WSN TC web page (http://www.oasis-open.org/committees/wsn/).

The errata document for this specification is maintained at:
http://docs.oasis-open.org/wsn/wsn-ws_base_notification-1.3-errata.pdf


Table of Contents

1      Introduction. 5

1.1 Goals and Requirements. 5

1.1.1 Requirements. 5

1.1.2 Non-Goals. 6

1.2 Terminology. 6

1.3 Namespaces. 7

1.4 Fault Definitions. 8

2      Terminology and Concepts. 9

2.1 Definitions. 9

2.2 Production vs. Delivery. 10

3      NotificationConsumer Interface. 11

3.1 Notification Metadata. 11

3.2 Notify. 12

3.2.1 Example SOAP Encoding of the Notify Message. 13

4      NotificationProducer Interface. 14

4.1 NotificationProducer Resource Properties. 14

4.2 Subscribe. 15

4.2.1 Example SOAP Encoding of the Subscribe Message Exchange. 21

4.3 GetCurrentMessage. 22

4.3.1 Example SOAP Encoding of the GetCurrentMessage Message Exchange. 24

5      Pull-Style Notification. 25

5.1 PullPoint Interface. 25

5.1.1 Accumulating Notification Messages. 25

5.1.2 GetMessages. 26

5.1.3 Example SOAP Encoding of the GetMessages Message Exchange.