Preparing a migrated Version 6.1 WS-Notification configuration for reliable notification

We can gradually introduce JAX-WS based client and provider entities such that a migrated Version 6.1 WS-Notification configuration is ready to be configured for reliable notification.

This topic assumes that we have an existing server or cluster installation of WAS v7 or later, including at least one WS-Notification service, service point, and underlying service integration bus that has been migrated to this version of the product as described in Migrate a Version 6.1 WS-Notification configuration from WAS v6.1 to Version 7.0 or later.

For reliable notification, you apply policy sets that include WS-ReliableMessaging to the WS-Notification configuration. We can only use policy sets with Java API for XML-based Web Services (JAX-WS) applications, and with Version 7.0 WS-Notification services and service points.

The WS-Notification implementation in WAS v6.1 uses service integration bus-enabled web services to expose the WS-Notification service endpoint, so that it can be invoked by applications and configured with specific attributes such as WS-Security or JAX-RPC handlers. However, the Version 6.1 implementation is not compatible with JAX-WS handlers or applications, and it cannot compose with WS-ReliableMessaging.

To prepare a migrated Version 6.1 WS-Notification configuration for reliable notification, you must recreate the Version 6.1 WS-Notification services and service points as Version 7.0 WS-Notification services and service points, and recreate each JAX-RPC client application to which to apply a policy set as a JAX-WS application. Note that we can continue to use JAX-RPC applications with Version 7.0 WS-Notification services and service points, and that you only have to recreate those applications that must work with policy sets.

For information about coding JAX-RPC and JAX-WS client applications to perform specific WS-Notification tasks, see Develop applications that use WS-Notification. We might also find it useful to learn about JAX-WS and the JAX-WS client programming model. This should help you to determine the effort involved in porting client code from JAX-RPC to JAX-WS, or to validate JAX-WS client to JAX-RPC web service interoperability.

To support a phased approach to preparing for reliable notification, and to describe the four main configurations that you might want to achieve, this task is divided into four subtasks:

• Use JAX-WS clients and web services with migrated service points.

• Use JAX-RPC clients and web services with new Version 7.0 WS-Notification service points.

• Use JAX-WS clients and web services with new Version 7.0 WS-Notification service points.

• Share notifications between Version 6.1 and Version 7.0 WS-Notification service points.

What to do next

After completing these subtasks, we have a collection of WS-Notification client and server entities that are prepared for reliable notification, and you are ready to configure WS-Notification for reliable notification.

Use JAX-WS clients and web services with migrated service points

1. Publish notification messages through a migrated Version 6.1 WS-Notification service point, from a JAX-WS client application.

   1. Create a JAX-WS WS-Notification client application using the WSDL of the migrated service point.

      For more information, see Example: Publishing a WS-Notification message, Develop a JAX-WS client from a WSDL file and Publish the WSDL files for a WS-Notification application to a compressed file.

   2. Run the application.

   3. Initiate one or more notification messages.
   The system accepts and publishes the notification messages from the JAX-WS client.

2. Receive notification messages in a new JAX-WS based WS-Notification consumer application, from a migrated Version 6.1 WS-Notification service point.

   This validates that the Version 6.1 WS-Notification service point can deliver notifications to a JAX-WS consumer web service.

   1. Create a new JAX-WS based WS-Notification consumer web service from the standard WS-Notification WSDL.

      For more information, see Example: Subscribing a WS-Notification consumer, Implement web services applications from existing WSDL files with JAX-WS and Publish the WSDL files for a WS-Notification application to a compressed file.

   2. Create a subscription for the new consumer service through the Version 6.1 WS-Notification service point.

   3. Prompt the WS-Notification service point to generate notifications (for example by using a WS-Notification client application).
   The system transmits the notifications to the new JAX-WS consumer application correctly.

Use JAX-RPC clients and web services with new Version 7.0 WS-Notification service points

1. Create a new Version 7.0 WS-Notification service.

   We can configure a Version 7.0 WS-Notification service and service points with policy sets to compose with WS-ReliableMessaging for reliable notification. The system creates and configures a new Version 7.0 WS-Notification service. This includes the creation of a Version 7.0 WS-Notification service point that exposes the service from a particular service integration bus member. Version 6.1 and Version 7.0 WS-Notification service points can coexist in WAS v7 or later.

2. Publish notification messages through the new Version 7.0 WS-Notification service point, from a JAX-RPC client application.

   This validates the behavior of the Version 7.0 WS-Notification service point.

   1. Create the application using the WSDL of the new Version 7.0 WS-Notification service point.

      For more information, see Example: Publishing a WS-Notification message, Develop client bindings from a WSDL file for a JAX-RPC Web services client and Publish the WSDL files for a WS-Notification application to a compressed file.

      Instead of creating a new JAX-RPC client application, you might choose to update an existing JAX-RPC client application from the WSDL of the new service point. The WSDL for a Version 7.0 WS-Notification service point contains a number of minor changes compared to a Version 6.1 service point, so modify the existing JAX-WS client application to take account of these changes. Specifically, you must regenerate the java proxy classes from the WSDL, and update any use of class names and methods that have changed. For example, there might be changes in the generated classes that include a port type or service from the WSDL.

   2. Run the application.

   3. Initiate one or more notification messages.
   The system accepts and publishes the notification messages from the JAX-RPC client.

