This is a default queue implementation that ships with Notifications
. It just pushes events to all registered log subscribers.
This class is thread safe. All methods are reentrant.
Namespace
- MODULE ActiveSupport::Notifications::Fanout::Subscribers
- CLASS ActiveSupport::Notifications::Fanout::Handle
Methods
- A
- B
- F
- L
- N
- P
- S
- U
- W
Included Modules
- Mutex_m
Class Public methods
new() Link
# File activesupport/lib/active_support/notifications/fanout.rb, line 54 def initialize @string_subscribers = Concurrent::Map.new { |h, k| h.compute_if_absent(k) { [] } } @other_subscribers = [] @all_listeners_for = Concurrent::Map.new @groups_for = Concurrent::Map.new @silenceable_groups_for = Concurrent::Map.new super end
Instance Public methods
all_listeners_for(name) Link
# File activesupport/lib/active_support/notifications/fanout.rb, line 301 def all_listeners_for(name) # this is correctly done double-checked locking (Concurrent::Map's lookups have volatile semantics) @all_listeners_for[name] || synchronize do # use synchronisation when accessing @subscribers @all_listeners_for[name] ||= @string_subscribers[name] + @other_subscribers.select { |s| s.subscribed_to?(name) } end end
build_handle(name, id, payload) Link
finish(name, id, payload, listeners = nil) Link
listeners_for(name) Link
listening?(name) Link
publish(name, *args) Link
publish_event(event) Link
start(name, id, payload) Link
subscribe(pattern = nil, callable = nil, monotonic: false, &block) Link
# File activesupport/lib/active_support/notifications/fanout.rb, line 68 def subscribe(pattern = nil, callable = nil, monotonic: false, &block) subscriber = Subscribers.new(pattern, callable || block, monotonic) synchronize do case pattern when String @string_subscribers[pattern] << subscriber clear_cache(pattern) when NilClass, Regexp @other_subscribers << subscriber clear_cache else raise ArgumentError, "pattern must be specified as a String, Regexp or empty" end end subscriber end
unsubscribe(subscriber_or_name) Link
# File activesupport/lib/active_support/notifications/fanout.rb, line 85 def unsubscribe(subscriber_or_name) synchronize do case subscriber_or_name when String @string_subscribers[subscriber_or_name].clear clear_cache(subscriber_or_name) @other_subscribers.each { |sub| sub.unsubscribe!(subscriber_or_name) } else pattern = subscriber_or_name.try(:pattern) if String === pattern @string_subscribers[pattern].delete(subscriber_or_name) clear_cache(pattern) else @other_subscribers.delete(subscriber_or_name) clear_cache end end end end