数据验证

验证表单提供的数据是否符合要求
使用rails自带的内置辅助功能ActiveRecord Validation 来实现
https://ruby-china.github.io/rails-guides/active_record_validations.html

何时验证

ActiveRecord Validation 会在执行sql(即save/create/update)之前进行数据验证,如果数据不符合要求，不会去执行sql的写入操作，如 insert/update

注意事项：
不是所有的写入操作都会触发ActiveRecord Validation

# 以下方法会触发数据验证
save
create
update

# 以下方法不会触发数据验证
decrement
decrement_counter
increment
increment_counter
toggle
touch
update_all         
update_attribute
update_column
update_columns
update_counters

save(validate: false)  #如果save时指定validate: false, 也不会触发数据验证

项目中使用

继续我们的用户注册登录功能,在User中添加

class User < ApplicationRecord

  has_secure_password
  before_create {generate_token(:auth_token)}
  validates :name, :email, presence: true                        #presence 存在性
  validates :name, :email, uniqueness: { case_sensitive: false } # uniqueness 唯一 case_sensitive 区分大小写

  def generate_token column
    begin
      self[column] = SecureRandom.urlsafe_base64
    end while User.exists?(column => self[column])
  end
end

用户如果保存失败，可以使用errors来查看错误信息

u = User.create(name: 'whj')
# 因email为空，会产生rollback
# 使用 u.errors 会返回一个ActiveRecord::Errors 对象，其中message属性会提示错误原因

#  #<ActiveModel::Errors:0x007f938c898f10 @base=#<User id: nil, name: "whj", email: nil, nickname: nil, introduction: nil, password_digest: nil, created_at: nil, updated_at: nil, auth_token: nil>, @messages={:password=>["can't be blank"], :email=>["can't be blank"]}, @details={:password=>[{:error=>:blank}], :email=>[{:error=>:blank}]}> 
# 还记得吗， has_secure_password 也会对密码的存在性记性校验

使用errors在前端页面中显示用户注册失败原因

# controllers/users_controller.rb
def create
    @user = User.new(user_params)              #为了erb中能使用，user改为@user
    if @user.save                              #成功保存，不变
      cookies[:auth_token] = @user.auth_token
      redirect_to :root
    else
      render :signup                           #保存失败，重新渲染signup页面，已填写数据不会丢失
    end
 end
 
 # views/users/signup.html.erb
 
        <dl class="form">
        <dt><%= f.label :email %></dt>
        <dd><%= f.text_field :email %></dd>
            <% if @user.errors[:email].any? %>
              <dd class="error"><%= @user.errors[:email][0] %></dd>
            <% end %>
        </dl>
# 这样用户在提交失败后重新渲染signup页面就有错误提示了

项目中使用简单的ActiveRecord Validation 就是这样了，下面继续ActiveRecord Validation 的辅助方法

presence

项目中用到的存在性校验
除了属性的值是否存在，还可以验证关联对象是否存在

class LineItem < ApplicationRecord
  belongs_to :order
  validates :order, presence: true
end

class Order < ApplicationRecord
  has_many :line_items, inverse_of: :order   # 需要添加 inverse_of: :order 
end

uniqueness

唯一性校验
该方法不会在数据库中创建唯一索引
:scope 选项用于指定检查唯一性时使用的一个或多个属性
:case_sensitive 选项用于指定是否区分大小写，默认为true

acceptance

验证表单中的复选框是否被选中

confirmation

验证某个属性两次输入(如：再次确认)是否相同
confirmation 会创建一个名为 _confirmation 的虚拟属性，如：phone, phone_confirmation
缺陷： 只有在 _confirmation 属性不为nil时才会触发校验， 所以需要和persence一起使用

validates :phone, confirmation: true
validates :phone_confirmation, presence: true

exclusion

检查属性的值是否不在某个集合中
需要指定in选项或者with选项

validates :subdomain, exclusion: { in: %w(www us ca jp),  message: "%{value} is reserved." }

inclusion

检查属性的值是否在某个集合中
需要指定in选项或者within选项

validates :size, inclusion: { in: %w(small medium large),
    message: "%{value} is not a valid size" }

format

检查属性的值是否匹配 with指定的正则
如果使用了 without,则不能符合后面的正则

validates :legacy_code, format: { with: /\A[a-zA-Z]+\z/,
    message: "only allows letters" }

length

验证属性值的长度，有多个选项
1 :minimum：属性的值不能比指定的长度短；
2 :maximum：属性的值不能比指定的长度长；
3 :in（或 :within）：属性值的长度在指定的范围内。该选项的值必须是一个范围；\

4 :is：属性值的长度必须等于指定值；

  validates :name, length: { minimum: 2 }
  validates :bio, length: { maximum: 500 }
  validates :password, length: { in: 6..20 }
  validates :registration_number, length: { is: 6 }

numericality

检测是否只包含数字
匹配的值是可选的正负符号后加整数或浮点数
numericality 默认不接受 nil 值。可以使用 allow_nil: true 选项允许接受 nil。

    only_integer  只接受整数
    greater_than  大于
    greater_than_or_equal_to  大于等于
    equal_to 等于
    less_than 小于
    less_than_or_equal_to 小于等于
    other_than 不等于
    odd  奇数
    even 偶数

validates_with

记录交给其他类做验证
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 < ApplicationRecord
  validates_with GoodnessValidator
end

常用的选项

allow_nil

allow_blank

message

:on

指定什么时候才验证

  validates :email, uniqueness: true, on: :create

strict

严格验证\

通过 :strict 选项指定抛出什么异常：

  validates :name, presence: { strict: true }