跳到內容 跳到搜尋

目前屬性

提供執行緒隔離屬性單例的抽象超級類別，會在每個要求前後自動重設。這讓您可以輕鬆地讓所有每個要求的屬性在整個系統中使用。

以下完整的應用程式範例說明如何使用 Current 類別，以輕鬆存取每個要求的全球屬性，而不用在各處深度傳遞這些屬性

# 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.account = user.account
    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.account.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

謹慎提醒：很容易過度使用 Current 等全球單例，並因此讓您的模型糾纏在一起。Current 僅應使用於少數頂層全球屬性，例如帳戶、使用者和要求詳細資料。Current 中的屬性應或多或少用於所有要求的所有動作。如果您開始在其中加入控制器特定的屬性，您將會製造一團亂。

方法
A
B
I
N
R
S
包含的模組

屬性

[RW] attributes

類別公開方法

after_reset(*methods, &block)

別名：resets

attribute(*names)

宣告一個或多個屬性，這些屬性將同時提供類別和執行個體存取方法。

來源：顯示 | 在 GitHub 上 

# File activesupport/lib/active_support/current_attributes.rb, line 104
def attribute(*names)
  invalid_attribute_names = names.map(&:to_sym) & INVALID_ATTRIBUTE_NAMES
  if invalid_attribute_names.any?
    raise ArgumentError, "Restricted attribute names: #{invalid_attribute_names.join(", ")}"
  end

  ActiveSupport::CodeGenerator.batch(generated_attribute_methods, __FILE__, __LINE__) do |owner|
    names.each do |name|
      owner.define_cached_method(name, namespace: :current_attributes) do |batch|
        batch <<
          "def #{name}" <<
          "attributes[:#{name}]" <<
          "end"
      end
      owner.define_cached_method("#{name}=", namespace: :current_attributes) do |batch|
        batch <<
          "def #{name}=(value)" <<
          "attributes[:#{name}] = value" <<
          "end"
      end
    end
  end

  ActiveSupport::CodeGenerator.batch(singleton_class, __FILE__, __LINE__) do |owner|
    names.each do |name|
      owner.define_cached_method(name, namespace: :current_attributes_delegation) do |batch|
        batch <<
          "def #{name}" <<
          "instance.#{name}" <<
          "end"
      end
      owner.define_cached_method("#{name}=", namespace: :current_attributes_delegation) do |batch|
        batch <<
          "def #{name}=(value)" <<
          "instance.#{name} = value" <<
          "end"
      end
    end
  end
end

before_reset(*methods, &block)

在執行個體上呼叫 reset 之前呼叫此回呼。用於重設依賴於目前值的外部協作者。

來源：顯示 | 在 GitHub 上 

# File activesupport/lib/active_support/current_attributes.rb, line 146
def before_reset(*methods, &block)
  set_callback :reset, :before, *methods, &block
end

instance()

傳回此執行緒中此類別的單例實例。如果沒有，則建立一個。

來源：顯示 | 在 GitHub 上 

# File activesupport/lib/active_support/current_attributes.rb, line 99
def instance
  current_instances[current_instances_key] ||= new
end

new()

來源：顯示 | 在 GitHub 上 

# File activesupport/lib/active_support/current_attributes.rb, line 197
def initialize
  @attributes = {}
end

resets(*methods, &block)

在實例上呼叫 reset 之後呼叫此回呼。用於重設外部協作者，例如 Time.zone。

別名為：after_reset

來源：顯示 | 在 GitHub 上 

# File activesupport/lib/active_support/current_attributes.rb, line 151
def resets(*methods, &block)
  set_callback :reset, :after, *methods, &block
end

實例公開方法

reset()

重設所有屬性。當用作每個要求的單例時，應在動作前後呼叫。

來源：顯示 | 在 GitHub 上 

# File activesupport/lib/active_support/current_attributes.rb, line 220
def reset
  run_callbacks :reset do
    self.attributes = {}
  end
end

set(set_attributes)

在區塊中公開一個或多個屬性。舊值在區塊結束後傳回。範例說明需要在要求週期之外設定目前屬性的常見用法

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

來源：顯示 | 在 GitHub 上 

# File activesupport/lib/active_support/current_attributes.rb, line 211
def set(set_attributes)
  old_attributes = compute_attributes(set_attributes.keys)
  assign_attributes(set_attributes)
  yield
ensure
  assign_attributes(old_attributes)
end