C

Firebase PUT - Writing Data

See more Firebase Examples

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:

C

#include <C_CkFileAccess.h>
#include <C_CkRest.h>
#include <C_CkAuthGoogle.h>
#include <C_CkPrng.h>
#include <C_CkJsonObject.h>
#include <C_CkStringBuilder.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkFileAccess fac;
    const char *accessToken;
    HCkRest rest;
    HCkAuthGoogle authGoogle;
    HCkPrng prng;
    const char *pushId;
    HCkJsonObject pigRecord;
    HCkStringBuilder path;
    const char *jsonResponse;

    success = FALSE;

    //  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 = CkFileAccess_Create();
    accessToken = CkFileAccess_readEntireTextFile(fac,"qa_data/tokens/firebaseToken.txt","utf-8");
    if (CkFileAccess_getLastMethodSuccess(fac) != TRUE) {
        printf("%s\n",CkFileAccess_lastErrorText(fac));
        CkFileAccess_Dispose(fac);
        return;
    }

    rest = CkRest_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 = CkRest_Connect(rest,"chilkat.firebaseio.com",443,TRUE,TRUE);
    if (success != TRUE) {
        printf("%s\n",CkRest_lastErrorText(rest));
        CkFileAccess_Dispose(fac);
        CkRest_Dispose(rest);
        return;
    }

    authGoogle = CkAuthGoogle_Create();
    CkAuthGoogle_putAccessToken(authGoogle,accessToken);
    CkRest_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 = CkPrng_Create();
    pushId = CkPrng_firebasePushId(prng);

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

    path = CkStringBuilder_Create();
    CkStringBuilder_Append(path,"/pig-rescue/animal/");
    CkStringBuilder_Append(path,pushId);
    CkStringBuilder_Append(path,".json");

    //  The string content of the last arg passed is  {"name":"William"} 
    jsonResponse = CkRest_fullRequestString(rest,"PUT",CkStringBuilder_getAsString(path),CkJsonObject_emit(pigRecord));
    if (CkRest_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.)
        printf("%s\n",CkRest_lastErrorText(rest));
        CkFileAccess_Dispose(fac);
        CkRest_Dispose(rest);
        CkAuthGoogle_Dispose(authGoogle);
        CkPrng_Dispose(prng);
        CkJsonObject_Dispose(pigRecord);
        CkStringBuilder_Dispose(path);
        return;
    }

    //  Check the response status code.   A 200 response status indicates success.
    if (CkRest_getResponseStatusCode(rest) != 200) {
        printf("%s\n",CkRest_responseStatusText(rest));
        printf("%s\n",jsonResponse);
        printf("Failed.\n");
        CkFileAccess_Dispose(fac);
        CkRest_Dispose(rest);
        CkAuthGoogle_Dispose(authGoogle);
        CkPrng_Dispose(prng);
        CkJsonObject_Dispose(pigRecord);
        CkStringBuilder_Dispose(path);
        return;
    }

    printf("%s\n",jsonResponse);
    printf("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.  
    //  


    CkFileAccess_Dispose(fac);
    CkRest_Dispose(rest);
    CkAuthGoogle_Dispose(authGoogle);
    CkPrng_Dispose(prng);
    CkJsonObject_Dispose(pigRecord);
    CkStringBuilder_Dispose(path);

    }