require 'digest/md5' require 'set' module ConsistentHashing # Public: the hash ring containing all configured nodes # class Ring # Public: returns a new ring object def initialize(nodes = [], replicas = 3) @replicas = replicas @ring = AVLTree.new nodes.each { |node| add(node) } end # Public: returns the (virtual) points in the hash ring # # Returns: a Fixnum def length @ring.length end # Public: adds a new node into the hash ring # def add(node) @replicas.times do |i| # generate the key of this (virtual) point in the hash key = hash_key(node, i) @ring[key] = VirtualPoint.new(node, key) end end # Public: an alias for `add` # def <<(node) add(node) end # Public: removes a node from the hash ring # def delete(node) @replicas.times do |i| key = hash_key(node, i) @ring.delete key end end # Public: gets the point for an arbitrary key # # def point_for(key) return nil if @ring.empty? key = hash_key(key) _, value = @ring.next_gte_pair(key) _, value = @ring.minimum_pair unless value value end # Public: gets the node where to store the key # # Returns: the node Object def node_for(key) point_for(key).node end # Public: get all nodes in the ring # # Returns: an Array of the nodes in the ring def nodes nodes = points.map { |point| point.node } nodes.uniq end # Public: gets all points in the ring # # Returns: an Array of the points in the ring def points @ring.map { |point| point[1] } end protected # Internal: hashes the key # # Returns: a String def hash_key(key, index = nil) key = "#{key}:#{index}" if index Digest::MD5.hexdigest(key.to_s)[0..16].hex end end end