Rails 模型验证：包含代码示例的综合指南

happyEnding
189 阅读5分钟

开启掘金成长之旅！这是我参与「掘金日新计划 · 2 月更文挑战」的第 17 天，点击查看活动详情

Ruby on Rails 提供了多种内置的验证方法，有助于确保存储在数据库中的数据是一致的并满足特定条件。这些验证可以直接在您的模型文件中指定，使它们易于管理和维护。

以下是 Rails 中可用的一些最常见的验证方法：

存在验证

最简单的验证类型是存在验证，它确保特定字段不为空。例如，如果你想确保 User 模型的 name 字段始终存在，你可以编写以下代码：

class User < ApplicationRecord
  validates :name, presence: true
end

长度验证

另一种常见的验证类型是长度验证，它限制字符串字段的长度。例如，如果要确保 User 模型的密码字段长度至少为 8 个字符，则可以编写以下代码：

class User < ApplicationRecord
  validates :password, length: { minimum: 8 }
end

您还可以指定字段的最大长度，或最小和最大长度：

class User < ApplicationRecord
  validates :password, length: { minimum: 8, maximum: 20 }
end

格式验证

格式验证用于确保字段匹配特定模式，例如特定电子邮件格式或邮政编码格式。例如，如果要确保用户模型的电子邮件字段格式正确，您可以编写以下代码：

class User < ApplicationRecord
  validates :email, format: { with: /\A([^@\s]+)@((?:[-a-z0-9]+.)+[a-z]{2,})\z/i, on: :create }
end

唯一性验证

唯一性验证确保特定字段在数据库中的所有记录中都是唯一的。例如，如果要确保 User 模型的 email 字段是唯一的，您可以编写以下代码：

class User < ApplicationRecord
  validates :email, uniqueness: true
end

数值验证

数字验证确保特定字段是数字。您还可以指定额外的约束条件，例如确保数字大于或等于某个值，或者它是一个整数。例如，如果要确保 User 模型的 age 字段是大于等于 18 的数字，则可以编写以下代码：

class User < ApplicationRecord
  validates :age, numericality: { greater_than_or_equal_to: 18 }
end

确认验证

确认验证确保一个字段被第二个字段确认。例如，如果你想确保用户通过输入两次密码来确认他们的密码，你可以编写以下代码：

class User < ApplicationRecord
  validates :password, confirmation: true
end

在视图中，您将有两个字段，一个用于密码，一个用于确认，确认字段将命名为password_confirmation。

包含验证

包含验证用于确保某个字段包含在一组特定的值中。例如，如果你想确保用户模型有一个角色字段是admin、moderator或member，你可以编写以下代码：

class User < ApplicationRecord
  validates :role, inclusion: { in: %w(admin moderator member) }
end

排除验证

排除验证用于确保某个字段不包含在特定的一组值中。例如，如果要确保 User 模型没有 role 字段是admin或root，则可以编写以下代码：

class User < ApplicationRecord
  validates :role, exclusion: { in: %w(admin root) }
end

自定义消息验证

您还可以为每个验证指定自定义错误消息。例如，如果您想在用户模型的电子邮件格式不正确时显示自定义错误消息，您可以编写以下代码：

class User < ApplicationRecord
  validates :email, format: { with: /\A([^@\s]+)@((?:[-a-z0-9]+.)+[a-z]{2,})\z/i, 
    message: "is not a valid email address" }
end

条件验证

条件验证允许您指定仅在满足特定条件时才进行验证。您可以使用if选项指定条件。例如，如果你想确保 User 模型的密码至少有 8 个字符长，只有当密码字段不为 nil 时，你可以编写以下代码：

class User < ApplicationRecord
  validates :password, length: { minimum: 8 }, if: :password_not_nil

  private
    def password_not_nil
      password.present?
    end
end

多重验证

您可以通过将验证链接在一起来对单个字段使用多个验证。例如，如果你想确保 User 模型的电子邮件存在、格式正确且唯一，你可以编写以下代码：

class User < ApplicationRecord
  validates :email, presence: true, format: { with: /\A([^@\s]+)@((?:[-a-z0-9]+.)+[a-z]{2,})\z/i }, uniqueness: true
end

自定义验证

除了内置的验证方法之外，Rails 还允许您创建自定义验证。例如，如果你想确保用户模型具有唯一的名字和姓氏组合，你可以编写一个自定义验证方法：

class User < ApplicationRecord
  validate :unique_name

  def unique_name
    if User.exists?(first_name: first_name, last_name: last_name)
      errors.add(:first_name, "and last name have already been taken")
    end
  end
end

或者如果你想确保 User 模型的名称总是大写，你可以编写以下代码：

class User < ApplicationRecord
  validate :name_must_be_capitalized

  private
    def name_must_be_capitalized
      errors.add(:name, "must be capitalized") unless name.nil? || name == name.capitalize
    end
end

关联验证

除了验证单个模型之外，您还可以验证模型之间的关联。关联验证允许您为依赖于其他模型状态的模型指定验证。

例如，如果用户模型有很多帖子，您可以验证用户必须至少有一个帖子才能保存到数据库中。您将编写以下代码：

class User < ApplicationRecord
  has_many :posts
  validates_associated :posts
end

class Post < ApplicationRecord
  belongs_to :user
  validates :title, presence: true
end

在这个例子中，一个用户不会被保存到数据库中，除非它至少有一个带有标题的关联帖子。

结论

总之，验证是任何 Rails 应用程序的重要组成部分。通过使用验证，您可以确保您的数据始终准确、一致并符合您指定的标准。

无论您是验证单个模型还是模型之间的关联，Rails 都可以轻松指定和执行您的验证规则。借助 Rails 验证的强大功能，您可以使您的应用程序更加健壮和可靠，确保用户输入的数据始终准确且一致。

avatar
文章
阅读
粉丝