Permalink
Browse files

Documents that ActiveRecord instances also support []/[]= methods for…

… reading/writing attributes

Only write_attribute and read_attribute were documented and there was no mention to this alternative.
  • Loading branch information...
1 parent 871cc8c commit a49fe6ec2cb9f22a3b18d7db5ae2ee90325e9d09 @rosenfeld rosenfeld committed Apr 6, 2012
Showing with 11 additions and 5 deletions.
  1. +11 −5 activerecord/lib/active_record/base.rb
@@ -114,23 +114,29 @@ module ActiveRecord #:nodoc:
# Student.joins(:schools).where(:schools => { :category => 'public' })
# Student.joins(:schools).where('schools.category' => 'public' )
#
+ # == Dynamic assignment
+ #
+ # Sometimes it can be useful to assign some attributes dynamically. You can use
+ # <tt>read_attribute(attr_name, value)</tt>/<tt>write_attribute(attr_name)</tt>
+ # or through model[attr_name]/model[attr_name]=:
+ #
+ # [:deleted, :disabled].each{|p| model[p] = params[p] == 'true' }
+ #
# == Overwriting default accessors
#
# All column values are automatically available through basic accessors on the Active Record
# object, but sometimes you want to specialize this behavior. This can be done by overwriting
- # the default accessors (using the same name as the attribute) and calling
- # <tt>read_attribute(attr_name)</tt> and <tt>write_attribute(attr_name, value)</tt> to actually
- # change things.
+ # the default accessors (using the same name as the attribute):
#
# class Song < ActiveRecord::Base
# # Uses an integer of seconds to hold the length of the song
#
# def length=(minutes)
- # write_attribute(:length, minutes.to_i * 60)
+ # write_attribute(:length, minutes.to_i * 60) # or: self[:length] = minutes.to_i * 60
# end
#
# def length
- # read_attribute(:length) / 60
+ # read_attribute(:length) / 60 # or: self[:length] / 60
# end
# end
#

0 comments on commit a49fe6e

Please sign in to comment.