跳至內容 跳至搜尋

Active Model 屬性方法

提供一種方式,將字首和字尾新增至您的方法,以及處理 ActiveRecord::Base 的建立,例如 table_name 等類別方法。

實作 ActiveModel::AttributeMethods 的需求為

  • 在您的類別中 include ActiveModel::AttributeMethods

  • 呼叫您想要新增的每個方法,例如 attribute_method_suffixattribute_method_prefix

  • 在呼叫其他方法後,呼叫 define_attribute_methods

  • 定義您已宣告的各種通用 _attribute 方法。

  • 定義一個 attributes 方法,其傳回一個雜湊,其中每個屬性名稱在您的模型中為雜湊鍵,而屬性值為雜湊值。 Hash 鍵必須為字串。

最小實作可以是

class Person
  include ActiveModel::AttributeMethods

  attribute_method_affix  prefix: 'reset_', suffix: '_to_default!'
  attribute_method_suffix '_contrived?'
  attribute_method_prefix 'clear_'
  define_attribute_methods :name

  attr_accessor :name

  def attributes
    { 'name' => @name }
  end

  private
    def attribute_contrived?(attr)
      true
    end

    def clear_attribute(attr)
      send("#{attr}=", nil)
    end

    def reset_attribute_to_default!(attr)
      send("#{attr}=", 'Default Name')
    end
end
命名空間
方法
A
M
R

常數

CALL_COMPILABLE_REGEXP = /\A[a-zA-Z_]\w*[!?]?\z/
 
FORWARD_PARAMETERS = "*args"
 
NAME_COMPILABLE_REGEXP = /\A[a-zA-Z_]\w*[!?=]?\z/
 

執行個體公開方法

attribute_missing(match, *args, &block)

attribute_missing 類似於 method_missing,但用於屬性。當呼叫 method_missing 時,我們會檢查是否有相符的屬性方法。如果有,我們會指示 attribute_missing 派送屬性。此方法可以被覆寫以自訂行為。

# File activemodel/lib/active_model/attribute_methods.rb, line 498
def attribute_missing(match, *args, &block)
  __send__(match.proxy_target, match.attr_name, *args, &block)
end

method_missing(method, *args, &block)

允許存取物件屬性,這些屬性保存在 attributes 傳回的雜湊中,就像它們是一流的方法。因此,具有 name 屬性的 Person 類別可以例如使用 Person#namePerson#name=,且從不直接使用屬性雜湊,除了使用 ActiveRecord::Base#attributes= 進行多重指定。

也可以實例化相關物件,因此屬於 clients 資料表的 Client 類別,具有 master_id 外來鍵,可以透過 Client#master 實例化 master。

# File activemodel/lib/active_model/attribute_methods.rb, line 484
def method_missing(method, *args, &block)
  if respond_to_without_attributes?(method, true)
    super
  else
    match = matched_attribute_method(method.to_s)
    match ? attribute_missing(match, *args, &block) : super
  end
end

respond_to?(method, include_private_methods = false)

# File activemodel/lib/active_model/attribute_methods.rb, line 507
def respond_to?(method, include_private_methods = false)
  if super
    true
  elsif !include_private_methods && super(method, true)
    # If we're here then we haven't found among non-private methods
    # but found among all methods. Which means that the given method is private.
    false
  else
    !matched_attribute_method(method.to_s).nil?
  end
end

respond_to_without_attributes?(method, include_private_methods = false)

具有 name 屬性的 Person 實例可以詢問 person.respond_to?(:name)person.respond_to?(:name=)person.respond_to?(:name?),所有這些都將傳回 true

別名為:respond_to?