ConsistentHash API

Constructor

new ConsistentHash(config?: Partial<HashConfig>)

Tham số

Param	Kiểu	Mặc định	Mô tả
config.virtualNodes	number	150	Số virtual nodes cho mỗi physical node

Phương thức

getNode(key: string): HashNode | null

Tìm node chịu trách nhiệm cho một key.

const node = hash.getNode("user:123");
console.log(node?.id); // "node-1"

addNode(node: HashNode): void

Thêm node vào hash ring.

hash.addNode({ id: "node-3" });

removeNode(nodeId: string): void

Xóa node khỏi hash ring.

hash.removeNode("node-1");

getKeyDistribution(): Map<string, number>

Lấy số lượng keys per node.

const distribution = hash.getKeyDistribution();
console.log(distribution);
// Map { "node-0" => 365, "node-1" => 346, "node-2" => 289 }

getRingSize(): number

Lấy tổng số virtual nodes trên ring.

const size = hash.getRingSize();
console.log(size); // 450 (3 nodes × 150 virtual nodes)

hasNode(nodeId: string): boolean

Kiểm tra node có tồn tại trên ring không.

if (hash.hasNode("node-0")) {
  // node tồn tại
}

getNodes(): HashNode[]

Lấy tất cả physical nodes trên ring.

const nodes = hash.getNodes();
console.log(nodes); // [{ id: "node-0" }, { id: "node-1" }, ...]

Interfaces

HashNode

interface HashNode {
  id: string;
}

HashConfig

interface HashConfig {
  virtualNodes: number; // mặc định: 150
}