Web Services Brokered Notification 1.3
(WS-BrokeredNotification)

OASIS Standard, 1 October 2006

 

Document identifier:

wsn-ws_brokered_notification-1.3-spec-os

Location:

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

Editors:

Dave Chappell, Sonic Software <chappell@sonicsoftware.com>

Lily Liu, webMethods <lily.liu@webmethods.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].

This document defines the Web services interface for the NotificationBroker. A NotificationBroker is an intermediary that, among other things, allows publication of messages from entities that are not themselves service providers. It includes standard message exchanges to be implemented by NotificationBroker service providers along with operational requirements expected of service providers and requestors that participate in brokered notifications. This work relies upon WS-BaseNotification.

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_brokered_notification-1.3-errata.pdf

 


Table of Contents

1      Introduction. 4

1.1 Goals and Requirements. 4

1.1.1 Requirements. 4

1.1.2 Non-Goals. 5

1.2 Notational Conventions. 5

1.3 Namespaces. 6

1.4 Fault Definitions. 7

2      Relationship to Other Specifications. 8

3      Terminology and Concepts. 9

4      Publishing. 12

5      NotificationBroker Interface. 15

5.1 NotificationBroker Resource Properties. 15

5.2 Notify. 16

5.3 Subscribe. 16

5.4 GetCurrentMessage. 16

5.5 RegisterPublisher 16

5.6 CreatePullPoint 17

6      RegisterPublisher Interface. 18

6.1 RegisterPublisher 18

6.1.1 Example SOAP Encoding of the RegisterPublisher Message Exchange. 21

7      PublisherRegistrationManager Interface. 24

7.1 PublisherRegistration Resource Properties. 24

7.2 DestroyRegistration. 25

7.2.1 Example SOAP Encoding of the DestroyRegistration Message Exchange. 26

8      Security Considerations. 27

8.1 Securing PublisherRegistration. 27

9      References. 28

9.1 Normative. 28

9.2 Non-Normative. 28

Appendix A. Acknowledgments. 30

Appendix B. XML Schema. 31

Appendix C. WSDL 1.1. 36

Appendix D. Revision History. 41

Appendix E. Notices. 43