mirror of
https://github.com/rails/rails.git
synced 2022-11-09 12:12:34 -05:00
document ActiveRecord's except and only
Document methods that allow easily override arel queries
This commit is contained in:
parent
da82b0a746
commit
b31ef7ee83
1 changed files with 14 additions and 0 deletions
|
@ -61,6 +61,13 @@ module ActiveRecord
|
|||
|
||||
alias :& :merge
|
||||
|
||||
# Removes from the query the condition(s) specified in +skips+.
|
||||
#
|
||||
# Example:
|
||||
#
|
||||
# Post.order('id asc').except(:order) # discards the order condition
|
||||
# Post.where('id > 10').order('id asc').except(:where) # discards the where condition but keeps the order
|
||||
#
|
||||
def except(*skips)
|
||||
result = self.class.new(@klass, table)
|
||||
|
||||
|
@ -75,6 +82,13 @@ module ActiveRecord
|
|||
result
|
||||
end
|
||||
|
||||
# Removes any condition from the query other than the one(s) specified in +onlies+.
|
||||
#
|
||||
# Example:
|
||||
#
|
||||
# Post.order('id asc').only(:where) # discards the order condition
|
||||
# Post.order('id asc').only(:where, :order) # uses the specified order
|
||||
#
|
||||
def only(*onlies)
|
||||
result = self.class.new(@klass, table)
|
||||
|
||||
|
|
Loading…
Reference in a new issue