Struct Node

pub struct Node<'a> { /* private fields */ }

Represents a node in the Firebase Realtime Database.

Nodes are used to traverse the database hierarchy and perform operations at specific paths. Each node maintains its full path and can create child nodes or perform CRUD operations.

The path is built incrementally using the builder pattern, allowing for fluent API usage.

Example

use firebase_rtdb::{FirebaseRTDB, RtdbError};

 async fn example() -> Result<(), RtdbError> {
    let mut db = FirebaseRTDB::new_from_jwt("https://your-project.firebaseio.com", "your-jwt-token", "your-api-key").await?;
    let mut root = db.root().await?;
    let users = root
        .child("users")
        .child("user123")
        .child("profile");
    Ok(())
}

Implementations

impl Node<'_>

pub fn child<T: AsRef<str>>(&mut self, child: T) -> &mut Self

Creates a new child node at the specified path.

Arguments

• child - The name of the child node to create

Returns

Returns a mutable reference to the new child node

pub fn final_node<T: AsRef<str>>(&mut self, node: T) -> &Self

Finalizes the node path with a last segment.

Similar to child() but returns an immutable reference, useful for immediately performing an operation.

pub async fn get(&self) -> Result<String, RtdbError>

Retrieves data at the current node path.

Performs a GET request to fetch the current value at this database location.

pub async fn put<T: Serialize>(&self, input: T) -> Result<String, RtdbError>

Writes data to the current node path.

Performs a PUT request to set the value at this database location. The input must be serializable to JSON.

pub async fn post<T: Serialize>(&self, input: T) -> Result<String, RtdbError>

Creates a new child with a unique key.

Performs a POST request to create a new child with a Firebase-generated key and the provided data.

pub async fn patch<T: Serialize>(&self, input: T) -> Result<String, RtdbError>

Updates specific fields at the current path.

Performs a PATCH request to update only the specified fields while leaving others unchanged.

pub async fn delete(&self) -> Result<String, RtdbError>

Removes data at the current path.

Performs a DELETE request to remove all data at this location.