Changeset 8259

Timestamp:

12/03/07 02:01:21 (6 months ago)

Author:

david

Message:

Added ActiveRecord::Base#becomes to turn a record into one of another class (mostly relevant for STIs) [DHH]

Files:

• trunk/activerecord/CHANGELOG (modified) (1 diff)
• trunk/activerecord/lib/active_record/base.rb (modified) (1 diff)
• trunk/activerecord/test/base_test.rb (modified) (1 diff)

trunk/activerecord/CHANGELOG

@@ -1 +1 @@
-*SVN*
+
+* Added ActiveRecord::Base#becomes to turn a record into one of another class (mostly relevant for STIs) [DHH]. Example:
+
+    render :partial => @client.becomes(Company) # renders companies/company instead of clients/client
-
-* Fixed that to_xml should not automatically pass :procs to associations included with :include #10162 [chuyeow]

trunk/activerecord/lib/active_record/base.rb

@@ -1807 +1807 @@
-      end
-
+      # Returns an instance of the specified klass with the attributes of the current record. This is mostly useful in relation to
+      # single-table inheritance 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. So any change to the attributes in either
+      # instance will affect the other.
+      def becomes(klass)
+        returning klass.new do |became|
+          became.instance_variable_set("@attributes", @attributes)
+          became.instance_variable_set("@new_record", new_record?)
+        end
+      end
+
-      # Updates a single attribute and saves the record. This is especially useful for boolean flags on existing records.
-      # Note: This method is overwritten by the Validation module that'll make sure that updates made with this method

trunk/activerecord/test/base_test.rb

@@ -1738 +1738 @@
-    assert_equal '"This is some really long content, longer than 50 ch..."', t.attribute_for_inspect(:content)
-  end
+  
+  def test_becomes
+    assert_kind_of Reply, topics(:first).becomes(Reply)
+    assert_equal "The First Topic", topics(:first).becomes(Reply).title
+  end
-end