Developing Custom Adapters
This documentation describes how to use the Apama Integration Adapter Framework (IAF). The IAF is a middleware-independent and protocol-neutral adapter tailoring framework designed to provide for the easy and straightforward creation of software adapters to interface Apama with middleware buses and other message sources. It provides facilities to generate adapters that can communicate with third-party messaging systems, extract and decode self-describing or schema-formatted messages, and flexibly transform them into Apama events. Vice-versa, Apama events can be transformed into the proprietary representations required by third-party messaging systems. It provides highly configurable and maintainable interfaces and semantic data transformations. An adapter generated with the IAF can be re-configured and upgraded at will, and in many cases, without having to restart it. Its dynamic plug-in loading mechanism allows a user to customize it to communicate with proprietary middleware buses and decode message formats.
The information in this book is organized as follows:
Using the IAF describes how to start, stop, and manage the IAF runtime. It also describes the IAF sample applications.
C/C++ Codec Plug-in Development presents the C/C++ Codec Plug-in Development Specification and describes how to implement codec layer plug-ins in C and C++.
C/C++ Plug-in Support APIs describes programming interfaces provided with the Apama software that may be useful in implementing transport layer and codec plug-ins for the IAF.
Java Codec Plug-in Development presents the Codec Plug-in Development Specification for Java and describes how to implement codec layer plug-ins in Java.
Plug-in Support APIs for Java describes the Java interface for recording status and error log messages from the IAF runtime and any plug-ins loaded within it.
Out of Band Connection Notifications describes the set of out of band events that can be used to notify adapters when sender and receiver components connect to or disconnect from the IAF.
The Event Payload describes how to add a payload field to an Apama event type. A payload field is used to accommodate data that does not comply with the rigid structure of an Apama event.