(PureBasic) 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 PureBasic Module Download Chilkat PureBasic Module

IncludeFile "CkJsonObject.pb"
IncludeFile "CkPrng.pb"
IncludeFile "CkFileAccess.pb"
IncludeFile "CkStringBuilder.pb"
IncludeFile "CkAuthGoogle.pb"
IncludeFile "CkRest.pb"

Procedure ChilkatExample()

    ; 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.i = CkFileAccess::ckCreate()
    If fac.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    accessToken.s = CkFileAccess::ckReadEntireTextFile(fac,"qa_data/tokens/firebaseToken.txt","utf-8")
    If CkFileAccess::ckLastMethodSuccess(fac) <> 1
        Debug CkFileAccess::ckLastErrorText(fac)
        CkFileAccess::ckDispose(fac)
        ProcedureReturn
    EndIf

    rest.i = CkRest::ckCreate()
    If rest.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; 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.i = CkRest::ckConnect(rest,"chilkat.firebaseio.com",443,1,1)
    If success <> 1
        Debug CkRest::ckLastErrorText(rest)
        CkFileAccess::ckDispose(fac)
        CkRest::ckDispose(rest)
        ProcedureReturn
    EndIf

    authGoogle.i = CkAuthGoogle::ckCreate()
    If authGoogle.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkAuthGoogle::setCkAccessToken(authGoogle, accessToken)
    CkRest::ckSetAuthGoogle(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.i = CkPrng::ckCreate()
    If prng.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    pushId.s = CkPrng::ckFirebasePushId(prng)

    ; We're going to add a new pig with just the name.
    pigRecord.i = CkJsonObject::ckCreate()
    If pigRecord.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkJsonObject::ckAppendString(pigRecord,"name","William")

    path.i = CkStringBuilder::ckCreate()
    If path.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkStringBuilder::ckAppend(path,"/pig-rescue/animal/")
    CkStringBuilder::ckAppend(path,pushId)
    CkStringBuilder::ckAppend(path,".json")

    ; The string content of the last arg passed is  {"name":"William"} 
    jsonResponse.s = CkRest::ckFullRequestString(rest,"PUT",CkStringBuilder::ckGetAsString(path),CkJsonObject::ckEmit(pigRecord))
    If CkRest::ckLastMethodSuccess(rest) <> 1
        ; 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.)
        Debug CkRest::ckLastErrorText(rest)
        CkFileAccess::ckDispose(fac)
        CkRest::ckDispose(rest)
        CkAuthGoogle::ckDispose(authGoogle)
        CkPrng::ckDispose(prng)
        CkJsonObject::ckDispose(pigRecord)
        CkStringBuilder::ckDispose(path)
        ProcedureReturn
    EndIf

    ; Check the response status code.   A 200 response status indicates success.
    If CkRest::ckResponseStatusCode(rest) <> 200
        Debug CkRest::ckResponseStatusText(rest)
        Debug jsonResponse
        Debug "Failed."
        CkFileAccess::ckDispose(fac)
        CkRest::ckDispose(rest)
        CkAuthGoogle::ckDispose(authGoogle)
        CkPrng::ckDispose(prng)
        CkJsonObject::ckDispose(pigRecord)
        CkStringBuilder::ckDispose(path)
        ProcedureReturn
    EndIf

    Debug jsonResponse
    Debug "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.  
    ; 


    CkFileAccess::ckDispose(fac)
    CkRest::ckDispose(rest)
    CkAuthGoogle::ckDispose(authGoogle)
    CkPrng::ckDispose(prng)
    CkJsonObject::ckDispose(pigRecord)
    CkStringBuilder::ckDispose(path)


    ProcedureReturn
EndProcedure