(C) Getting the HTTP Response after an Asynchronous HTTP Request Completes

Some HTTP methods return an HTTP response object. This example demonstrates how to obtain the HTTP response object for such a method when calling asynchronously.

Chilkat C/C++ Library Downloads
MS Visual C/C++ Linux/CentOS C/C++ Alpine Linux C/C++ MAC OS X C/C++	armhf/aarch64 C/C++ C++ Builder iOS C/C++ Android C/C++	Solaris C/C++ MinGW C/C++

#include <C_CkGlobal.h>
#include <C_CkHttp.h>
#include <C_CkTask.h>
#include <C_CkHttpResponse.h>

void ChilkatSample(void)
    {
    HCkGlobal chilkatGlob;
    BOOL success;
    HCkHttp http;
    HCkTask task;
    HCkHttpResponse resp;

    //  All Chilkat classes can be unlocked at once at the beginning of a program
    //  by calling UnlockBundle.  It requires a Bundle unlock code.
    chilkatGlob = CkGlobal_Create();
    success = CkGlobal_UnlockBundle(chilkatGlob,"Anything for 30-day trial.");
    if (success != TRUE) {
        printf("%s\n",CkGlobal_lastErrorText(chilkatGlob));
        CkGlobal_Dispose(chilkatGlob);
        return;
    }

    http = CkHttp_Create();

    //  Call the async version of the QuickGetObj method to return a task object.
    //  The task object is loaded, but is in the Inert state -- meaning it is
    //  not yet scheduled to run on Chilkat's background thread pool.
    task = CkHttp_QuickGetObjAsync(http,"https://stackexchange.com");
    if (CkHttp_getLastMethodSuccess(http) != TRUE) {
        printf("%s\n",CkHttp_lastErrorText(http));
        CkGlobal_Dispose(chilkatGlob);
        CkHttp_Dispose(http);
        return;
    }

    //  Schedule the task for running on the thread pool.  This changes the task's state
    //  from Inert to Live.
    success = CkTask_Run(task);
    if (success != TRUE) {
        printf("%s\n",CkTask_lastErrorText(task));
        CkTask_Dispose(task);
        CkGlobal_Dispose(chilkatGlob);
        CkHttp_Dispose(http);
        return;
    }

    //  The application is now free to do anything else
    //  while the HTML page is being downloaded.

    //  For this example, we'll simply sleep and periodically
    //  check to see if the QuickGetObjAsync if finished.
    while (CkTask_getFinished(task) != TRUE) {

        //  Sleep 100 ms.
        CkTask_SleepMs(task,100);

    }

    //  A finished task could be one that was canceled, aborted, or truly finished.

    //  If the task was "canceled", it was canceled prior to actually starting.  This could
    //  happen if the task was canceled while waiting in a thread pool queue to be scheduled by Chilkat's
    //  background thread pool scheduler.

    //  If the task was "aborted", it indicates that it was canceled while running in a background thread.
    //  The ResultErrorText will likely indicate that the task was aborted.

    //  If the task "completed", then it ran to completion, but the actual success/failure of the method
    //  is determined by the result obtained via a GetResult* method.  (A "completed" task will
    //  have a StatusInt equal to 7.   If the task finished, but was not completed, then it must've
    //  been aborted or canceled:
    if (CkTask_getStatusInt(task) != 7) {
        printf("Task did not complete.\n");
        printf("task status: %s\n",CkTask_status(task));
        CkTask_Dispose(task);
        CkGlobal_Dispose(chilkatGlob);
        CkHttp_Dispose(http);
        return;
    }

    //  The synchronous call to QuickGetObj would return an HTTP response object.  To get this
    //  response object for the async call, we instantiate a new/empty HTTP response object,
    //  and then load it from the completed task.
    resp = CkHttpResponse_Create();

    success = CkHttpResponse_LoadTaskResult(resp,task);
    if (success != TRUE) {
        printf("%s\n",CkHttpResponse_lastErrorText(resp));
        CkTask_Dispose(task);
        CkGlobal_Dispose(chilkatGlob);
        CkHttp_Dispose(http);
        CkHttpResponse_Dispose(resp);
        return;
    }

    CkTask_Dispose(task);

    //  Now that we have the response, we can get all of the information:

    printf("status code: %d\n",CkHttpResponse_getStatusCode(resp));
    printf("response header: %s\n",CkHttpResponse_header(resp));

    //  ...


    CkGlobal_Dispose(chilkatGlob);
    CkHttp_Dispose(http);
    CkHttpResponse_Dispose(resp);

    }