Struct NodeStore

Source

pub struct NodeStore;

Expand description

Node storage operations.

NodeStore provides transactional CRUD operations for graph nodes (entities). All operations work within a transaction context for ACID guarantees.

§Example

use manifoldb_graph::store::{NodeStore, IdGenerator};

// Create a node
let gen = IdGenerator::new();
let entity = NodeStore::create(&mut tx, &gen, |id| {
    Entity::new(id)
        .with_label("Person")
        .with_property("name", "Alice")
})?;

// Read it back
let retrieved = NodeStore::get(&tx, entity.id)?;

Implementations§

Source §

impl NodeStore

Source

pub fn create<T: Transaction, F>( tx: &mut T, id_gen: &IdGenerator, builder: F, ) -> GraphResult<Entity>
where F: FnOnce(EntityId) -> Entity,

Create a new entity in the store.

The provided function receives a new unique ID and should return the entity to store. The entity’s ID will be set to the generated ID.

§Arguments

tx - The transaction to use
id_gen - The ID generator
builder - A function that builds the entity given an ID

§Returns

The created entity with its assigned ID.

§Errors

Returns an error if the entity cannot be stored.

Source

pub fn create_with_id<T: Transaction>( tx: &mut T, entity: &Entity, ) -> GraphResult<()>

Create an entity with a specific ID.

This is useful when importing data or when you need to control IDs.

§Arguments

tx - The transaction to use
entity - The entity to store (must have a valid ID)

§Errors

Returns GraphError::EntityAlreadyExists if an entity with this ID exists.

Source

pub fn get<T: Transaction>(tx: &T, id: EntityId) -> GraphResult<Option<Entity>>

Get an entity by ID.

§Arguments

tx - The transaction to use
id - The entity ID to look up

§Returns

The entity if found, or None if it doesn’t exist.

§Errors

Returns an error if the entity cannot be decoded.

Source

pub fn get_or_error<T: Transaction>(tx: &T, id: EntityId) -> GraphResult<Entity>

Get an entity by ID, returning an error if not found.

§Arguments

tx - The transaction to use
id - The entity ID to look up

§Errors

Returns GraphError::EntityNotFound if the entity doesn’t exist.

Source

pub fn exists<T: Transaction>(tx: &T, id: EntityId) -> GraphResult<bool>

Check if an entity exists.

§Arguments

tx - The transaction to use
id - The entity ID to check

Source

pub fn update<T: Transaction>(tx: &mut T, entity: &Entity) -> GraphResult<()>

Update an existing entity.

This replaces the entire entity. To update specific fields, first get the entity, modify it, then update.

§Arguments

tx - The transaction to use
entity - The entity with updated data

§Errors

Returns GraphError::EntityNotFound if the entity doesn’t exist.

Source

pub fn delete<T: Transaction>(tx: &mut T, id: EntityId) -> GraphResult<bool>

Delete an entity by ID.

This also removes all label index entries for the entity. Note: This does NOT delete edges connected to this entity. Use crate::store::EdgeStore::delete_edges_for_entity to clean up edges first.