60 lines
2.1 KiB
Ruby
60 lines
2.1 KiB
Ruby
|
require 'concurrent/utility/engine'
|
||
|
|
require 'concurrent/thread_safe/util'
|
||
|
|
|
||
|
|
module Concurrent
|
||
|
|
|
||
|
|
# @!macro concurrent_hash
|
||
|
|
#
|
||
|
|
# A thread-safe subclass of Hash. This version locks against the object
|
||
|
|
# itself for every method call, ensuring only one thread can be reading
|
||
|
|
# or writing at a time. This includes iteration methods like `#each`,
|
||
|
|
# which takes the lock repeatedly when reading an item.
|
||
|
|
#
|
||
|
|
# @see http://ruby-doc.org/core-2.2.0/Hash.html Ruby standard library `Hash`
|
||
|
|
|
||
|
|
# @!macro internal_implementation_note
|
||
|
|
HashImplementation = case
|
||
|
|
when Concurrent.on_cruby?
|
||
|
|
# Hash is thread-safe in practice because CRuby runs
|
||
|
|
# threads one at a time and does not do context
|
||
|
|
# switching during the execution of C functions.
|
||
|
|
::Hash
|
||
|
|
|
||
|
|
when Concurrent.on_jruby?
|
||
|
|
require 'jruby/synchronized'
|
||
|
|
|
||
|
|
class JRubyHash < ::Hash
|
||
|
|
include JRuby::Synchronized
|
||
|
|
end
|
||
|
|
JRubyHash
|
||
|
|
|
||
|
|
when Concurrent.on_rbx?
|
||
|
|
require 'monitor'
|
||
|
|
require 'concurrent/thread_safe/util/data_structures'
|
||
|
|
|
||
|
|
class RbxHash < ::Hash
|
||
|
|
end
|
||
|
|
ThreadSafe::Util.make_synchronized_on_rbx RbxHash
|
||
|
|
RbxHash
|
||
|
|
|
||
|
|
when Concurrent.on_truffleruby?
|
||
|
|
require 'concurrent/thread_safe/util/data_structures'
|
||
|
|
|
||
|
|
class TruffleRubyHash < ::Hash
|
||
|
|
end
|
||
|
|
|
||
|
|
ThreadSafe::Util.make_synchronized_on_truffleruby TruffleRubyHash
|
||
|
|
TruffleRubyHash
|
||
|
|
|
||
|
|
else
|
||
|
|
warn 'Possibly unsupported Ruby implementation'
|
||
|
|
::Hash
|
||
|
|
end
|
||
|
|
private_constant :HashImplementation
|
||
|
|
|
||
|
|
# @!macro concurrent_hash
|
||
|
|
class Hash < HashImplementation
|
||
|
|
end
|
||
|
|
|
||
|
|
end
|