(Unicode C) Firebase PUT - Writing Data

Demonstrates how to PUT new data to a Firebase JSON database. The data used in this example is at Chilkat Firebase Pigs Database, and is shown here:

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_CkFileAccessW.h>
#include <C_CkRestW.h>
#include <C_CkAuthGoogleW.h>
#include <C_CkPrngW.h>
#include <C_CkJsonObjectW.h>
#include <C_CkStringBuilderW.h>

void ChilkatSample(void)
    {
    HCkFileAccessW fac;
    const wchar_t *accessToken;
    HCkRestW rest;
    BOOL success;
    HCkAuthGoogleW authGoogle;
    HCkPrngW prng;
    const wchar_t *pushId;
    HCkJsonObjectW pigRecord;
    HCkStringBuilderW path;
    const wchar_t *jsonResponse;

    // Demonstrates how to PUT new data to a Firebase JSON database.

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    // This example assumes a JWT authentication token, if required, has been previously obtained.
    // See Get Firebase Access Token from JSON Service Account Private Key for sample code.

    // Load the previously obtained Firebase access token into a string.
    fac = CkFileAccessW_Create();
    accessToken = CkFileAccessW_readEntireTextFile(fac,L"qa_data/tokens/firebaseToken.txt",L"utf-8");
    if (CkFileAccessW_getLastMethodSuccess(fac) != TRUE) {
        wprintf(L"%s\n",CkFileAccessW_lastErrorText(fac));
        CkFileAccessW_Dispose(fac);
        return;
    }

    rest = CkRestW_Create();

    // Make the initial connection (without sending a request yet).
    // Once connected, any number of requests may be sent.  It is not necessary to explicitly
    // call Connect before each request.  
    success = CkRestW_Connect(rest,L"chilkat.firebaseio.com",443,TRUE,TRUE);
    if (success != TRUE) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkFileAccessW_Dispose(fac);
        CkRestW_Dispose(rest);
        return;
    }

    authGoogle = CkAuthGoogleW_Create();
    CkAuthGoogleW_putAccessToken(authGoogle,accessToken);
    CkRestW_SetAuthGoogle(rest,authGoogle);

    // Chilkat's sample data (pig-rescue data) is publicly readable at: https://chilkat.firebaseio.com/.json
    // This data is publicly readable, but not writable.  You'll need to 
    // run against your own database..

    // Generate a new push ID.
    prng = CkPrngW_Create();
    pushId = CkPrngW_firebasePushId(prng);

    // We're going to add a new pig with just the name.
    pigRecord = CkJsonObjectW_Create();
    CkJsonObjectW_AppendString(pigRecord,L"name",L"William");

    path = CkStringBuilderW_Create();
    CkStringBuilderW_Append(path,L"/pig-rescue/animal/");
    CkStringBuilderW_Append(path,pushId);
    CkStringBuilderW_Append(path,L".json");

    // The string content of the last arg passed is  {"name":"William"} 
    jsonResponse = CkRestW_fullRequestString(rest,L"PUT",CkStringBuilderW_getAsString(path),CkJsonObjectW_emit(pigRecord));
    if (CkRestW_getLastMethodSuccess(rest) != TRUE) {
        // Something happened in the communications (either no request was sent, or no response was received.
        // (The Chilkat REST API also has lower-level methods where an app can send the request in one call,
        // and then receive the response in another call.)
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkFileAccessW_Dispose(fac);
        CkRestW_Dispose(rest);
        CkAuthGoogleW_Dispose(authGoogle);
        CkPrngW_Dispose(prng);
        CkJsonObjectW_Dispose(pigRecord);
        CkStringBuilderW_Dispose(path);
        return;
    }

    // Check the response status code.   A 200 response status indicates success.
    if (CkRestW_getResponseStatusCode(rest) != 200) {
        wprintf(L"%s\n",CkRestW_responseStatusText(rest));
        wprintf(L"%s\n",jsonResponse);
        wprintf(L"Failed.\n");
        CkFileAccessW_Dispose(fac);
        CkRestW_Dispose(rest);
        CkAuthGoogleW_Dispose(authGoogle);
        CkPrngW_Dispose(prng);
        CkJsonObjectW_Dispose(pigRecord);
        CkStringBuilderW_Dispose(path);
        return;
    }

    wprintf(L"%s\n",jsonResponse);
    wprintf(L"Success.\n");

    // Note: In many of the Chilkat examples, you may notice strange ways
    // of doing something that should be simpler and shorter.  For example,
    // building the path (above) could've been written differently,
    // with some simple string concatenation.
    // 
    // The reason is that the Chilkat examples are written in a 
    // proprietary "example code" scripting language,
    // and then automatically generated to each of the different programming
    // languages you see on example-code.com.  The code generation is
    // limited in what it can do.  For example, string concatentation
    // is not yet a feature of the "example code" scripting language (as of May 2016), 
    // and therefore you won't see the use of a programming language's string
    // concatentation operators in any example.  
    // 


    CkFileAccessW_Dispose(fac);
    CkRestW_Dispose(rest);
    CkAuthGoogleW_Dispose(authGoogle);
    CkPrngW_Dispose(prng);
    CkJsonObjectW_Dispose(pigRecord);
    CkStringBuilderW_Dispose(path);

    }