concurrent-ruby 1.1.9 → 1.2.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +24 -0
- data/Gemfile +2 -8
- data/README.md +34 -37
- data/Rakefile +48 -69
- data/ext/concurrent-ruby/com/concurrent_ruby/ext/JavaAtomicFixnumLibrary.java +0 -0
- data/ext/concurrent-ruby/com/concurrent_ruby/ext/JavaSemaphoreLibrary.java +52 -22
- data/ext/concurrent-ruby/com/concurrent_ruby/ext/SynchronizationLibrary.java +10 -25
- data/lib/concurrent-ruby/concurrent/agent.rb +2 -1
- data/lib/concurrent-ruby/concurrent/array.rb +0 -10
- data/lib/concurrent-ruby/concurrent/async.rb +1 -0
- data/lib/concurrent-ruby/concurrent/atom.rb +1 -1
- data/lib/concurrent-ruby/concurrent/atomic/atomic_boolean.rb +5 -4
- data/lib/concurrent-ruby/concurrent/atomic/atomic_fixnum.rb +5 -4
- data/lib/concurrent-ruby/concurrent/atomic/atomic_markable_reference.rb +3 -0
- data/lib/concurrent-ruby/concurrent/atomic/atomic_reference.rb +82 -151
- data/lib/concurrent-ruby/concurrent/atomic/cyclic_barrier.rb +1 -1
- data/lib/concurrent-ruby/concurrent/atomic/event.rb +3 -3
- data/lib/concurrent-ruby/concurrent/atomic/fiber_local_var.rb +109 -0
- data/lib/concurrent-ruby/concurrent/atomic/java_count_down_latch.rb +1 -0
- data/lib/concurrent-ruby/concurrent/atomic/locals.rb +188 -0
- data/lib/concurrent-ruby/concurrent/atomic/lock_local_var.rb +28 -0
- data/lib/concurrent-ruby/concurrent/atomic/mutex_atomic_boolean.rb +11 -5
- data/lib/concurrent-ruby/concurrent/atomic/mutex_atomic_fixnum.rb +11 -5
- data/lib/concurrent-ruby/concurrent/atomic/mutex_count_down_latch.rb +1 -1
- data/lib/concurrent-ruby/concurrent/atomic/mutex_semaphore.rb +19 -3
- data/lib/concurrent-ruby/concurrent/atomic/read_write_lock.rb +2 -1
- data/lib/concurrent-ruby/concurrent/atomic/reentrant_read_write_lock.rb +9 -9
- data/lib/concurrent-ruby/concurrent/atomic/semaphore.rb +32 -14
- data/lib/concurrent-ruby/concurrent/atomic/thread_local_var.rb +96 -89
- data/lib/concurrent-ruby/concurrent/atomic_reference/atomic_direct_update.rb +37 -0
- data/lib/concurrent-ruby/concurrent/atomic_reference/mutex_atomic.rb +15 -4
- data/lib/concurrent-ruby/concurrent/collection/copy_on_notify_observer_set.rb +1 -1
- data/lib/concurrent-ruby/concurrent/collection/copy_on_write_observer_set.rb +1 -1
- data/lib/concurrent-ruby/concurrent/collection/lock_free_stack.rb +2 -0
- data/lib/concurrent-ruby/concurrent/concern/logging.rb +86 -2
- data/lib/concurrent-ruby/concurrent/concurrent_ruby.jar +0 -0
- data/lib/concurrent-ruby/concurrent/configuration.rb +4 -87
- data/lib/concurrent-ruby/concurrent/delay.rb +2 -2
- data/lib/concurrent-ruby/concurrent/errors.rb +5 -0
- data/lib/concurrent-ruby/concurrent/exchanger.rb +1 -0
- data/lib/concurrent-ruby/concurrent/executor/abstract_executor_service.rb +17 -14
- data/lib/concurrent-ruby/concurrent/executor/fixed_thread_pool.rb +13 -3
- data/lib/concurrent-ruby/concurrent/executor/java_executor_service.rb +3 -3
- data/lib/concurrent-ruby/concurrent/executor/java_thread_pool_executor.rb +4 -0
- data/lib/concurrent-ruby/concurrent/executor/ruby_executor_service.rb +10 -4
- data/lib/concurrent-ruby/concurrent/executor/ruby_thread_pool_executor.rb +26 -37
- data/lib/concurrent-ruby/concurrent/executor/safe_task_executor.rb +6 -6
- data/lib/concurrent-ruby/concurrent/executor/serialized_execution.rb +1 -1
- data/lib/concurrent-ruby/concurrent/executor/simple_executor_service.rb +4 -1
- data/lib/concurrent-ruby/concurrent/hash.rb +0 -9
- data/lib/concurrent-ruby/concurrent/immutable_struct.rb +1 -1
- data/lib/concurrent-ruby/concurrent/ivar.rb +2 -1
- data/lib/concurrent-ruby/concurrent/map.rb +9 -9
- data/lib/concurrent-ruby/concurrent/maybe.rb +1 -1
- data/lib/concurrent-ruby/concurrent/mutable_struct.rb +1 -1
- data/lib/concurrent-ruby/concurrent/mvar.rb +1 -1
- data/lib/concurrent-ruby/concurrent/promise.rb +1 -1
- data/lib/concurrent-ruby/concurrent/promises.rb +7 -6
- data/lib/concurrent-ruby/concurrent/re_include.rb +2 -0
- data/lib/concurrent-ruby/concurrent/scheduled_task.rb +30 -17
- data/lib/concurrent-ruby/concurrent/set.rb +0 -10
- data/lib/concurrent-ruby/concurrent/settable_struct.rb +2 -2
- data/lib/concurrent-ruby/concurrent/synchronization/abstract_lockable_object.rb +5 -1
- data/lib/concurrent-ruby/concurrent/synchronization/abstract_object.rb +1 -3
- data/lib/concurrent-ruby/concurrent/synchronization/condition.rb +2 -0
- data/lib/concurrent-ruby/concurrent/synchronization/full_memory_barrier.rb +29 -0
- data/lib/concurrent-ruby/concurrent/synchronization/jruby_lockable_object.rb +3 -1
- data/lib/concurrent-ruby/concurrent/synchronization/lock.rb +2 -0
- data/lib/concurrent-ruby/concurrent/synchronization/lockable_object.rb +6 -5
- data/lib/concurrent-ruby/concurrent/synchronization/mutex_lockable_object.rb +6 -5
- data/lib/concurrent-ruby/concurrent/synchronization/object.rb +12 -44
- data/lib/concurrent-ruby/concurrent/synchronization/safe_initialization.rb +36 -0
- data/lib/concurrent-ruby/concurrent/synchronization/volatile.rb +77 -12
- data/lib/concurrent-ruby/concurrent/synchronization.rb +1 -18
- data/lib/concurrent-ruby/concurrent/thread_safe/synchronized_delegator.rb +36 -39
- data/lib/concurrent-ruby/concurrent/thread_safe/util/cheap_lockable.rb +2 -39
- data/lib/concurrent-ruby/concurrent/thread_safe/util/data_structures.rb +1 -37
- data/lib/concurrent-ruby/concurrent/timer_task.rb +11 -33
- data/lib/concurrent-ruby/concurrent/tuple.rb +1 -5
- data/lib/concurrent-ruby/concurrent/tvar.rb +22 -61
- data/lib/concurrent-ruby/concurrent/utility/engine.rb +5 -16
- data/lib/concurrent-ruby/concurrent/utility/monotonic_time.rb +7 -46
- data/lib/concurrent-ruby/concurrent/utility/native_extension_loader.rb +8 -10
- data/lib/concurrent-ruby/concurrent/utility/native_integer.rb +1 -0
- data/lib/concurrent-ruby/concurrent/utility/processor_counter.rb +36 -89
- data/lib/concurrent-ruby/concurrent/version.rb +1 -1
- data/lib/concurrent-ruby/concurrent-ruby.rb +5 -1
- metadata +10 -12
- data/lib/concurrent-ruby/concurrent/atomic/abstract_thread_local_var.rb +0 -66
- data/lib/concurrent-ruby/concurrent/atomic/java_thread_local_var.rb +0 -37
- data/lib/concurrent-ruby/concurrent/atomic/ruby_thread_local_var.rb +0 -181
- data/lib/concurrent-ruby/concurrent/synchronization/jruby_object.rb +0 -45
- data/lib/concurrent-ruby/concurrent/synchronization/mri_object.rb +0 -44
- data/lib/concurrent-ruby/concurrent/synchronization/rbx_lockable_object.rb +0 -71
- data/lib/concurrent-ruby/concurrent/synchronization/rbx_object.rb +0 -49
- data/lib/concurrent-ruby/concurrent/synchronization/truffleruby_object.rb +0 -47
@@ -1,16 +1,18 @@
|
|
1
|
-
require 'concurrent/synchronization'
|
1
|
+
require 'concurrent/synchronization/safe_initialization'
|
2
2
|
|
3
3
|
module Concurrent
|
4
4
|
|
5
5
|
# @!macro atomic_boolean
|
6
6
|
# @!visibility private
|
7
7
|
# @!macro internal_implementation_note
|
8
|
-
class MutexAtomicBoolean
|
8
|
+
class MutexAtomicBoolean
|
9
|
+
extend Concurrent::Synchronization::SafeInitialization
|
9
10
|
|
10
11
|
# @!macro atomic_boolean_method_initialize
|
11
12
|
def initialize(initial = false)
|
12
13
|
super()
|
13
|
-
|
14
|
+
@Lock = ::Mutex.new
|
15
|
+
@value = !!initial
|
14
16
|
end
|
15
17
|
|
16
18
|
# @!macro atomic_boolean_method_value_get
|
@@ -46,8 +48,12 @@ module Concurrent
|
|
46
48
|
protected
|
47
49
|
|
48
50
|
# @!visibility private
|
49
|
-
def
|
50
|
-
@
|
51
|
+
def synchronize
|
52
|
+
if @Lock.owned?
|
53
|
+
yield
|
54
|
+
else
|
55
|
+
@Lock.synchronize { yield }
|
56
|
+
end
|
51
57
|
end
|
52
58
|
|
53
59
|
private
|
@@ -1,4 +1,4 @@
|
|
1
|
-
require 'concurrent/synchronization'
|
1
|
+
require 'concurrent/synchronization/safe_initialization'
|
2
2
|
require 'concurrent/utility/native_integer'
|
3
3
|
|
4
4
|
module Concurrent
|
@@ -6,12 +6,14 @@ module Concurrent
|
|
6
6
|
# @!macro atomic_fixnum
|
7
7
|
# @!visibility private
|
8
8
|
# @!macro internal_implementation_note
|
9
|
-
class MutexAtomicFixnum
|
9
|
+
class MutexAtomicFixnum
|
10
|
+
extend Concurrent::Synchronization::SafeInitialization
|
10
11
|
|
11
12
|
# @!macro atomic_fixnum_method_initialize
|
12
13
|
def initialize(initial = 0)
|
13
14
|
super()
|
14
|
-
|
15
|
+
@Lock = ::Mutex.new
|
16
|
+
ns_set(initial)
|
15
17
|
end
|
16
18
|
|
17
19
|
# @!macro atomic_fixnum_method_value_get
|
@@ -60,8 +62,12 @@ module Concurrent
|
|
60
62
|
protected
|
61
63
|
|
62
64
|
# @!visibility private
|
63
|
-
def
|
64
|
-
|
65
|
+
def synchronize
|
66
|
+
if @Lock.owned?
|
67
|
+
yield
|
68
|
+
else
|
69
|
+
@Lock.synchronize { yield }
|
70
|
+
end
|
65
71
|
end
|
66
72
|
|
67
73
|
private
|
@@ -1,4 +1,4 @@
|
|
1
|
-
require 'concurrent/synchronization'
|
1
|
+
require 'concurrent/synchronization/lockable_object'
|
2
2
|
require 'concurrent/utility/native_integer'
|
3
3
|
|
4
4
|
module Concurrent
|
@@ -23,7 +23,14 @@ module Concurrent
|
|
23
23
|
|
24
24
|
synchronize do
|
25
25
|
try_acquire_timed(permits, nil)
|
26
|
-
|
26
|
+
end
|
27
|
+
|
28
|
+
return unless block_given?
|
29
|
+
|
30
|
+
begin
|
31
|
+
yield
|
32
|
+
ensure
|
33
|
+
release(permits)
|
27
34
|
end
|
28
35
|
end
|
29
36
|
|
@@ -48,13 +55,22 @@ module Concurrent
|
|
48
55
|
Utility::NativeInteger.ensure_integer_and_bounds permits
|
49
56
|
Utility::NativeInteger.ensure_positive permits
|
50
57
|
|
51
|
-
synchronize do
|
58
|
+
acquired = synchronize do
|
52
59
|
if timeout.nil?
|
53
60
|
try_acquire_now(permits)
|
54
61
|
else
|
55
62
|
try_acquire_timed(permits, timeout)
|
56
63
|
end
|
57
64
|
end
|
65
|
+
|
66
|
+
return acquired unless block_given?
|
67
|
+
return unless acquired
|
68
|
+
|
69
|
+
begin
|
70
|
+
yield
|
71
|
+
ensure
|
72
|
+
release(permits)
|
73
|
+
end
|
58
74
|
end
|
59
75
|
|
60
76
|
# @!macro semaphore_method_release
|
@@ -1,8 +1,10 @@
|
|
1
1
|
require 'thread'
|
2
2
|
require 'concurrent/atomic/atomic_reference'
|
3
|
+
require 'concurrent/atomic/atomic_fixnum'
|
3
4
|
require 'concurrent/errors'
|
4
|
-
require 'concurrent/synchronization'
|
5
|
-
require 'concurrent/
|
5
|
+
require 'concurrent/synchronization/object'
|
6
|
+
require 'concurrent/synchronization/lock'
|
7
|
+
require 'concurrent/atomic/lock_local_var'
|
6
8
|
|
7
9
|
module Concurrent
|
8
10
|
|
@@ -109,7 +111,7 @@ module Concurrent
|
|
109
111
|
@Counter = AtomicFixnum.new(0) # single integer which represents lock state
|
110
112
|
@ReadQueue = Synchronization::Lock.new # used to queue waiting readers
|
111
113
|
@WriteQueue = Synchronization::Lock.new # used to queue waiting writers
|
112
|
-
@HeldCount =
|
114
|
+
@HeldCount = LockLocalVar.new(0) # indicates # of R & W locks held by this thread
|
113
115
|
end
|
114
116
|
|
115
117
|
# Execute a block operation within a read lock.
|
@@ -267,12 +269,10 @@ module Concurrent
|
|
267
269
|
# running right now, AND no writers who came before us still waiting to
|
268
270
|
# acquire the lock
|
269
271
|
# Additionally, if any read locks have been taken, we must hold all of them
|
270
|
-
if
|
271
|
-
# If we successfully swap the RUNNING_WRITER bit on, then we can go ahead
|
272
|
-
|
273
|
-
|
274
|
-
return true
|
275
|
-
end
|
272
|
+
if held > 0 && @Counter.compare_and_set(1, c+RUNNING_WRITER)
|
273
|
+
# If we are the only one reader and successfully swap the RUNNING_WRITER bit on, then we can go ahead
|
274
|
+
@HeldCount.value = held + WRITE_LOCK_HELD
|
275
|
+
return true
|
276
276
|
elsif @Counter.compare_and_set(c, c+WAITING_WRITER)
|
277
277
|
while true
|
278
278
|
# Now we have successfully incremented, so no more readers will be able to increment
|
@@ -1,5 +1,4 @@
|
|
1
1
|
require 'concurrent/atomic/mutex_semaphore'
|
2
|
-
require 'concurrent/synchronization'
|
3
2
|
|
4
3
|
module Concurrent
|
5
4
|
|
@@ -11,19 +10,20 @@ module Concurrent
|
|
11
10
|
#
|
12
11
|
# @param [Fixnum] count the initial count
|
13
12
|
#
|
14
|
-
# @raise [ArgumentError] if `count` is not an integer
|
13
|
+
# @raise [ArgumentError] if `count` is not an integer
|
15
14
|
|
16
15
|
# @!macro semaphore_method_acquire
|
17
16
|
#
|
18
17
|
# Acquires the given number of permits from this semaphore,
|
19
|
-
# blocking until all are available.
|
18
|
+
# blocking until all are available. If a block is given,
|
19
|
+
# yields to it and releases the permits afterwards.
|
20
20
|
#
|
21
21
|
# @param [Fixnum] permits Number of permits to acquire
|
22
22
|
#
|
23
|
-
# @raise [ArgumentError] if `permits` is not an integer or is less than
|
24
|
-
# one
|
23
|
+
# @raise [ArgumentError] if `permits` is not an integer or is less than zero
|
25
24
|
#
|
26
|
-
# @return [nil]
|
25
|
+
# @return [nil, BasicObject] Without a block, `nil` is returned. If a block
|
26
|
+
# is given, its return value is returned.
|
27
27
|
|
28
28
|
# @!macro semaphore_method_available_permits
|
29
29
|
#
|
@@ -41,18 +41,21 @@ module Concurrent
|
|
41
41
|
#
|
42
42
|
# Acquires the given number of permits from this semaphore,
|
43
43
|
# only if all are available at the time of invocation or within
|
44
|
-
# `timeout` interval
|
44
|
+
# `timeout` interval. If a block is given, yields to it if the permits
|
45
|
+
# were successfully acquired, and releases them afterward, returning the
|
46
|
+
# block's return value.
|
45
47
|
#
|
46
48
|
# @param [Fixnum] permits the number of permits to acquire
|
47
49
|
#
|
48
50
|
# @param [Fixnum] timeout the number of seconds to wait for the counter
|
49
51
|
# or `nil` to return immediately
|
50
52
|
#
|
51
|
-
# @raise [ArgumentError] if `permits` is not an integer or is less than
|
52
|
-
# one
|
53
|
+
# @raise [ArgumentError] if `permits` is not an integer or is less than zero
|
53
54
|
#
|
54
|
-
# @return [
|
55
|
-
# acquired a permit
|
55
|
+
# @return [true, false, nil, BasicObject] `false` if no permits are
|
56
|
+
# available, `true` when acquired a permit. If a block is given, the
|
57
|
+
# block's return value is returned if the permits were acquired; if not,
|
58
|
+
# `nil` is returned.
|
56
59
|
|
57
60
|
# @!macro semaphore_method_release
|
58
61
|
#
|
@@ -60,7 +63,7 @@ module Concurrent
|
|
60
63
|
#
|
61
64
|
# @param [Fixnum] permits Number of permits to return to the semaphore.
|
62
65
|
#
|
63
|
-
# @raise [ArgumentError] if `permits` is not a number or is less than
|
66
|
+
# @raise [ArgumentError] if `permits` is not a number or is less than zero
|
64
67
|
#
|
65
68
|
# @return [nil]
|
66
69
|
|
@@ -90,8 +93,8 @@ module Concurrent
|
|
90
93
|
|
91
94
|
# @!visibility private
|
92
95
|
# @!macro internal_implementation_note
|
93
|
-
SemaphoreImplementation =
|
94
|
-
|
96
|
+
SemaphoreImplementation = if Concurrent.on_jruby?
|
97
|
+
require 'concurrent/utility/native_extension_loader'
|
95
98
|
JavaSemaphore
|
96
99
|
else
|
97
100
|
MutexSemaphore
|
@@ -106,6 +109,8 @@ module Concurrent
|
|
106
109
|
# releasing a blocking acquirer.
|
107
110
|
# However, no actual permit objects are used; the Semaphore just keeps a
|
108
111
|
# count of the number available and acts accordingly.
|
112
|
+
# Alternatively, permits may be acquired within a block, and automatically
|
113
|
+
# released after the block finishes executing.
|
109
114
|
#
|
110
115
|
# @!macro semaphore_public_api
|
111
116
|
# @example
|
@@ -140,6 +145,19 @@ module Concurrent
|
|
140
145
|
# # Thread 4 releasing semaphore
|
141
146
|
# # Thread 1 acquired semaphore
|
142
147
|
#
|
148
|
+
# @example
|
149
|
+
# semaphore = Concurrent::Semaphore.new(1)
|
150
|
+
#
|
151
|
+
# puts semaphore.available_permits
|
152
|
+
# semaphore.acquire do
|
153
|
+
# puts semaphore.available_permits
|
154
|
+
# end
|
155
|
+
# puts semaphore.available_permits
|
156
|
+
#
|
157
|
+
# # prints:
|
158
|
+
# # 1
|
159
|
+
# # 0
|
160
|
+
# # 1
|
143
161
|
class Semaphore < SemaphoreImplementation
|
144
162
|
end
|
145
163
|
end
|
@@ -1,104 +1,111 @@
|
|
1
|
-
require 'concurrent/
|
2
|
-
|
3
|
-
require 'concurrent/atomic/java_thread_local_var'
|
1
|
+
require 'concurrent/constants'
|
2
|
+
require_relative 'locals'
|
4
3
|
|
5
4
|
module Concurrent
|
6
5
|
|
7
|
-
|
8
|
-
|
9
|
-
#
|
6
|
+
# A `ThreadLocalVar` is a variable where the value is different for each thread.
|
7
|
+
# Each variable may have a default value, but when you modify the variable only
|
8
|
+
# the current thread will ever see that change.
|
9
|
+
#
|
10
|
+
# This is similar to Ruby's built-in thread-local variables (`Thread#thread_variable_get`),
|
11
|
+
# but with these major advantages:
|
12
|
+
# * `ThreadLocalVar` has its own identity, it doesn't need a Symbol.
|
13
|
+
# * Each Ruby's built-in thread-local variable leaks some memory forever (it's a Symbol held forever on the thread),
|
14
|
+
# so it's only OK to create a small amount of them.
|
15
|
+
# `ThreadLocalVar` has no such issue and it is fine to create many of them.
|
16
|
+
# * Ruby's built-in thread-local variables leak forever the value set on each thread (unless set to nil explicitly).
|
17
|
+
# `ThreadLocalVar` automatically removes the mapping for each thread once the `ThreadLocalVar` instance is GC'd.
|
18
|
+
#
|
19
|
+
# @!macro thread_safe_variable_comparison
|
20
|
+
#
|
21
|
+
# @example
|
22
|
+
# v = ThreadLocalVar.new(14)
|
23
|
+
# v.value #=> 14
|
24
|
+
# v.value = 2
|
25
|
+
# v.value #=> 2
|
26
|
+
#
|
27
|
+
# @example
|
28
|
+
# v = ThreadLocalVar.new(14)
|
29
|
+
#
|
30
|
+
# t1 = Thread.new do
|
31
|
+
# v.value #=> 14
|
32
|
+
# v.value = 1
|
33
|
+
# v.value #=> 1
|
34
|
+
# end
|
10
35
|
#
|
11
|
-
#
|
36
|
+
# t2 = Thread.new do
|
37
|
+
# v.value #=> 14
|
38
|
+
# v.value = 2
|
39
|
+
# v.value #=> 2
|
40
|
+
# end
|
12
41
|
#
|
13
|
-
#
|
14
|
-
|
15
|
-
|
42
|
+
# v.value #=> 14
|
43
|
+
class ThreadLocalVar
|
44
|
+
LOCALS = ThreadLocals.new
|
16
45
|
|
17
|
-
|
18
|
-
|
19
|
-
|
20
|
-
|
21
|
-
|
46
|
+
# Creates a thread local variable.
|
47
|
+
#
|
48
|
+
# @param [Object] default the default value when otherwise unset
|
49
|
+
# @param [Proc] default_block Optional block that gets called to obtain the
|
50
|
+
# default value for each thread
|
51
|
+
def initialize(default = nil, &default_block)
|
52
|
+
if default && block_given?
|
53
|
+
raise ArgumentError, "Cannot use both value and block as default value"
|
54
|
+
end
|
22
55
|
|
23
|
-
|
24
|
-
|
25
|
-
|
26
|
-
|
27
|
-
|
28
|
-
|
56
|
+
if block_given?
|
57
|
+
@default_block = default_block
|
58
|
+
@default = nil
|
59
|
+
else
|
60
|
+
@default_block = nil
|
61
|
+
@default = default
|
62
|
+
end
|
29
63
|
|
30
|
-
|
31
|
-
|
32
|
-
# Bind the given value to thread local storage during
|
33
|
-
# execution of the given block.
|
34
|
-
#
|
35
|
-
# @param [Object] value the value to bind
|
36
|
-
# @yield the operation to be performed with the bound variable
|
37
|
-
# @return [Object] the value
|
64
|
+
@index = LOCALS.next_index(self)
|
65
|
+
end
|
38
66
|
|
67
|
+
# Returns the value in the current thread's copy of this thread-local variable.
|
68
|
+
#
|
69
|
+
# @return [Object] the current value
|
70
|
+
def value
|
71
|
+
LOCALS.fetch(@index) { default }
|
72
|
+
end
|
39
73
|
|
40
|
-
|
74
|
+
# Sets the current thread's copy of this thread-local variable to the specified value.
|
75
|
+
#
|
76
|
+
# @param [Object] value the value to set
|
77
|
+
# @return [Object] the new value
|
78
|
+
def value=(value)
|
79
|
+
LOCALS.set(@index, value)
|
80
|
+
end
|
41
81
|
|
42
|
-
|
43
|
-
|
44
|
-
|
45
|
-
|
46
|
-
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
|
52
|
-
|
53
|
-
|
54
|
-
|
82
|
+
# Bind the given value to thread local storage during
|
83
|
+
# execution of the given block.
|
84
|
+
#
|
85
|
+
# @param [Object] value the value to bind
|
86
|
+
# @yield the operation to be performed with the bound variable
|
87
|
+
# @return [Object] the value
|
88
|
+
def bind(value)
|
89
|
+
if block_given?
|
90
|
+
old_value = self.value
|
91
|
+
self.value = value
|
92
|
+
begin
|
93
|
+
yield
|
94
|
+
ensure
|
95
|
+
self.value = old_value
|
96
|
+
end
|
97
|
+
end
|
98
|
+
end
|
55
99
|
|
56
|
-
|
100
|
+
protected
|
57
101
|
|
58
|
-
|
59
|
-
|
60
|
-
|
61
|
-
|
62
|
-
|
63
|
-
|
64
|
-
|
65
|
-
|
66
|
-
private_constant :ThreadLocalVarImplementation
|
67
|
-
|
68
|
-
# @!macro thread_local_var
|
69
|
-
#
|
70
|
-
# A `ThreadLocalVar` is a variable where the value is different for each thread.
|
71
|
-
# Each variable may have a default value, but when you modify the variable only
|
72
|
-
# the current thread will ever see that change.
|
73
|
-
#
|
74
|
-
# @!macro thread_safe_variable_comparison
|
75
|
-
#
|
76
|
-
# @example
|
77
|
-
# v = ThreadLocalVar.new(14)
|
78
|
-
# v.value #=> 14
|
79
|
-
# v.value = 2
|
80
|
-
# v.value #=> 2
|
81
|
-
#
|
82
|
-
# @example
|
83
|
-
# v = ThreadLocalVar.new(14)
|
84
|
-
#
|
85
|
-
# t1 = Thread.new do
|
86
|
-
# v.value #=> 14
|
87
|
-
# v.value = 1
|
88
|
-
# v.value #=> 1
|
89
|
-
# end
|
90
|
-
#
|
91
|
-
# t2 = Thread.new do
|
92
|
-
# v.value #=> 14
|
93
|
-
# v.value = 2
|
94
|
-
# v.value #=> 2
|
95
|
-
# end
|
96
|
-
#
|
97
|
-
# v.value #=> 14
|
98
|
-
#
|
99
|
-
# @see https://docs.oracle.com/javase/7/docs/api/java/lang/ThreadLocal.html Java ThreadLocal
|
100
|
-
#
|
101
|
-
# @!macro thread_local_var_public_api
|
102
|
-
class ThreadLocalVar < ThreadLocalVarImplementation
|
102
|
+
# @!visibility private
|
103
|
+
def default
|
104
|
+
if @default_block
|
105
|
+
self.value = @default_block.call
|
106
|
+
else
|
107
|
+
@default
|
108
|
+
end
|
109
|
+
end
|
103
110
|
end
|
104
111
|
end
|
@@ -0,0 +1,37 @@
|
|
1
|
+
require 'concurrent/errors'
|
2
|
+
|
3
|
+
module Concurrent
|
4
|
+
|
5
|
+
# Define update methods that use direct paths
|
6
|
+
#
|
7
|
+
# @!visibility private
|
8
|
+
# @!macro internal_implementation_note
|
9
|
+
module AtomicDirectUpdate
|
10
|
+
def update
|
11
|
+
true until compare_and_set(old_value = get, new_value = yield(old_value))
|
12
|
+
new_value
|
13
|
+
end
|
14
|
+
|
15
|
+
def try_update
|
16
|
+
old_value = get
|
17
|
+
new_value = yield old_value
|
18
|
+
|
19
|
+
return unless compare_and_set old_value, new_value
|
20
|
+
|
21
|
+
new_value
|
22
|
+
end
|
23
|
+
|
24
|
+
def try_update!
|
25
|
+
old_value = get
|
26
|
+
new_value = yield old_value
|
27
|
+
unless compare_and_set(old_value, new_value)
|
28
|
+
if $VERBOSE
|
29
|
+
raise ConcurrentUpdateError, "Update failed"
|
30
|
+
else
|
31
|
+
raise ConcurrentUpdateError, "Update failed", ConcurrentUpdateError::CONC_UP_ERR_BACKTRACE
|
32
|
+
end
|
33
|
+
end
|
34
|
+
new_value
|
35
|
+
end
|
36
|
+
end
|
37
|
+
end
|
@@ -1,8 +1,13 @@
|
|
1
|
+
require 'concurrent/atomic_reference/atomic_direct_update'
|
2
|
+
require 'concurrent/atomic_reference/numeric_cas_wrapper'
|
3
|
+
require 'concurrent/synchronization/safe_initialization'
|
4
|
+
|
1
5
|
module Concurrent
|
2
6
|
|
3
7
|
# @!visibility private
|
4
8
|
# @!macro internal_implementation_note
|
5
|
-
class MutexAtomicReference
|
9
|
+
class MutexAtomicReference
|
10
|
+
extend Concurrent::Synchronization::SafeInitialization
|
6
11
|
include AtomicDirectUpdate
|
7
12
|
include AtomicNumericCompareAndSetWrapper
|
8
13
|
alias_method :compare_and_swap, :compare_and_set
|
@@ -10,7 +15,8 @@ module Concurrent
|
|
10
15
|
# @!macro atomic_reference_method_initialize
|
11
16
|
def initialize(value = nil)
|
12
17
|
super()
|
13
|
-
|
18
|
+
@Lock = ::Mutex.new
|
19
|
+
@value = value
|
14
20
|
end
|
15
21
|
|
16
22
|
# @!macro atomic_reference_method_get
|
@@ -49,8 +55,13 @@ module Concurrent
|
|
49
55
|
|
50
56
|
protected
|
51
57
|
|
52
|
-
|
53
|
-
|
58
|
+
# @!visibility private
|
59
|
+
def synchronize
|
60
|
+
if @Lock.owned?
|
61
|
+
yield
|
62
|
+
else
|
63
|
+
@Lock.synchronize { yield }
|
64
|
+
end
|
54
65
|
end
|
55
66
|
end
|
56
67
|
end
|