WebSphere WebSphere Application Server Network Deployment, Version 6.1.x Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows, z/OS

WS-Notification - how client applications interact at runtime

Applications interact with the notification broker through the Web service message exchanges defined in the WS-Notification specifications.

The following diagram shows the WS-Notification roles:

There are five boxes, one for each WS-Notification role. Four of the boxes are arranged as two pairs, and each pair is connected by an arrow to show that the "notification broker" role uses the "publisher registration manager" role, and the "notification producer" role uses the "subscription manager" role. The fifth role is the "notification consumer" role.

These roles equate to three Web service port types against which the application can invoke operations:

The first point of contact for an application will always be the NotificationBroker port type. Applications invoke operations against this endpoint to create subscriptions, insert notification events into the system or register themselves as publishers. The SubscriptionManager and PublisherRegistrationManager objects work with the NotificationBroker to provide the overall functionality.

References to the SubscriptionManager and PublisherRegistrationManager are returned to the application as a result of calls to the NotificationBroker. In particular a reference to the SubscriptionManager is returned from the Subscribe operation of the NotificationBroker. This allows an application to influence the lifecycle of the Subscription resource once it has been created. Similarly a reference to the PublisherRegistrationManager is returned from the RegisterPublisher operation on the NotificationBroker and allows the application to influence the lifecycle of the publisher registration.

Because applications interact with the broker entirely through WS-Notification message exchanges, the applications are unaware that the NotificationBroker, SubscriptionManager and PublisherRegistrationManager services are provided by WebSphere Application Server. This means that you can modify the application to use any NotificationBroker provider, for example one provided by a different vendor or on a different server, by modifying the endpoint address against which the application makes its Web services invocations.

WS-Notification defines the following roles in which an application can interact with the NotificationBroker. These roles define the use cases for applications.

Publisher
A Publisher sends a notification message to a Broker or NotificationConsumer in order to insert event notifications into the system. A Publisher application does not expose a Web service endpoint.
Subscriber
A Subscriber makes a subscription on behalf of a (possibly different) NotificationConsumer application. A Subscriber application exposes a Web service endpoint.
NotificationConsumer
A NotificationConsumer receives notification messages:
  • A "Push Consumer" application exposes a Web services endpoint to which the notification message can be asynchronously sent by the Broker and NotificationProducer.
  • A "Pull Consumer" application invokes an operation on the Broker and NotificationProducer in order to receive a Notification Message.
NotificationProducer
A NotificationProducer sends notification messages to registered NotificationBrokers and NotificationConsumers. A NotificationProducer application exposes a Web service endpoint to support the Subscribe operation and provide access to NotificationProducer resource properties.
Demand based publisher
A demand based publisher is a Publisher application that also exposes a Web service endpoint (as a NotificationProducer) so as to receive pause or resume requests.

You can use any appropriate tooling to generate WS-Notification applications for use with the NotificationBroker. You take the WSDL exposed by a WS-Notification service point and use a development tool such as IBM Rational Application Developer to generate JAX-RPC stubs against which the application can be coded. For examples of this type of coding, see Developing applications that use WS-Notification.

Related tasks
WS-Notification - publish and subscribe messaging for Web services
Learning about WS-Notification
Securing WS-Notification
Related reference
Events and service-oriented architecture: The OASIS Web Services Notification specifications
OASIS Web Services Notification (WSN) technical committee
WS-Notification troubleshooting tips

Concept topic

Terms of use | Feedback


Timestamp icon Last updated: 26 February 2009
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.pmc.nd.multiplatform.doc/concepts/cjwsn_interact.html

Copyright IBM Corporation 2004, 2009. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)