(Objective-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 Objective-C Library Downloads MAC OS X (Cocoa) Libs iOS Libs

#import <CkoFileAccess.h>
#import <NSString.h>
#import <CkoRest.h>
#import <CkoAuthGoogle.h>
#import <CkoPrng.h>
#import <CkoJsonObject.h>
#import <CkoStringBuilder.h>

// 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.
CkoFileAccess *fac = [[CkoFileAccess alloc] init];
NSString *accessToken = [fac ReadEntireTextFile: @"qa_data/tokens/firebaseToken.txt" charset: @"utf-8"];
if (fac.LastMethodSuccess != YES) {
    NSLog(@"%@",fac.LastErrorText);
    return;
}

CkoRest *rest = [[CkoRest alloc] init];

// 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.  
BOOL success = [rest Connect: @"chilkat.firebaseio.com" port: [NSNumber numberWithInt: 443] tls: YES autoReconnect: YES];
if (success != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

CkoAuthGoogle *authGoogle = [[CkoAuthGoogle alloc] init];
authGoogle.AccessToken = accessToken;
[rest SetAuthGoogle: 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.
CkoPrng *prng = [[CkoPrng alloc] init];
NSString *pushId = [prng FirebasePushId];

// We're going to add a new pig with just the name.
CkoJsonObject *pigRecord = [[CkoJsonObject alloc] init];
[pigRecord AppendString: @"name" value: @"William"];

CkoStringBuilder *path = [[CkoStringBuilder alloc] init];
[path Append: @"/pig-rescue/animal/"];
[path Append: pushId];
[path Append: @".json"];

// The string content of the last arg passed is  {"name":"William"} 
NSString *jsonResponse = [rest FullRequestString: @"PUT" uriPath: [path GetAsString] bodyText: [pigRecord Emit]];
if (rest.LastMethodSuccess != YES) {
    // 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.)
    NSLog(@"%@",rest.LastErrorText);
    return;
}

// Check the response status code.   A 200 response status indicates success.
if ([rest.ResponseStatusCode intValue] != 200) {
    NSLog(@"%@",rest.ResponseStatusText);
    NSLog(@"%@",jsonResponse);
    NSLog(@"%@",@"Failed.");
    return;
}

NSLog(@"%@",jsonResponse);
NSLog(@"%@",@"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.  
//