Sha256: 0ee0c8a8209e58892a21a6d3e4fc0bdc09039d935731c1c7e4a4a0d0051e80fa
Contents?: true
Size: 1.95 KB
Versions: 33
Compression:
Stored size: 1.95 KB
Contents
# Copyright (C) 2016-2019 MongoDB, Inc.
#
# Licensed under the Apache License, Version 2.0 (the 'License');
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an 'AS IS' BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
module Mongo
# This module abstracts the functionality for generating sequential unique integer IDs for
# instances of the class. It defines the method #next_id on the class that includes it. The
# implementation ensures that the IDs will be unique even when called from multiple threads.
#
# @example Include the Id module.
# class Foo
# include Mongo::Id
# end
#
# f = Foo.new
# foo.next_id # => 1
# foo.next_id # => 2
#
# Classes which include Id should _not_ access `@@id` or `@@id_lock` directly; instead, they
# should call `#next_id` in `#initialize` and save the result in the instance being created.
#
# @example Save the ID in the instance of the including class.
# class Bar
# include Mongo::Id
#
# attr_reader :id
#
# def initialize
# @id = self.class.next_id
# end
# end
#
# a = Bar.new
# a.id # => 1
# b = Bar.new
# b.id # => 2
#
# @since 2.7.0
# @api private
module Id
def self.included(klass)
klass.class_variable_set(:@@id, 0)
klass.class_variable_set(:@@id_lock, Mutex.new)
klass.define_singleton_method(:next_id) do
klass.class_variable_get(:@@id_lock).synchronize do
id = class_variable_get(:@@id)
klass.class_variable_set(:@@id, id + 1)
klass.class_variable_get(:@@id)
end
end
end
end
end
Version data entries
33 entries across 33 versions & 2 rubygems