github/rails
1
1
Fork 0
mirror of https://github.com/github/rails.git synced 2026-01-30 08:48:06 -05:00
Code Issues Packages Projects Releases Wiki Activity

Quickref for association methods. Closes #7723.

Browse Source 
git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@6905 5ecf4fe2-1ee6-0310-87b1-e25e094e27de
This commit is contained in:
Jeremy Kemper
2007-05-30 07:05:14 +00:00
parent 1f802968c5
commit ff6d2aae0a
2 changed files with 41 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
activerecord/CHANGELOG
View File

@@ -1,5 +1,7 @@
*SVN*
* Quickref for association methods. #7723 [marclove, Mindsweeper]
* Calculations: return nil average instead of 0 when there are no rows to average. #8298 [davidw]
* acts_as_nested_set: direct_children is sorted correctly. #4761 [Josh Peek, rails@33lc0.net]

41
activerecord/lib/active_record/associations.rb
View File

@@ -101,9 +101,46 @@ module ActiveRecord
# adds a method with that name to its model, it will override the inherited method and break things.
# For instance, #attributes and #connection would be bad choices for association names.
#
# == Example
# == Auto-generated methods
#
# link:files/examples/associations.png
# ===Singular associations (one-to-one)
# | | belongs_to |
# generated methods | belongs_to | :polymorphic | has_one
# ----------------------------------+------------+--------------+---------
# #other | X | X | X
# #other=(other) | X | X | X
# #build_other(attributes={}) | X | | X
# #create_other(attributes={}) | X | | X
# #other.create!(attributes={}) | | | X
# #other.nil? | X | X |
#
# ===Collection associations (one-to-many / many-to-many)
# | | | has_many
# generated methods | habtm | has_many | :through
# ----------------------------------+-------+----------+----------
# #others | X | X | X
# #others=(other,other,...) | X | X |
# #other_ids | X | X |
# #other_ids=(id,id,...) | X | X |
# #others<< | X | X | X
# #others.push | X | X | X
# #others.concat | X | X | X
# #others.build(attributes={}) | X | X | X
# #others.create(attributes={}) | X | X |
# #others.create!(attributes={}) | X | X | X
# #others.size | X | X |
# #others.length | X | X |
# #others.count | | X |
# #others.sum(args*,&block) | X | X | X
# #others.empty? | X | X |
# #others.clear | X | X |
# #others.delete(other,other,...) | X | X | X
# #others.delete_all | X | X |
# #others.destroy_all | X | X |
# #others.find(*args) | X | X | X
# #others.find_first | X | |
# #others.uniq | X | X |
# #others.reset | X | X | X
#
# == Cardinality and associations
#