1.5. Client API

Figure 1.4, “Client APIs” gives an overview of the available APIs for programing WS-Notification clients.

Clients can be implemented using the standard WS-Notification API, which is obtained by mapping the standard WSDL interfaces to Java the JAX-WS and JAX-B. This has the advantage that you can use standard client code to access the notification broker (ensuring code portability), but it has the disadvantage that the standard API is relatively complicated to program with.

To simplify working with the notification broker, JBoss A-MQ offers a simplified (non-standard) client API for accessing the notification broker. This API automatically takes care of tedious manipulation of JAX-B data types. Using this API, you typically require just a few method calls to implement a basic WS-Notification client.

For example, see the client code samples in Chapter 2, WS-Notification Tutorial.

The full API reference for the simplified client API is provided in the Apache CXF API Reference, which is available from the API Reference in the JBoss Fuse library. All of the relevant classes can be found in the following Java package:

org.apache.cxf.wsn.client