Soap Service3ProLinga-Soap LibrarySoap ServiceClasses used to implement SOAP service functionality.Synopsis
#include <prolinga/Soap.hpp>
class PlSoapService
{
public:
PlSoapService();
~PlSoapService();
int soapServiceStart (char *server_host,
int server_port,
int num_threads,
int server_comp,
char *log_file,
int log_level);
...
};
typedef PlSoapService *PlSoapServicePtr;
class PlSoapProcess
{
public:
PlSoapProcess();
~PlSoapProcess();
xmlDocPtr getRequest (void);
void putResponse (xmlDocPtr docResponse);
...
};
typedef PlSoapProcess *PlSoapProcessPtr;
Description
These classes are used to implement a SOAP service.
Details<anchor id="PlSoapService__soapServiceStart"/>PlSoapService::soapServiceStart ()PlSoapService::soapServiceStartint PlSoapService::soapServiceStart (char *server_host
int server_port,
int num_threads,
int server_comp,
char *log_file,
int log_level);
This function is called to start the Soap service. The service will wait and listen for
for any requests coming in. Function PlSoapLink will get called
for the processing of such a request. Within that function class
PlSoapProcess is
available for the handling of the request and response documents.
Keep in mind that the function PlSoapService::soapServiceStart will start
an infinite for-loop, so code placed after this function will not be executed. If however you need to
execute code after shutting down the service, you can start this function in a forked process.server_host : the name or IP number the machine will bind to. Default is localhost.server_port : the TCP port number the machine will bind to. Default is 8001.num_threads : the number of threads you want to run with. Default is 5.server_comp : the level of compression of request/response files before sending (0-9, 9=best).No Default.log_file : the path and name of the log file. Default is /usr/tmp/prolingaSoap.log.log_level : the level of logging (0-5).No Default.Returns : error status in case the service falls over.<anchor id="PlSoapProcess__getRequest"/>PlSoapProcess::getRequest ()PlSoapProcess::getRequestxmlDocPtr PlSoapProcess::getRequest (void);
This function returns the current request.
Returns : the current request as libxml2 document. Do NOT try to free/de-allocate the request, since
it can make the system unstable. Internal class functions take care of this.<anchor id="PlSoapProcess__putResponse"/>PlSoapProcess::putResponse ()PlSoapProcess::putResponsevoid PlSoapProcess::putResponse (xmlDocPtr docResponse);
This function stores the response which will get send back to the caller.
docResponse : the current response as libxml2 document.Soap Client3ProLinga-Soap Client LibrarySoap ClientClass used to send a request to and receive a response from a Web Service.Synopsis
#include <prolinga/SoapClient.hpp>
class PlSoapClient
{
public:
PlSoapClient();
~PlSoapClient();
xmlDocPtr soapCall (const xmlDocPtr docRequest,
const char *serviceEndPoint);
...
};
typedef PlSoapClient *PlSoapClientPtr;
Description
This class is used to be able to send/receive requests/responses to/from a Web Service.
Details<anchor id="PlSoapClient__soapCall"/>PlSoapClient::soapCall ()PlSoapClient::soapCallxmlDocPtr PlSoapClient::soapCall (const xmlDocPtr docRequest,
const char *serviceEndPoint);
This function sends off a request to the Web Service defined in the parameter serviceEndPoint. It
returns a response.
docRequest : the request as a libxml2 document.serviceEndPoint : the hostname or IP number and the TCP port number of the Web Service seperated by a colon(:).
Example: localhost:8001Returns : the response as a libxml2 document.