Programming mediations

Several distinct tasks are involved in programming a mediation. Typically, the mediation code is written by a programmer, and is then deployed and administered by an integrator.

Code examples for writing a mediation are provided in the following topic: Add mediation function to handler code.

The following application programming interfaces are provided for you to work with messages:

• Use the SIMessage API to manipulate the contents of the message.

• Use the SIMediationSession API to access the service integration bus so that your mediation can send and retrieve messages.

We can deploy mediations using tooling such as the Rational Application Developer tools.

The tasks for programming a mediation are as follows:

Develop

Writing a mediation by adding functional code to a mediation handler.

Deploy

Add a mediation to a mediation handler list, and deploying it.

Administer

Associating a mediation handler with a destination (optional), and configuring the parameters to be used by the mediation handler at run time.

Take the following steps to program a mediation:

Tasks

1. Create a mediation handler. See Writing a mediation handler.

2. Add mediation function code to your mediation handler. See Add mediation function to handler code.

3. Optional: Working with the message payload, for example for logging messages within a mediation. For more information, see Work with the message payload.

4. Use the Rational Application Developer tools to create a handler list, add your mediation handler to the list, and deploy the handler list as an Enterprise Archive (EAR file). See the Rational Application Developer information center for information about how to do this.

Subtopics

• Serializing the content of SIMessage
  Convert an SIMessage object to a byte array.
• Writing a mediation handler
  We can write a mediation handler, add mediation function to it, and prepare it for installation on an application server.
• Add mediation function to handler code
  A mediation handler is a wrapper for the mediation code that operates on the message. We can add mediation function to an existing mediation handler by working with the message context, the message properties, the message header or the message payload.
• Writing a routing mediation
  Use this topic to create a mediation that chooses a particular forward route for a message.
• Writing a mediation that maps between attachment encoding styles
  Use this topic to create a mediation that maps from SOAP essages with Attachments encoding style to WS-I Attachments Profile Version 1.0 encoding style.
• Choosing a target service and port through a routing mediation
  Write a routing mediation and configure it to select a target service and port. If we have migrated a web services gateway that included a routing filter, use this task to recreate the equivalent functions using a mediation.

Example: Using mediations to trace, monitor and log messages