Rust

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:

Rust

// 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.
let fac = chilkat::FileAccess::new();
let Ok(access_token) = fac.read_entire_text_file("qa_data/tokens/firebaseToken.txt", "utf-8") else {
    println!("{}", fac.last_error_text());
    return;
};

let rest = chilkat::Rest::new();

// 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.  
if rest.connect("chilkat.firebaseio.com", 443, true, true).is_err() {
    println!("{}", rest.last_error_text());
    return;
}

let auth_google = chilkat::AuthGoogle::new();
auth_google.set_access_token(&access_token);
let _ = rest.set_auth_google(&auth_google);

// 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.
let prng = chilkat::Prng::new();
let push_id = prng.firebase_push_id().unwrap_or_default();

// We're going to add a new pig with just the name.
let pig_record = chilkat::JsonObject::new();
let _ = pig_record.append_string("name", "William");

let path = chilkat::StringBuilder::new();
let _ = path.append("/pig-rescue/animal/");
let _ = path.append(&push_id);
let _ = path.append(".json");

// The string content of the last arg passed is  {"name":"William"} 
let Ok(json_response) = rest.full_request_string("PUT", &path.get_as_string().unwrap_or_default(), &pig_record.emit().unwrap_or_default()) else {
    // 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.)
    println!("{}", rest.last_error_text());
    return;
};

// Check the response status code.   A 200 response status indicates success.
if rest.response_status_code() != 200 {
    println!("{}", rest.response_status_text());
    println!("{}", json_response);
    println!("Failed.");
    return;
}

println!("{}", json_response);
println!("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.  
//