Class: ActiveSupport::Notifications::Fanout
| Relationships & Source Files | |
| Namespace Children | |
|
Modules:
| |
|
Classes:
| |
| Super Chains via Extension / Inclusion / Inheritance | |
|
Instance Chain:
self,
FanoutIteration
|
|
| Inherits: | Object |
| Defined in: | activesupport/lib/active_support/notifications/fanout.rb |
Overview
This is a default queue implementation that ships with ::ActiveSupport::Notifications.
It just pushes events to all registered log subscribers.
This class is thread safe. All methods are reentrant.
Class Method Summary
- .new ⇒ Fanout constructor
Instance Method Summary
- #all_listeners_for(name)
- #build_handle(name, id, payload)
- #finish(name, id, payload, listeners = nil)
- #listeners_for(name)
- #listening?(name) ⇒ Boolean
- #publish(name)
- #publish_event(event)
- #start(name, id, payload)
- #subscribe(pattern = nil, callable = nil, monotonic: false, prepend: false, &block)
- #unsubscribe(subscriber_or_name)
-
#wait
This is a sync queue, so there is no waiting.
- #clear_cache(key = nil) Internal use only
- #group_listeners(listeners) Internal use only
- #groups_for(name) Internal use only
- #inspect Internal use only
- #load_ractor_snapshot(registry) Internal use only
- #to_ractor_snapshot Internal use only
FanoutIteration - Included
Constructor Details
.new ⇒ Fanout
Instance Method Details
#all_listeners_for(name)
[ GitHub ]# File 'activesupport/lib/active_support/notifications/fanout.rb', line 398
def all_listeners_for(name) # this is correctly done double-checked locking (Concurrent::Map's lookups have volatile semantics) @all_listeners_for[name] || @mutex.synchronize do # use synchronisation when accessing @registry @all_listeners_for[name] ||= @registry[name] + @registry.other_subscribers.select { |s| s.subscribed_to?(name) } end end
#build_handle(name, id, payload)
[ GitHub ]# File 'activesupport/lib/active_support/notifications/fanout.rb', line 365
def build_handle(name, id, payload) groups = groups_for(name).map do |group_klass, grouped_listeners| group_klass.new(grouped_listeners, name, id, payload) end if groups.empty? NullHandle else Handle.new(name, id, groups, payload) end end
#clear_cache(key = nil)
This method is for internal use only.
[ GitHub ]
# File 'activesupport/lib/active_support/notifications/fanout.rb', line 183
def clear_cache(key = nil) # :nodoc: if key @all_listeners_for.delete(key) @groups_for.delete(key) else @all_listeners_for.clear @groups_for.clear end end
#finish(name, id, payload, listeners = nil)
[ GitHub ]# File 'activesupport/lib/active_support/notifications/fanout.rb', line 384
def finish(name, id, payload, listeners = nil) handle_stack = IsolatedExecutionState[:_fanout_handle_stack] handle = handle_stack.pop handle.finish_with_values(name, id, payload) end
#group_listeners(listeners)
This method is for internal use only.
[ GitHub ]
# File 'activesupport/lib/active_support/notifications/fanout.rb', line 267
def group_listeners(listeners) # :nodoc: listeners.group_by(&:group_class).transform_values do |s| s.map(&:delegate).freeze end.freeze end
#groups_for(name)
This method is for internal use only.
[ GitHub ]
# File 'activesupport/lib/active_support/notifications/fanout.rb', line 273
def groups_for(name) # :nodoc: silenceable_groups, groups = @groups_for.compute_if_absent(name) do listeners = all_listeners_for(name) listeners.partition(&:silenceable).map { |l| group_listeners(l) } end unless silenceable_groups.empty? silenceable_groups.each do |group_class, subscriptions| active_subscriptions = subscriptions.reject { |s| s.silenced?(name) } unless active_subscriptions.empty? groups = groups.dup if groups.frozen? base_groups = groups[group_class] groups[group_class] = base_groups ? base_groups + active_subscriptions : active_subscriptions end end end groups end
#inspect
This method is for internal use only.
[ GitHub ]
# File 'activesupport/lib/active_support/notifications/fanout.rb', line 140
def inspect # :nodoc: "#<#{self.class} (#{@registry.size} patterns)>" end
#listeners_for(name)
[ GitHub ]# File 'activesupport/lib/active_support/notifications/fanout.rb', line 407
def listeners_for(name) all_listeners_for(name).reject { |s| s.silenced?(name) } end
#listening?(name) ⇒ Boolean
# File 'activesupport/lib/active_support/notifications/fanout.rb', line 411
def listening?(name) all_listeners_for(name).any? { |s| !s.silenced?(name) } end
#load_ractor_snapshot(registry)
This method is for internal use only.
[ GitHub ]
# File 'activesupport/lib/active_support/notifications/fanout.rb', line 133
def load_ractor_snapshot(registry) # :nodoc: @mutex.synchronize do @registry = registry clear_cache end end
#publish(name)
[ GitHub ]# File 'activesupport/lib/active_support/notifications/fanout.rb', line 390
def publish(name, ...) iterate_guarding_exceptions(listeners_for(name)) { |s| s.publish(name, ...) } end
#publish_event(event)
[ GitHub ]# File 'activesupport/lib/active_support/notifications/fanout.rb', line 394
def publish_event(event) iterate_guarding_exceptions(listeners_for(event.name)) { |s| s.publish_event(event) } end
#start(name, id, payload)
[ GitHub ]# File 'activesupport/lib/active_support/notifications/fanout.rb', line 377
def start(name, id, payload) handle_stack = (IsolatedExecutionState[:_fanout_handle_stack] ||= []) handle = build_handle(name, id, payload) handle_stack << handle handle.start end
#subscribe(pattern = nil, callable = nil, monotonic: false, prepend: false, &block)
[ GitHub ]# File 'activesupport/lib/active_support/notifications/fanout.rb', line 144
def subscribe(pattern = nil, callable = nil, monotonic: false, prepend: false, &block) block = ActiveSupport::Ractors.try_shareable_proc(block) if block subscriber = Subscribers.new(pattern, callable || block, monotonic) @mutex.synchronize do case pattern when String @registry = @registry.add(subscriber, prepend: prepend) clear_cache(pattern) when NilClass, Regexp if prepend raise ArgumentError, "Cannot prepend Regex subscribers" end @registry = @registry.add(subscriber) clear_cache else raise ArgumentError, "pattern must be specified as a String, Regexp or empty" end end subscriber end
#to_ractor_snapshot
This method is for internal use only.
[ GitHub ]
# File 'activesupport/lib/active_support/notifications/fanout.rb', line 129
def to_ractor_snapshot # :nodoc: @registry end
#unsubscribe(subscriber_or_name)
[ GitHub ]# File 'activesupport/lib/active_support/notifications/fanout.rb', line 166
def unsubscribe(subscriber_or_name) @mutex.synchronize do case subscriber_or_name when String @registry = @registry.delete_pattern(subscriber_or_name) @registry.other_subscribers.each { |sub| sub.unsubscribe!(subscriber_or_name) } clear_cache(subscriber_or_name) else pattern = subscriber_or_name.try(:pattern) pattern = nil unless String === pattern @registry = @registry.delete(subscriber_or_name) clear_cache(pattern) end end end
#wait
This is a sync queue, so there is no waiting.
# File 'activesupport/lib/active_support/notifications/fanout.rb', line 416
def wait end