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

You 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.

Before you begin

This topic assumes that you have an existing server or cluster installation of WebSphere® Application Server Version 7.0 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 Migrating a Version 6.1 WS-Notification configuration from WebSphere Application Server Version 6.1 to Version 7.0 or later.

About this task

For reliable notification, you apply policy sets that include WS-ReliableMessaging to your WS-Notification configuration. You 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 WebSphere Application Server Version 6.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 your 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 you want to apply a policy set as a JAX-WS application. Note that you 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 Developing applications that use WS-Notification. You 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:

Procedure

What to do next

When you have completed these subtasks, you 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.

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

Procedure

  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 by using the WSDL of the migrated service point.

      For more information, see Example: Publishing a WS-Notification message, Developing a JAX-WS client from a WSDL file and Publishing 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 your 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, Implementing web services applications from existing WSDL files with JAX-WS and Publishing 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.

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

Procedure

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

    You 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 WebSphere Application Server Version 7.0 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 by using the WSDL of the new Version 7.0 WS-Notification service point.
      For more information, see Example: Publishing a WS-Notification message, Developing client bindings from a WSDL file for a JAX-RPC Web services client and Publishing the WSDL files for a WS-Notification application to a compressed file.
      Note: 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 you must modify your 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 your 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, Implementing web services applications from existing WSDL files with JAX-WS and Publishing the WSDL files for a WS-Notification application to a compressed file.
      Note: Instead of creating a new JAX-RPC consumer application, you 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.

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

Before you begin

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

Procedure

  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 by using the WSDL of the new Version 7.0 WS-Notification service point.
      For more information, see Example: Publishing a WS-Notification message, Developing a JAX-WS client from a WSDL file and Publishing the WSDL files for a WS-Notification application to a compressed file.
      Note: Instead of creating a new JAX-WS client application, you might choose to update the JAX-WS client application that you created in the subtask Using 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 you must modify your 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 your 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, Implementing web services applications from existing WSDL files with JAX-WS and Publishing the WSDL files for a WS-Notification application to a compressed file.
      Note: Instead of creating a new JAX-WS consumer application, you might choose to update the JAX-WS consumer application that you created in the subtask Using 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 you must modify your 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.

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

About this task

You 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. You might want to do this so that (for example) you 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.

Procedure

  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 Modifying 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 Modifying 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.



In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Jan 30, 2014 9:17:32 AM CST
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-nd-iseries&topic=tjwsn_task_prep_wsrm
File name: tjwsn_task_prep_wsrm.html