Apama 10.15.0 | Connecting Apama Applications to External Components | Developing Custom Clients | The Client Software Development Kits | The client libraries
 
The client libraries
The client libraries can be found in the following locations of your Apama installation:
*For C++, in the lib directory: libapclient.so (-lapclient) on UNIX, or apclient.lib on Windows.
*For Java, in the lib directory: ap-client.jar.
*For .NET, in the bin directory: apclientdotnet.dll (and its dependency apclient.dll).
Using the C++ client library
To program against the C++ SDK, you must use the definitions from the engine_client_cpp.hpp header file, which is located in the include directory of your Apama installation.
C++ compilers vary extensively in their support for the ISO C++ standard and in how they support linking. For this reason, Apama supports only specific C++ compilers and development environments. For a list of the supported C++ compilers, see Software AG's Knowledge Center in Empower at https://empower.softwareag.com/.
To configure the build for an Apama C++ client:
*On UNIX, copying and customizing an Apama makefile from a sample application is the easiest method.
*On Windows, you might find it easiest to copy an Apama sample project. If you prefer to use a project you already have, be sure to add $(APAMA_HOME)\include as an include directory. To do this in Visual Studio, select your project and then select Project Properties > C++ > General > Additional Include Directories.
Also, link against apclient.lib. To do this in Visual Studio, select your project and then select Project Properties > Linker > Input > Additional Dependencies and add apclient.lib.
Finally, select Project Properties > Linker > General > Additional Library Directories and add $(APAMA_HOME)\lib.
Using the Java client library
Add the ap-client.jar library to your classpath when compiling and running.
Using the .NET client library
To make use of the .NET wrapper, add the apclientdonet.dll library as a reference of your assembly.
To run an application using the wrapper:
1. Copy the following libraries from the bin directory of your Apama installation into the directory that contains your compiled .NET assembly:
*apclient.dll
*apclientdonet.dll
*log4net.dll
2. Ensure that the bin directory of your Apama installation is in the PATH environment variable.