/Ruby on Rails 7.0

module ActiveSupport::PerThreadRegistry

NOTE: This approach has been deprecated for end-user code in favor of thread_mattr_accessor and friends. Please use that approach instead.

This module is used to encapsulate access to thread local variables.

Instead of polluting the thread locals namespace:


you define a class that extends this module:

module ActiveRecord
  class RuntimeRegistry
    extend ActiveSupport::PerThreadRegistry

    attr_accessor :connection_handler

and invoke the declared instance accessors as class methods. So

ActiveRecord::RuntimeRegistry.connection_handler = connection_handler

sets a connection handler local to the current thread, and


returns a connection handler local to the current thread.

This feature is accomplished by instantiating the class and storing the instance as a thread local keyed by the class name. In the example above a key “ActiveRecord::RuntimeRegistry” is stored in Thread.current. The class methods proxy to said thread local instance.

If the class has an initializer, it must accept no arguments.

Public Class Methods

extended(object) Show source
# File activesupport/lib/active_support/per_thread_registry.rb, line 42
    def self.extended(object)
        ActiveSupport::PerThreadRegistry is deprecated and will be removed in Rails 7.1.
        Use `Module#thread_mattr_accessor` instead.
      object.instance_variable_set :@per_thread_registry_key, object.name.freeze

Public Instance Methods

instance() Show source
# File activesupport/lib/active_support/per_thread_registry.rb, line 50
def instance
  Thread.current[@per_thread_registry_key] ||= new

© 2004–2021 David Heinemeier Hansson
Licensed under the MIT License.