apache > ws.apache

## Apache Muse - WS-BaseNotification - NotificationConsumer Capability

Spec name and port type: WS-BaseNotification v1.3, NotificationConsumer (WSDL)

Capability URI: http://docs.oasis-open.org/wsn/bw-2/NotificationConsumer

Description: This capability exposes the WS-N Notify operation and provides a simple message listener API to other server-side components. Programmers can subscribe a resource that exposes this capability to messages from another resource(s) and then respond to incoming messages using the listener framework without having to write any message filtering code.

Java interface: org.apache.muse.ws.notification.NotificationConsumer

> JAR file: muse-wsn-api.jar

Default Java implementation: org.apache.muse.ws.notification.impl.SimpleNotificationConsumer

> JAR file: muse-wsn-impl.jar

Action on initialize(): Registers a serializer for the NotificationMessage type, which is used in the method signature of the Notify operation.

Action on initializeCompleted(): None.

Action on prepareShutdown(): None.

Action on shutdown(): None.

Non-Core Dependencies: None.

Behavior and Limitations: The implementation of notify() spawns a new thread for every message it receives and immediately returns. The thread loops through all of the current message listeners in the order that they were added and gives them a chance to process the message. Per the spec, no faults are thrown, no matter what content is found in the message(s); the implementation simply logs the error and continues.

Initialization parameters: None.