Mediation handlers and mediation handler lists

Mediations are specified as a simple sequential list of mediation handlers. You must assemble and deploy the mediation handler list into an Enterprise Applications Archive and install it in WebSphere® Application Server. Once the mediation is associated with a destination, it processes messages arriving at that destination. A mediation handler is the Java class that processes the messages.

Examples of message processing performed by a mediation handler include the following:

The mediation handler class implements the Java interface com.ibm.websphere.sib.mediation.handler.MediationHandler. You assemble the mediation handler class into an Enterprise Applications Archive (EAR) file then deploy the mediation handler application in a mediation handler list by using an assembly tool, for example IBM® Rational® Application Developer.

You can assign one or more mediation handlers to a mediation handler list to define a set of operations to apply to each message. When you assign a mediation handler to a mediation handler list, you assign a sequence number to the mediation handler. The sequence number is used to determine the specific sequence in which the mediations in the mediation handler lists are invoked.

You configure and create a mediation in the administrative console, attaching it to a destination. By default the mediation handler list has the same name as the mediation handler, but you can specify a different name if required.
Figure 1. Mediation handler lists
This figure describes mediation handler lists.

Figure 1 shows how a mediation is composed of a simple sequential list of mediation handlers. The result of the operation of each mediation handler in the list determines whether the next mediation handler in the list is called, or if the message is routed to the next destination.

In most cases, you will assign only one mediation handler to a mediation handler list. The tooling used to deploy the mediation handler into an EAR provides a basic configuration option for automatically adding the mediation handler to its own mediation handler list.

The behavior of a mediation handler can be controlled by setting properties at various stages of mediation development. You can set these properties when you write the Java class, assemble and deploy the mediation handler, or at runtime when the mediation is created and installed.

Concept topic    

Terms and conditions for information centers | Feedback

Last updated: April 18, 2014 05:01 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-nd-iseries&topic=cjp0010_
File name: cjp0010_.html