mirror of
https://github.com/github/rails.git
synced 2026-04-26 03:00:59 -04:00
document Active Record's reverse_order method
This commit is contained in:
@@ -57,6 +57,7 @@ The methods are:
|
||||
* +group+
|
||||
* +order+
|
||||
* +reorder+
|
||||
* +reverse_order+
|
||||
* +limit+
|
||||
* +offset+
|
||||
* +joins+
|
||||
@@ -550,6 +551,32 @@ In case the +reorder+ clause is not used, the SQL executed would be:
|
||||
SELECT * FROM posts WHERE id = 10 ORDER BY posted_at DESC
|
||||
</sql>
|
||||
|
||||
h4. +reverse_order+
|
||||
|
||||
The +reverse_order+ method reverses the ordering clause if specified.
|
||||
|
||||
<ruby>
|
||||
Client.where("orders_count > 10").order(:name).reverse_order
|
||||
</ruby>
|
||||
|
||||
The SQL that would be executed:
|
||||
<sql>
|
||||
SELECT * FROM clients WHERE orders_count > 10 ORDER BY name DESC
|
||||
</sql>
|
||||
|
||||
If no ordering clause is specified in the query, the +reverse_order+ orders by the primary key in reverse order.
|
||||
|
||||
<ruby>
|
||||
Client.where("orders_count > 10").reverse_order
|
||||
</ruby>
|
||||
|
||||
The SQL that would be executed:
|
||||
<sql>
|
||||
SELECT * FROM clients WHERE orders_count > 10 ORDER BY clients.id DESC
|
||||
</sql>
|
||||
|
||||
This method accepts *no* arguments.
|
||||
|
||||
h3. Readonly Objects
|
||||
|
||||
Active Record provides +readonly+ method on a relation to explicitly disallow modification or deletion of any of the returned object. Any attempt to alter or destroy a readonly record will not succeed, raising an +ActiveRecord::ReadOnlyRecord+ exception.
|
||||
|
||||
Reference in New Issue
Block a user