From 31dcce8c1c41da49bfc0d60bd6ea77e4cd7e7d17 Mon Sep 17 00:00:00 2001 From: CassioMarques Date: Mon, 10 Nov 2008 21:02:40 -0200 Subject: Added documentation for validates_uniqueness_of --- .../html/activerecord_validations_callbacks.html | 36 ++++++++++++++++++++-- 1 file changed, 34 insertions(+), 2 deletions(-) (limited to 'railties/doc/guides/html/activerecord_validations_callbacks.html') diff --git a/railties/doc/guides/html/activerecord_validations_callbacks.html b/railties/doc/guides/html/activerecord_validations_callbacks.html index 7149ee5f90..a85a4db5d8 100644 --- a/railties/doc/guides/html/activerecord_validations_callbacks.html +++ b/railties/doc/guides/html/activerecord_validations_callbacks.html @@ -235,7 +235,7 @@ ul#navMain {
  • The validates_presence_of helper
    • -
  • The validates_uniqueness_of+ helper
    • +
  • The validates_uniqueness_of helper
    • @@ -575,7 +575,39 @@ http://www.gnu.org/software/src-highlite -->

    The default error message for validates_presence_of is "can't be empty".

    -

    3.11. The validates_uniqueness_of+ helper

    +

    3.11. The validates_uniqueness_of helper

    +

    This helper validates that the attribute's value is unique right before the object gets saved. It does not create a uniqueness constraint directly into your database, so it may happen that two different database connections create two records with the same value for a column that you wish were unique. To avoid that, you must create an unique index in your database.

    +
    +
    +
    class Account < ActiveRecord::Base
+  validates_uniqueness_of :email
+end
+
    +

    The validation happens by performing a SQL query into the model's table, searching for a record where the attribute that must be validated is equal to the value in the object being validated.

    +

    There is a :scope option that you can use to specify other attributes that must be used to define uniqueness:

    +
    +
    +
    class Holiday < ActiveRecord::Base
+  validates_uniqueness_of :name, :scope => :year, :message => "Should happen once per year"
+end
+
    +

    There is also a :case_sensitive option that you can use to define if the uniqueness contraint will be case sensitive or not. This option defaults to true.

    +
    +
    +
    class Person < ActiveRecord::Base
+  validates_uniqueness_of :name, :case_sensitive => false
+end
+
    +

    The default error message for validates_uniqueness_of is "has already been taken".

    4. Common validation options

    -- cgit v1.2.3