A description ofSybase CEP sample Generic HTTP and SOAP plugins. Use these plugins with remote procedures that are called via HTTP or SOAP protocols.
The Sybase CEP product includes two example RPC plugins:
Use the HTTP plugin to send HTTP POST requests. The source code for this plugin is in the file c8_rpc_http.cpp.
Use the SOAP plugin to send SOAP requests. The source code for this plugin is in the file c8_rpc_soap.cpp.
Use these plugins with remote procedures that are called via HTTP or SOAP protocols. When you specify the name of the compiled library file in the c8-services.xml file, specify only the base name c8_rpc_http_soap_lib. The server automatically appends the appropriate filename extension (.dll or .so) for the operating system. On UNIX-like operating systems, the initial "lib" of "libc8_rpc_http_soap_lib.so" is prefixed, if necessary.
The Sybase CEP HTTP plugin enables you to pass zero or more parameters and get back zero or one parameter(s).
The Sybase CEP SOAP plugin enables you to pass zero or more parameters and get back zero or more parameter(s).
If you need to retrieve more than one parameter, use the SOAP plugin or a custom plugin.
Source code for both libraries is in the server\sdk\c\examples subdirectory of your Sybase CEP installation directory. Typically, this is either:
C:\Program Files\SybaseC8\Server\sdk\c\examples or /home/<userID>/Sybasec8/server/sdk/c/examples
The HTTP plugin supports HTTP 1.0. The plugin expects exactly one column of type STRING from the CCL statement and produces exactly one STRING result in the HTTP response body. The HTTP plugin recognizes HTTP errors and returns nothing to the CCL statement if it encounters such an error.
The SOAP RPC protocol supports a subset of SOAP 1.2 (see http://www.w3.org/TR/soap12-part1/ and http://www.w3.org/TR/soap12-part2 for more info). The SOAP RPC plugin expects any number of input columns from the CCL statement and can produce any number of output columns. The SOAP plugin recognizes SOAP errors and returns nothing to the CCL statement if it encounters such an error. For information about the conversion of CCL datatypes into XSI types and vice versa, please see Appendix I of the Sybase CEP CCL Reference Guide .
The parameters expected by the HTTP and SOAP plugins are detailed in HTTP and SOAP Plugin Preferences.
Sybase CEP provides these two plugins in source code form. Compile the plugins before you use them, and put the compiled code into the server's "bin" directory.