(DataFlex) 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 ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

Use ChilkatAx-win32.pkg

Procedure Test
    Handle hoFac
    String sAccessToken
    Handle hoRest
    Boolean iSuccess
    Variant vAuthGoogle
    Handle hoAuthGoogle
    Handle hoPrng
    String sPushId
    Handle hoPigRecord
    Handle hoPath
    String sJsonResponse
    String sTemp1
    String sTemp2
    Integer iTemp1
    Boolean bTemp1

    // 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.
    Get Create (RefClass(cComCkFileAccess)) To hoFac
    If (Not(IsComObjectCreated(hoFac))) Begin
        Send CreateComObject of hoFac
    End
    Get ComReadEntireTextFile Of hoFac "qa_data/tokens/firebaseToken.txt" "utf-8" To sAccessToken
    Get ComLastMethodSuccess Of hoFac To bTemp1
    If (bTemp1 <> True) Begin
        Get ComLastErrorText Of hoFac To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    Get Create (RefClass(cComChilkatRest)) To hoRest
    If (Not(IsComObjectCreated(hoRest))) Begin
        Send CreateComObject of hoRest
    End

    // 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.  
    Get ComConnect Of hoRest "chilkat.firebaseio.com" 443 True True To iSuccess
    If (iSuccess <> True) Begin
        Get ComLastErrorText Of hoRest To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    Get Create (RefClass(cComChilkatAuthGoogle)) To hoAuthGoogle
    If (Not(IsComObjectCreated(hoAuthGoogle))) Begin
        Send CreateComObject of hoAuthGoogle
    End
    Set ComAccessToken Of hoAuthGoogle To sAccessToken
    Get pvComObject of hoAuthGoogle to vAuthGoogle
    Get ComSetAuthGoogle Of hoRest vAuthGoogle To iSuccess

    // 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.
    Get Create (RefClass(cComChilkatPrng)) To hoPrng
    If (Not(IsComObjectCreated(hoPrng))) Begin
        Send CreateComObject of hoPrng
    End
    Get ComFirebasePushId Of hoPrng To sPushId

    // We're going to add a new pig with just the name.
    Get Create (RefClass(cComChilkatJsonObject)) To hoPigRecord
    If (Not(IsComObjectCreated(hoPigRecord))) Begin
        Send CreateComObject of hoPigRecord
    End
    Get ComAppendString Of hoPigRecord "name" "William" To iSuccess

    Get Create (RefClass(cComChilkatStringBuilder)) To hoPath
    If (Not(IsComObjectCreated(hoPath))) Begin
        Send CreateComObject of hoPath
    End
    Get ComAppend Of hoPath "/pig-rescue/animal/" To iSuccess
    Get ComAppend Of hoPath sPushId To iSuccess
    Get ComAppend Of hoPath ".json" To iSuccess

    // The string content of the last arg passed is  {"name":"William"} 
    Get ComGetAsString Of hoPath To sTemp1
    Get ComEmit Of hoPigRecord To sTemp2
    Get ComFullRequestString Of hoRest "PUT" sTemp1 sTemp2 To sJsonResponse
    Get ComLastMethodSuccess Of hoRest To bTemp1
    If (bTemp1 <> True) Begin
        // 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.)
        Get ComLastErrorText Of hoRest To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    // Check the response status code.   A 200 response status indicates success.
    Get ComResponseStatusCode Of hoRest To iTemp1
    If (iTemp1 <> 200) Begin
        Get ComResponseStatusText Of hoRest To sTemp1
        Showln sTemp1
        Showln sJsonResponse
        Showln "Failed."
        Procedure_Return
    End

    Showln sJsonResponse
    Showln "Success."

    // 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.  
    // 


End_Procedure