FIXEdge SDK Developer Guide

General statements

FIXEdge SDK allows developers to create custom plugins for FIXEdge: Transport Adaptors and Handlers.

Structure of FIXEdge SDK

cmakeModules - CMake modules

Headers - C++ headers files for FIXAntenna C++ (FA) and for FIXEdge (FE)

Libs - release version of FA C++ static libraries

src_Handler - source of sample Handler

src_TA - source of sample Transport Adaptor

Requirements

The FIXEdge SDK is available for Windows (MS Visual Studio 2010, x64) and Linux (RHEL 6, gcc44, x64)

CMake v 2.8 should be used to prepare the solution of sample Handler and sample Transport Adaptor

Xerces-c 3.1.1 (headers and dynamic libraries) is required for building the sample Handler project.

How to build samples

Export a system variable pointing to the XERCES-C: export XERCESCROOT=/home/user/extlibs/xerces-c-src_2_8_0
Create a folder for build:
$ mkdir ./build
$ cd ./build
Run CMake:
$ cmake -G "Unix Makefiles" ../
or (Windows)
> cmake.exe -G "Visual Studio 10 Win64" ../
Build shared libraries:
$ make
or (Windows)
build b2b_fixserver_development_ta.sln (Release, MD)

Handler and Transport Adaptor Features

Handler is a lightweight plugin for FIXEdge. It is suited for using in the following scenario:

make some modifications on incoming FIX Messages (add/delete/modify some tags based on some conditions that is difficult to implement in BL XML or BL JS) and pass it back to BL or Transport Adaptor

There are already implemented Handlers - see FIXEdge BL Handlers for more info.

Transport Adaptor is more complicated plugin. It is suited for use in the following scenarios where adapting FIX Session to any other kind of session is required:

establish a connection to any non-FIX endpoints (such as SMTP - SMTP TA, IBM MQ, HTTPS, JMS, Kafka, and so on) and provide a data flow between these endpoints and FIX Sessions.
periodically polling of any FIX or non-FIX endpoints

There are already implemented Transport Adaptors - see FIXEdge Transport Adaptors for more info.

Feature	Handler	Transport Adaptor
Load	reloads each time after BL Rules are reloaded loads only if reference to Handler exists in some BL rule	once at FE start
ClientID	doesn't have a ClientID. Can't be referenced by another Handler or TA.	Can register several ClientIDs
Incoming messages	Can be addressed from BL Rules using <HandlerAction> tag only message is coming to process method	Messages to each of ClientID can be passed from BL <Send> tag, or from another TA or Handler. Message is coming into the sendToClient method
Outgoing messages	Can just pass original or transformed message to the BL Can send synchronously to any registered ClientID Can send asynchronously to any registed ClientID	Can be send to BL only via the onMessageFromClient method. onMessageFromClient can't be called from the same thread as sendToClient
History access	has direct access to any configured on BL History	for Bridge Adaptors only (see FIXEdge Transport Adaptors Developer Guide) for more details
Configuration	in BL_Config.xml	in FIXEdge.properties

For more detailed info on developing custom Handler, see FIXEdge BL Handlers Developer Guide.

For more detailed info on developing custom Transport Adaptor, see FIXEdge Transport Adaptors Developer Guide.