3. Receive notification messages in a JAX-RPC based WS-Notification consumer application, from the new Version 7.0 WS-Notification service point.

   This validates that the Version 7.0 WS-Notification service point can deliver notifications to a JAX-RPC consumer web service.

   1. Create a new JAX-RPC based WS-Notification consumer web service from the standard WS-Notification WSDL.

      For more information, see Example: Subscribing a WS-Notification consumer, Implement web services applications from existing WSDL files with JAX-WS and Publish the WSDL files for a WS-Notification application to a compressed file.

      Instead of creating a new JAX-RPC consumer application, we can use an existing JAX-RPC consumer application from (for example) a Version 6.1 WS-Notification configuration.

   2. Create a subscription for the new consumer service through the new Version 7.0 WS-Notification service point.

   3. Prompt the WS-Notification service point to generate notifications (for example by using a WS-Notification client application).
   The system transmits the notifications to the new JAX-RPC consumer application correctly.

Use JAX-WS clients and web services with new Version 7.0 WS-Notification service points

Note that with this configuration we can compose with policy sets for reliable notification.

1. Publish notification messages through the new Version 7.0 WS-Notification service point, from a JAX-WS client application.

   1. Create a JAX-WS WS-Notification client application using the WSDL of the new Version 7.0 WS-Notification service point.

      For more information, see Example: Publishing a WS-Notification message, Develop a JAX-WS client from a WSDL file and Publish the WSDL files for a WS-Notification application to a compressed file.

      Instead of creating a new JAX-WS client application, you might choose to update the JAX-WS client application created in the subtask Use JAX-WS clients and web services with migrated service points. The WSDL for a Version 7.0 WS-Notification service point contains a number of minor changes compared to a Version 6.1 service point, so modify the existing JAX-WS client application to take account of these changes. Specifically, you must regenerate the java proxy classes from the WSDL, and update any use of class names and methods that have changed. For example, there might be changes in the generated classes that include a port type or service from the WSDL.

   2. Run the application.

   3. Initiate one or more notification messages.
   The system accepts and publishes the notification messages from the JAX-WS client.

2. Receive notification messages in a new JAX-WS based WS-Notification consumer application, from a new Version 7.0 WS-Notification service point.

   This validates that the Version 7.0 WS-Notification service point can deliver notifications to a JAX-WS consumer web service.

   1. Create a new JAX-WS based WS-Notification consumer web service from the standard WS-Notification WSDL.

      For more information, see Example: Subscribing a WS-Notification consumer, Implement web services applications from existing WSDL files with JAX-WS and Publish the WSDL files for a WS-Notification application to a compressed file.

      Instead of creating a new JAX-WS consumer application, you might choose to update the JAX-WS consumer application created in the subtask Use JAX-WS clients and web services with migrated service points. The WSDL for a Version 7.0 WS-Notification service point contains a number of minor changes compared to a Version 6.1 service point, so modify the existing JAX-WS client application to take account of these changes. Specifically, you must regenerate the java proxy classes from the WSDL, and update any use of class names and methods that have changed. For example, there might be changes in the generated classes that include a port type or service from the WSDL.

   2. Create a subscription for the new consumer service through the new Version 7.0 WS-Notification service point.

   3. Prompt the WS-Notification service point to generate notifications (for example by using a WS-Notification client application).
   The system transmits the notifications to the new JAX-WS consumer application correctly.

Share notifications between Version 6.1 and Version 7.0 WS-Notification service points

We can configure WS-Notification so that notifications received through migrated Version 6.1 WS-Notification service points are published through the new Version 7.0 service. We might want to do this so that (for example) we can receive notifications through existing, unreliable connections then publish them through new connections made reliable through WS-ReliableMessaging. To enable this configuration, the new Version 7.0 WS-Notification service needs to use the same service integration bus topic space as the migrated Version 6.1 WS-Notification service. You use a permanent topic namespace to statically define the association between a WS-Notification topic namespace URI and a service integration bus topic space destination. You configure a permanent topic namespace as a property of a WS-Notification service.

1. Discover which bus topic spaces the migrated Version 6.1 WS-Notification service is using. If none, create a new permanent topic namespace to connect to a bus topic space. For more information, see Modify a Version 6.1 WS-Notification service.

2. Create a new permanent topic namespace for the new Version 7.0 WS-Notification service, that connects to the same bus topic space. For more information, see Modify a Version 7.0 WS-Notification service.

Results

Notifications received by either the new or migrated service point are now published to subscriptions made on either WS-Notification service.

Related concepts

WS-Notification

WS-Notification and policy set configuration

WS-ReliableMessaging default policy sets

Related tasks

Use WS-Notification for publish and subscribe messaging for web services

Secure WS-Notification

Configure a Version 7.0 WS-Notification service with Web service QoS

Manage policy sets using the administrative console

Add assured delivery to web services through WS-ReliableMessaging

WS-Notification troubleshooting tips