instance method
becomes
Ruby on Rails edge
Since v3.0.20Signature
becomes(klass)Returns an instance of the specified klass with the attributes of the
current record. This is mostly useful in relation to single table
inheritance (STI) structures where you want a subclass to appear as the
superclass. This can be used along with record identification in
Action Pack to allow, say, `Client < Company` to do something
like render `partial: @client.becomes(Company)` to render that
instance using the companies/company partial instead of clients/client.
Note: The new instance will share a link to the same attributes as the original class.
Therefore the STI column value will still be the same.
Any change to the attributes on either instance will affect both instances.
This includes any attribute initialization done by the new instance.
If you want to change the STI column as well, use #becomes! instead.: [Klass] (Class) -> Klass
Parameters
-
klassreq
Source
# File activerecord/lib/active_record/persistence.rb, line 474
def becomes(klass)
return clone if self.class == klass
became = klass.allocate
became.send(:initialize) do |becoming|
@attributes.reverse_merge!(becoming.instance_variable_get(:@attributes))
becoming.instance_variable_set(:@attributes, @attributes)
becoming.instance_variable_set(:@mutations_from_database, @mutations_from_database ||= nil)
becoming.instance_variable_set(:@new_record, new_record?)
becoming.instance_variable_set(:@previously_new_record, previously_new_record?)
becoming.instance_variable_set(:@destroyed, destroyed?)
becoming.instance_variable_set(:@marked_for_destruction, marked_for_destruction?)
becoming.errors.copy!(errors)
end
became
end
Defined in activerecord/lib/active_record/persistence.rb line 474
· View on GitHub
· Improve this page
· Find usages on GitHub
Defined in ActiveRecord::Persistence