Apama Documentation : Connecting Apama Applications to External Components : Working with Connectivity Plug-ins : Developing Connectivity Plug-ins : Building plug-ins
Building plug-ins
See the samples/connectivity_plugin directory of your Apama installation for working samples of connectivity plug-in source code, Ant build files, makefiles, or Microsoft Visual Studio projects for building C++ plug-ins (note that the build instructions in the samples/connectivity_plugin directory assume that you are using a recent version of Microsoft Visual Studio).
Building Java plug-ins
Java plug-ins require the connectivity-plugins-api.jar file in $(APAMA_HOME)/lib to be on the compiler's classpath as it defines Message, AbstractCodec, AbstractTransport, AbstractChainManager and associated classes. The classes are in the com.softwareag.connectivity.* packages.
All code samples shown in this connectivity plug-ins documentation assume either that the following lines of code are present in the source file, or that the classes are imported individually.
import com.softwareag.connectivity.*;
import java.util.*; // Map, HashMap, List, ArrayList
// are commonly used classes in these samples
You can develop Java-based connectivity plug-ins in Software AG Designer. To do so, you have to add the Apama Java support to your Apama project. See Creating Apama projects for more information. This will automatically take care of the classpath for you.
Building C++ plug-ins
C++ plug-ins require the header files in $(APAMA_HOME)/include to be on the compiler's include path. The plug-in should be linked as a shared library and it should link against the apclient library in the $(APAMA_HOME)/lib directory. The resultant library will thus depend on the apclient library.
All code samples shown in this connectivity plug-ins documentation assume either that the following lines of code are present in the source file, or that individual using statements are used for each class.
#include <sag_connectivity_plugins.hpp>

using namespace com::softwareag::connectivity;
For information on the compilers had have been tested and are supported, refer to the Supported Platforms document for the current Apama version. This document is available from http://documentation.softwareag.com/apama/index.htm.
Connectivity plug-in headers are a wrapper around a C ABI. Unlike other plug-ins, the C++ plug-ins are therefore not sensitive to which C++ compiler product, compiler version and compiler configuration (for example, a debug or release build) is used. The C++ compiler used does need to correctly support parts of the C++11 standard, and exact settings required for each compiler will vary.
If you want to develop plug-ins in C++, you have to use your own C++ compiler/development environment.
Copyright © 2013-2017 Software AG, Darmstadt, Germany. (Innovation Release)

Product LogoContact Support   |   Community   |   Feedback