Class: ActiveSupport::CurrentAttributes

Inherits:
Object
  • Object
show all
Includes:
Callbacks
Defined in:
lib/active_support/current_attributes.rb

Overview

Abstract super class that provides a thread-isolated attributes singleton, which resets automatically before and after each request. This allows you to keep all the per-request attributes easily available to the whole system.

The following full app-like example demonstrates how to use a Current class to facilitate easy access to the global, per-request attributes without passing them deeply around everywhere:

# app/models/current.rb
class Current < ActiveSupport::CurrentAttributes
  attribute :account, :user
  attribute :request_id, :user_agent, :ip_address

  resets { Time.zone = nil }

  def user=(user)
    super
    self. = user.
    Time.zone    = user.time_zone
  end
end

# app/controllers/concerns/authentication.rb
module Authentication
  extend ActiveSupport::Concern

  included do
    before_action :authenticate
  end

  private
    def authenticate
      if authenticated_user = User.find_by(id: cookies.encrypted[:user_id])
        Current.user = authenticated_user
      else
        redirect_to new_session_url
      end
    end
end

# app/controllers/concerns/set_current_request_details.rb
module SetCurrentRequestDetails
  extend ActiveSupport::Concern

  included do
    before_action do
      Current.request_id = request.uuid
      Current.user_agent = request.user_agent
      Current.ip_address = request.ip
    end
  end
end

class ApplicationController < ActionController::Base
  include Authentication
  include SetCurrentRequestDetails
end

class MessagesController < ApplicationController
  def create
    Current..messages.create(message_params)
  end
end

class Message < ApplicationRecord
  belongs_to :creator, default: -> { Current.user }
  after_create { |message| Event.create(record: message) }
end

class Event < ApplicationRecord
  before_create do
    self.request_id = Current.request_id
    self.user_agent = Current.user_agent
    self.ip_address = Current.ip_address
  end
end

A word of caution: It's easy to overdo a global singleton like Current and tangle your model as a result. Current should only be used for a few, top-level globals, like account, user, and request details. The attributes stuck in Current should be used by more or less all actions on all requests. If you start sticking controller-specific attributes in there, you're going to create a mess.

Defined Under Namespace

Modules: TestHelper

Constant Summary

Constants included from Callbacks

ActiveSupport::Callbacks::CALLBACK_FILTER_TYPES

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Callbacks

#run_callbacks

Methods included from Concern

#append_features, #class_methods, extended, #included, #prepend_features, #prepended

Constructor Details

#initializeCurrentAttributes

Returns a new instance of CurrentAttributes.

[View source]

171
172
173
# File 'lib/active_support/current_attributes.rb', line 171

def initialize
  @attributes = {}
end

Instance Attribute Details

#attributesObject

Returns the value of attribute attributes.


169
170
171
# File 'lib/active_support/current_attributes.rb', line 169

def attributes
  @attributes
end

Class Method Details

.attribute(*names) ⇒ Object

Declares one or more attributes that will be given both class and instance accessor methods.

[View source]

100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
# File 'lib/active_support/current_attributes.rb', line 100

def attribute(*names)
  generated_attribute_methods.module_eval do
    names.each do |name|
      define_method(name) do
        attributes[name.to_sym]
      end

      define_method("#{name}=") do |attribute|
        attributes[name.to_sym] = attribute
      end
    end
  end

  names.each do |name|
    define_singleton_method(name) do
      instance.public_send(name)
    end

    define_singleton_method("#{name}=") do |attribute|
      instance.public_send("#{name}=", attribute)
    end
  end
end

.before_reset(&block) ⇒ Object

Calls this block before #reset is called on the instance. Used for resetting external collaborators that depend on current values.

[View source]

125
126
127
# File 'lib/active_support/current_attributes.rb', line 125

def before_reset(&block)
  set_callback :reset, :before, &block
end

.clear_allObject

:nodoc:

[View source]

141
142
143
144
# File 'lib/active_support/current_attributes.rb', line 141

def clear_all # :nodoc:
  reset_all
  current_instances.clear
end

.instanceObject

Returns singleton instance for this class in this thread. If none exists, one is created.

[View source]

95
96
97
# File 'lib/active_support/current_attributes.rb', line 95

def instance
  current_instances[current_instances_key] ||= new
end

.reset_allObject

:nodoc:

[View source]

137
138
139
# File 'lib/active_support/current_attributes.rb', line 137

def reset_all # :nodoc:
  current_instances.each_value(&:reset)
end

.resets(&block) ⇒ Object Also known as: after_reset

Calls this block after #reset is called on the instance. Used for resetting external collaborators, like Time.zone.

[View source]

130
131
132
# File 'lib/active_support/current_attributes.rb', line 130

def resets(&block)
  set_callback :reset, :after, &block
end

Instance Method Details

#resetObject

Reset all attributes. Should be called before and after actions, when used as a per-request singleton.

[View source]

194
195
196
197
198
# File 'lib/active_support/current_attributes.rb', line 194

def reset
  run_callbacks :reset do
    self.attributes = {}
  end
end

#set(set_attributes) ⇒ Object

Expose one or more attributes within a block. Old values are returned after the block concludes. Example demonstrating the common use of needing to set Current attributes outside the request-cycle:

class Chat::PublicationJob < ApplicationJob
  def perform(attributes, room_number, creator)
    Current.set(person: creator) do
      Chat::Publisher.publish(attributes: attributes, room_number: room_number)
    end
  end
end
[View source]

185
186
187
188
189
190
191
# File 'lib/active_support/current_attributes.rb', line 185

def set(set_attributes)
  old_attributes = compute_attributes(set_attributes.keys)
  assign_attributes(set_attributes)
  yield
ensure
  assign_attributes(old_attributes)
end