Struct ShardMap 

pub struct ShardMap { /* private fields */ }

Consistent hash ring for shard mapping.

Implementations

impl ShardMap

pub fn new() -> Self

Create a new empty shard map with default configuration.

pub fn with_config(config: ShardMapConfig) -> Self

Create a shard map with custom configuration.

pub fn add_node(&mut self, node: NodeId)

Add a node to the ring.

pub fn remove_node(&mut self, node_id: &str) -> bool

Remove a node from the ring.

pub fn lookup(&self, key: &str) -> Option<&str>

Look up which node a key maps to.

pub fn node_count(&self) -> usize

Get the number of physical nodes.

pub fn vnode_count(&self) -> usize

Get the total number of virtual nodes on the ring.

pub fn has_node(&self, node_id: &str) -> bool

Check if the ring contains a specific node.

pub fn node_ids(&self) -> Vec<&str>

Get all registered node IDs.

pub fn load_distribution(&self) -> HashMap<String, usize>

Compute load distribution: how many virtual nodes each physical node owns.

pub fn load_factor(&self) -> f64

Compute the load factor (std dev / mean of vnode counts).

Trait Implementations

impl Clone for ShardMap

fn clone(&self) -> ShardMap

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ShardMap

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ShardMap

fn default() -> Self

Returns the “default value” for a type.