monospace; font-size: 12px; line-height: 16px; font-style: normal; background-color: inherit;">acceptance 接受
class?Person < ActiveRecord::Base
??validates?:terms_of_service, acceptance:?true
end
这个helper 默认的错误信息是 "must be accepted".
?
它能收到一个 :accept 属性, 来决定所想要的接受值. 默认是"1", 更改起来也容易.
class?Person < ActiveRecord::Base
??validates?:terms_of_service, acceptance: { accept:?'yes'?}
end
validates_associated 关联校验
class?Library < ActiveRecord::Base
??has_many?:books
??validates_associated?:books
end
这个校验将会对于所有的关联类型都会起作用.
?
warning: 不要对于你的关联对象两端都使用 validates_associated. 他们将会陷入互相调用的无限循环.
?
对于 validates_associated 的默认错误信息是 "is invalid". 注意, 每一个被关联的对象都包含各自的 errors 集合, errors 不会在调用模型时冒出来.
?
confirmation 确认
class?Person < ActiveRecord::Base
??validates?:email, confirmation:?true
end
在你的视图模板中, 你可以这样使用:
<%=?text_field?:person,?:email?%>
<%=?text_field?:person,?:email_confirmation?%>
这个校验只有当 email_confirmation 不为 nil时, 才会被执行. 为了声明必须要确认, 确定要增加一个对于确认特性的 presence 检查(我们将会在后面详细了解 presence).
class?Person < ActiveRecord::Base
??validates?:email, confirmation:?true
??validates?:email_confirmation, presence:?true
end
对于这个 helper 的默认错误信息是 "doesn't match confirmation".
?exclusion 不包括
class?Account < ActiveRecord::Base
??validates?:subdomain, exclusion: {?in: %w(www us ca jp),
????message:?"%{value} is reserved."?}
end
这个 exclusion helper 有一个属性 :in, 接收一些值的集合, 这些值将不会被校验的特性所接收. :in 属性有一个别名叫作 :within, 你可以用来表示相同的作用目的, 如果你乐意这样做的话. 这个例子使用的 :message 属性是用来显示, 你如何能够包括特性的值.
?
默认的错误信息是 "is reserved".
?format 格式
class?Product < ActiveRecord::Base
??validates?:legacy_code, format: { with: /\A[a-zA-Z]+\z/,
????message:?"only allows letters"?}
end
默认的错误信息是 "is invalid".
?inclusion 包含
class?Coffee < ActiveRecord::Base
??validates?:size, inclusion: {?in: %w(small medium large),
????message:?"%{value} is not a valid size"?}
end
这个 inclusion helper 有一个属性 :in, 接收的一些值的集合是被接受的.
:in 属性有一个别名叫作 :within, 你可以用来表示相同的作用目的, 如果你乐意这样做的话. ?前面的例子使用 :message 属性显示你如何能够包含特性的值. ? 对于这个 helper 的默认错误信息是 "is not included in the list". ?length 长度
class?Person < ActiveRecord::Base
??validates?:name, length: { minimum:?2?}
??validates?:bio, length: { maximum:?500?}
??validates?:password, length: {?in:?6..20?}
??validates?:registration_number, length: { is:?6?}
end
这些长度方面可用的限制属性是:
默认的错误信息是依赖于长度校验的类型所决定的. 你能够定制化这些信息, 通过使用 :wrong_length, :too_long, 和 too_short 属性, 以及 %{count} 作为一个占位符用来对应于所设置长度的数字. 你也能够使用 :message 属性来声明错误信息.
class?Person < ActiveRecord::Base
??validates?:bio, length: { maximum:?1000,
????too_long:?"%{count} characters is the maximum allowed"?}
end
这个 helper 默认统计字符数, 但你能够用不同的方式来分割这个值, 通过使用 :tokenizer 属性:
class?Essay < ActiveRecord::Base
??validates?:content, length: {
????minimum:?300,
????maximum:?400,
????tokenizer: lambda { |str| str.scan(/\w+/) },
????too_short:?"must have at least %{count} words",
????too_long:?"must have at most %{count} words"
??}
end
注意, 默认的错误信息是复数的(e.g. "is too short (minimum is %{count} characters)"). 正是这个原因, 当 :minimum 是1时, 你应该提供一个个性化的消息, 或者用 presence: true 来替代. 当 :in 或者 :within 有低于1时, 你应该要么提供个性化的消息, 要么优先效用 presence.
?numericality 数字化
/\A[+-]?\d+\Z/
正则表达式会去校验属性的值. 否则的话, 它会尝试把这个值转换成一个浮点数.
?
warning: 注意, 上面的正则表达式允许后面新的一行字符.
class?Player < ActiveRecord::Base
??validates?:points, numericality:?true
??validates?:games_played, numericality: { only_integer:?true?}
end
除了 :only_integer, 这个 helper 也接受下面的属性, 来限制所接受的值:
:greater_than -- 声明的值必须大于所提供的值, ?这个属性默认的错误信息是"must be greater than %{count}".
:greater_than_or_equal_to -- 声明的值必须大于或等于所提供的值. 这个属性默认的错误信息是 "must be greater than or equal to %{count}”
:equal_to — 声明的值必须等于所提供的值。这个属性默认的错误消息是 “must be less equal to %{count}”.
:less_than — 声明的值必须小于所提供的值。这个属性默认错误信息是 “must be less than %{count}”.
:less_than_or_equal_to — 声明的值必须小于等于所提供的值。这个属性默认错误信息 “must be less than or equal to %{count}”.
:odd — 如果设置成true，声明的值必须是一个奇数。这个属性默认的错误信息是 “must be odd”.
:even — 如果设置成true，声明的值必须是一个偶数。这个属性默认的错误信息是 “must be even”.
默认的错误信息是 "is not a number”.
?
presence 存在
class Person < ActiveRecord::Base
??validates :name, :login, :email, presence: true
end
如果你能确定的是，一个关联性是存在的，你将会需要去测试所关联的对象本身是否是存在的，没有外键被用来映射这关联性。
class LineItem < ActiveRecord::Base
??belongs_to :order
??validates :order, presence: true
end
为了去校验所关联的记录，其存在性是必须的，你必须声明 :inverse_of 属性为了关联性：
class Order < ActiveRecord::Base
??has_many :line_items, inverse_of: :order
end
如果你校验一个被关联对象的存在性，通过一个 has_one 或者 has_many 关联，它会检查这个对象既不是 blank? 又不是 marked_for_destruction?.
既然 false.blank? 是 true，如果你想要校验 boolean 字段的存在性，你应该使用 validates :field_name, inclusion: { in: [true, false] }.
默认的错误信息是 “can’t be blank”.
absence 缺席
class Person < ActiveRecord::Base
??validates :name, :login, :email, absence: true
end
如果你想要确认一个关联性是缺失的，你将会需要去测试该关联性本身是否是缺失的，没有外键被用来映射其关联性。
class LineItem < ActiveRecord::Base
??belongs_to :order
??validates :order, absence: true
end
为了去校验所关联的记录，其缺失性是必学的，你必须为了这个关联性而要声明 :inverse_of 属性：
class Order < ActiveRecord::Base
??has_many :line_items, inverse_of: :order
end
如果你校验所关联对象的缺失性，通过一个 has_one 或者 has_many 来关联，它会检查该对象既不是 present? 也不是 maked_for_destruction?.
既然 false.present? 是 false，如果你想要校验一个boolean 字段的缺失性，你应该使用 validates :field_name, exclusion: { in:[true, false]}.
默认的错误信息是“must be blank”.
uniqueness 唯一性
class Account < ActiveRecord::Base
??validates :email, uniqueness: true
end
这校验发生在模型的数据表里执行一个SQL查询时，在那个属性用相同的值查询一个已经存在的记录。
这里有一个 :scope 属性，你能够用来声明其他属性，用来限制唯一性的校验：class Holiday < ActiveRecord::Base
??validates :name, uniqueness: { scope: :year,
????message: "should happen once per year" }
end
也有一个 :case_sensitive 属性，你能够用来定义，唯一性限制对于大小写是否敏感。这个属性默认是 true。
class Person < ActiveRecord::Base
??validates :name, uniqueness: { case_sensitive: false }
end
warning：注意，一些数据库被设置为大小写不明感。
默认的错误消息是 “has already been taken”。
?
validates_with 校验
class GoodnessValidator < ActiveModel::Validator
??def validate(record)
????if record.first_name == "Evil"
??????record.errors[:base] << "This person is evil"
????end
??end
end
?
class Person < ActiveRecord::Base
??validates_with GoodnessValidator
end
?
warning: ?增加到 record.errors[:base] 的错误信息与记录的状态相关联, 这被视为一个整体, 而不是一个特殊的特性.
?
validate_with helper 传入一个类, 或则一组类用来执行校验. validates_with 没有默认的错误信息. 在校验的类中, 你必须手工地增加错误信息到记录的错误信息集合中.
?
为了实现校验方法, 你必须拥有一个已经被定义的数据记录行参数, 这个数据记录行会被用来校验.
?
就如同其他的校验, validates_with 有 :if, :unless 和 :on 属性. 如果你带入其他属性, 它会把那些属性发送到校验类中, 作为属性:
class?GoodnessValidator < ActiveModel::Validator
??def?validate(record)
????if?options[:fields].any?{|field| record.send(field) ==?"Evil"?}
??????record.errors[:base] <<?"This person is evil"
????end
??end
end
?
class?Person < ActiveRecord::Base
??validates_with GoodnessValidator, fields: [:first_name,?:last_name]
end
注意, 校验对象在整个应用生命周期中只会被初始化一次, 而不是在每一次的校验执行时, 因此在其内部要仔细地使用实例变量.
?
如果你的校验是足够的复杂, 你想要一些实例变量, 你可以简单地使用一个简洁的老旧的Ruby对象来替代:
class?Person < ActiveRecord::Base
??validate?do?|person|
????GoodnessValidator.new(person).validate
??end
end
?
class?GoodnessValidator
??def?initialize(person)
????@person?= person
??end
?
??def?validate
????if?some_complex_condition_involving_ivars_and_private_methods?
??????@person.errors[:base] <<?"This person is evil"
????end
??end
?
??# ...
end
validates_each 校验
class?Person < ActiveRecord::Base
??validates_each?:name,?:surname?do?|record, attr, value|
????record.errors.add(attr,?'must start with upper case')?if?value =~ /\A[a-z]/
??end
end
这个代码块接收到数据记录行, 属性的名称和属性值. 在代码块中你可以做任何你想做的校验. 如果你的校验失败了, 你应该增加一个错误消息到模型中, 因此使它无效.
? original url:?http://guides.rubyonrails.org/active_record_validations.html#validation-helpers?
相关文章
