Active Model Attribute Methods
ActiveModel::AttributeMethods provides a way to add prefixes and suffixes to your methods as well as handling the creation of Active Record like class methods such as table_name.
The requirements to implement ActiveModel::AttributeMethods are to:
- include ActiveModel::AttributeMethods in your object
- Call each Attribute Method module method you want to add, such as attribute_method_suffix or attribute_method_prefix
- Call define_attribute_methods after the other methods are called.
- Define the various generic _attribute methods that you have declared
A minimal implementation could be:
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 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
Note that whenever you include ActiveModel::AttributeMethods in your class, it requires you to implement an attributes method which returns a hash with each attribute name in your model as hash key and the attribute value as hash value.
Hash keys must be strings.
- A
- M
- R
NAME_COMPILABLE_REGEXP | = | /\A[a-zA-Z_]\w*[!?=]?\z/ |
CALL_COMPILABLE_REGEXP | = | /\A[a-zA-Z_]\w*[!?]?\z/ |
attribute_missing is like method_missing, but for attributes. When method_missing is called we check to see if there is a matching attribute method. If so, we call attribute_missing to dispatch the attribute. This method can be overloaded to customise the behaviour.
Allows access to the object attributes, which are held in the @attributes hash, as though they were first-class methods. So a Person class with a name attribute can use Person#name and Person#name= and never directly use the attributes hash — except for multiple assigns with ActiveRecord#attributes=. A Milestone class can also ask Milestone#completed? to test that the completed attribute is not nil or 0.
It’s also possible to instantiate related objects, so a Client class belonging to the clients table with a master_id foreign key can instantiate master through Client#master.
# File activemodel/lib/active_model/attribute_methods.rb, line 405 405: def method_missing(method, *args, &block) 406: if respond_to_without_attributes?(method, true) 407: super 408: else 409: match = match_attribute_method?(method.to_s) 410: match ? attribute_missing(match, *args, &block) : super 411: end 412: end
# File activemodel/lib/active_model/attribute_methods.rb, line 426 426: def respond_to?(method, include_private_methods = false) 427: if super 428: true 429: elsif !include_private_methods && super(method, true) 430: # If we're here then we haven't found among non-private methods 431: # but found among all methods. Which means that the given method is private. 432: false 433: else 434: !match_attribute_method?(method.to_s).nil? 435: end 436: end
Alias for respond_to?