SOAP Web Service (HTTP POST)

Demonstrates how to call PostXml to call a SOAP web service.

Downloads:

MS Windows Visual C/C++ Libraries

Linux/CentOS C/C++ Libraries

MAC OS X C/C++ Libraries

Solaris C/C++ Libraries

C++ Builder Libraries

#include <C_CkHttp.h>
#include <C_CkXml.h>
#include <C_CkHttpResponse.h>

void ChilkatSample(void)
    {
    HCkHttp http;
    BOOL success;
    HCkXml xml;
    const char * strXml;
    HCkHttpResponse resp;
    long responseStatusCode;
    const char * endPoint;
    HCkXml xmlResp;
    const char * unwrappedXml;
    HCkXml xmlMeat;


    http = CkHttp_Create();

    //  Any string unlocks the component for the 1st 30-days.
    success = CkHttp_UnlockComponent(http,"Anything for 30-day trial");
    if (success != TRUE) {
        printf("%s\n",CkHttp_lastErrorText(http));
        return;
    }

    //  This example uses a live web service at:
    //  http://www.webservicex.net/uklocation.asmx
    //  It gets the UK town,Postcode and County by Postcode(First Section of Post Code)

    //  The SOAP XML will look like this:
    //  <?xml version="1.0" encoding="utf-8"?>
    //  <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    //    <soap:Body>
    //      <GetUKLocationByPostCode xmlns="http://www.webserviceX.NET">
    //        <PostCode>string</PostCode>
    //      </GetUKLocationByPostCode>
    //    </soap:Body>
    //  </soap:Envelope>

    //  For this example's sake, we'll load the XML from a file.  We'll test using PostCode "E3".
    //  The SOAP XML for this example may be downloaded from:
    //  http://www.chilkatsoft.com/testData/ukPostCodeSoap.xml
    xml = CkXml_Create();
    success = CkXml_LoadXmlFile(xml,"ukPostCodeSoap.xml");
    if (success != TRUE) {
        printf("%s\n",CkXml_lastErrorText(xml));
        return;
    }

    strXml = CkXml_getXml(xml);

    //  We'll need to add this in the HTTP header:
    //  SOAPAction: "http://www.webserviceX.NET/GetUKLocationByPostCode"
    CkHttp_SetRequestHeader(http,"SOAPAction","http://www.webserviceX.NET/GetUKLocationByPostCode");

    //  Some services expect the content-type in the HTTP header to be "application/xml" while
    //  other expect text/xml.  The default sent by Chilkat is "application/xml", but this web service
    //  expects "text/xml".  Therefore, change the content-type:
    CkHttp_SetRequestHeader(http,"Content-Type","text/xml; charset=utf-8");

    //  The endpoint for this soap service is:

    endPoint = "http://www.webservicex.net/uklocation.asmx";

    //  Note: This particular web service was live and functioning at the time this example
    //  was written.  It is possible that as time progresses, this web service will no longer
    //  be availble...
    resp = CkHttp_PostXml(http,endPoint,strXml,"utf-8");
    if (resp == 0 ) {
        printf("%s\n",CkHttp_lastErrorText(http));

        printf("LastHeader:\n");
        printf("%s\n",CkHttp_lastHeader(http));
    }
    else {

        responseStatusCode = CkHttpResponse_getStatusCode(resp);
        //  You may wish to verify that the responseStatusCode equals 200...
        printf("Response Status Code: %d\n",responseStatusCode);

        //  You may examine the exact HTTP header sent with the POST like this:
        printf("LastHeader:\n");
        printf("%s\n",CkHttp_lastHeader(http));

        //  Examine the XML returned by the web service:
        printf("XML Response:\n");
        xmlResp = CkXml_Create();
        success = CkXml_LoadXml(xmlResp,CkHttpResponse_getBodyStr(resp));
        //  Assume the LoadXml is successful...
        //  Get rid of the SOAP wrappings and get to the meat of this particular response.
        //  The TagContent method returns the content of the 1st node in the XML document
        //  having a specific tag:

        unwrappedXml = CkXml_tagContent(xmlResp,"GetUKLocationByPostCodeResult");
        printf("%s\n",unwrappedXml);

        //  The unwrapped XML could be loaded into an XML object and parsed...
        xmlMeat = CkXml_Create();
        success = CkXml_LoadXml(xmlMeat,unwrappedXml);

        //  ...
    }



    CkHttp_Dispose(http);
    CkXml_Dispose(xml);
    CkXml_Dispose(xmlResp);
    CkXml_Dispose(xmlMeat);

    }