Adding assured delivery to web services through WS-ReliableMessaging

Develop a Java API for XML-Based Web Services (JAX-WS) provider or requester application, and configure a policy set to enable WS-ReliableMessaging. Install your application then attach the policy set. If you want to use either of the managed qualities of service, bind the application or policy set to a service integration bus and messaging engine.

About this task

WS-ReliableMessaging is an interoperability standard for the reliable transmission of messages between two endpoints. With WS-ReliableMessaging, you can make your SOAP over HTTP-based web services reliable without having to write custom code. You can get different qualities of service with WS-ReliableMessaging. These range from protecting against loss of messages across a network, through to protecting against a server becoming unavailable.

With WebSphere® Application Server, you can use WS-ReliableMessaging with Java API for XML-Based Web Services (JAX-WS) web services applications that use a SOAP over HTTP binding. To configure a web service application to use WS-ReliableMessaging, you attach a policy set that contains a WS-ReliableMessaging policy type. This policy type offers a range of qualities of service: managed persistent, managed non-persistent, or unmanaged non-persistent. The managed qualities of service, managed persistent and managed non-persistent, are supported by the service integration bus.For each attachment between an application and a policy set, you can select the bus and messaging engine to use for the reliable messaging protocol state.

Note:

Support for the WS-ReliableMessaging standard was first introduced as part of the IBM WebSphere Application Server Version 6.1 Feature Pack for Web Services. At that time, the Reliable Asynchronous Messaging Profile (RAMP) Version 1.0 specification used WS-ReliableMessaging to ensure the reliable delivery of messages, and the Feature Pack for Web Services in WebSphere Application Server Version 6.1 included default policy sets that support this specification. You can migrate WebSphere Application Server Version 6.1 WS-ReliableMessaging configurations that use RAMP-based policy sets to the current version of the product.

Following on from the RAMP Version 1.0 specification, the Web Services Interoperability organization (WS-I) Reliable Secure Profile working group has developed Version 1.0 of an interoperability profile dealing with secure, reliable messaging capabilities for web services. This profile is similar to RAMP Version 1.0, except that it is updated to use WS-ReliableMessaging Version 1.1 with the OASIS WS-SecureConversation Version 1.3 specification. The WS-I RSP default policy sets provided in this version of WebSphere Application Server are an implementation of the Reliable Secure Profile Version 1.0 specification.

If you create JAX-WS based WS-Notification services, you can apply WS-ReliableMessaging policies to them to make your WS-Notification services reliable. For more information, see Configuring WS-Notification for reliable notification.

The WS-Policy implementation in WebSphere Application Server supports Web Services Reliable Messaging Policy Assertion Version 1.0 and Web Services Reliable Messaging Policy Assertion Version 1.1. For more information, see WS-Policy.

To enable WS-ReliableMessaging for an application, you take the following broad actions:
  1. Develop a Java API for XML-Based Web Services (JAX-WS) web service provider or requester application.
  2. Install the application into WebSphere Application Server.
  3. Attach a reliable messaging policy set (either a default policy set or one that you have created) to an aspect of your application (that is, application level or web service level). Policy sets define the reliability level (quality of service) and other configuration options that you want to apply to your reliable messaging application.
  4. Define the bindings for each attachment to a policy set that specifies a managed quality of service. That is, choose the service integration bus and messaging engine to use to maintain the state for the managed persistent and managed non-persistent qualities of service.

At any stage - that is, before or after you have built your reliable web service application, or configured your policy sets - you can set a property that configures endpoints to only support clients that use reliable messaging. This setting is reflected by WS-Policy if engaged.

Procedure

  1. Develop a reliable web service application.
  2. Configure a policy set instance to enable WS-ReliableMessaging.
  3. Install your reliable JAX-WS web service application.
  4. Attach and bind a WS-ReliableMessaging policy set to your application.
  5. Save your changes to the master configuration.
  6. Stop then restart the server.

Results

A reliable JAX-WS application is deployed into a suitably configured environment and started.
Task topic    

Terms and conditions for information centers | Feedback

Last updated: April 17, 2014 04:48 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-base-iseries&topic=twbs_wsrm_ep
File name: twbs_wsrm_ep.html