1
0
Fork 0
mirror of https://github.com/rails/rails.git synced 2022-11-09 12:12:34 -05:00

bringing consistency in comments

This commit is contained in:
Neeraj Singh 2010-07-24 00:45:53 -04:00
parent 8429e7b45b
commit 082ca51d65

View file

@ -50,7 +50,7 @@ module ActiveRecord
# Returns an array of AssociationReflection objects for all the # Returns an array of AssociationReflection objects for all the
# associations in the class. If you only want to reflect on a certain # associations in the class. If you only want to reflect on a certain
# association type, pass in the symbol (<tt>:has_many</tt>, <tt>:has_one</tt>, # association type, pass in the symbol (<tt>:has_many</tt>, <tt>:has_one</tt>,
# <tt>:belongs_to</tt>) for that as the first parameter. # <tt>:belongs_to</tt>) as the first parameter.
# #
# Example: # Example:
# #
@ -62,9 +62,9 @@ module ActiveRecord
macro ? association_reflections.select { |reflection| reflection.macro == macro } : association_reflections macro ? association_reflections.select { |reflection| reflection.macro == macro } : association_reflections
end end
# Returns the AssociationReflection object for the named +association+ (use the symbol). Example: # Returns the AssociationReflection object for the +association+ (use the symbol).
# #
# Account.reflect_on_association(:owner) # returns the owner AssociationReflection # Account.reflect_on_association(:owner) # returns the owner AssociationReflection
# Invoice.reflect_on_association(:line_items).macro # returns :has_many # Invoice.reflect_on_association(:line_items).macro # returns :has_many
# #
def reflect_on_association(association) def reflect_on_association(association)
@ -88,34 +88,37 @@ module ActiveRecord
@macro, @name, @options, @active_record = macro, name, options, active_record @macro, @name, @options, @active_record = macro, name, options, active_record
end end
# Returns the name of the macro. For example, <tt>composed_of :balance, # Returns the name of the macro.
# :class_name => 'Money'</tt> will return <tt>:balance</tt> or for # <tt>composed_of :balance, :class_name => 'Money'</tt> will return <tt>:balance</tt>
# <tt>has_many :clients</tt> it will return <tt>:clients</tt>. # <tt>has_many :clients</tt> will return <tt>:clients</tt>
def name def name
@name @name
end end
# Returns the macro type. For example, # Returns the macro type.
# <tt>composed_of :balance, :class_name => 'Money'</tt> will return <tt>:composed_of</tt> # <tt>composed_of :balance, :class_name => 'Money'</tt> will return <tt>:composed_of</tt>
# or for <tt>has_many :clients</tt> will return <tt>:has_many</tt>. # <tt>has_many :clients</tt> will return <tt>:has_many</tt>
def macro def macro
@macro @macro
end end
# Returns the hash of options used for the macro. For example, it would return <tt>{ :class_name => "Money" }</tt> for # Returns the hash of options used for the macro.
# <tt>composed_of :balance, :class_name => 'Money'</tt> or +{}+ for <tt>has_many :clients</tt>. # <tt>composed_of :balance, :class_name => 'Money'</tt> will return <tt>{ :class_name => "Money" }</tt>
# <tt>has_many :clients</tt> will return +{}+
def options def options
@options @options
end end
# Returns the class for the macro. For example, <tt>composed_of :balance, :class_name => 'Money'</tt> returns the Money # Returns the class for the macro.
# class and <tt>has_many :clients</tt> returns the Client class. # <tt>composed_of :balance, :class_name => 'Money'</tt> will return the Money class
# <tt>has_many :clients</tt> will return the Client class
def klass def klass
@klass ||= class_name.constantize @klass ||= class_name.constantize
end end
# Returns the class name for the macro. For example, <tt>composed_of :balance, :class_name => 'Money'</tt> returns <tt>'Money'</tt> # Returns the class name for the macro.
# and <tt>has_many :clients</tt> returns <tt>'Client'</tt>. # <tt>composed_of :balance, :class_name => 'Money'</tt> will return <tt>'Money'</tt>
# <tt>has_many :clients</tt> will return <tt>'Client'</tt>
def class_name def class_name
@class_name ||= options[:class_name] || derive_class_name @class_name ||= options[:class_name] || derive_class_name
end end