Configure Document Validation

유효성 검사 규칙 정의

validates 매크로를 사용하여 유효성 검사 규칙을 만든 다음 유효성 검사 헬퍼와 규칙에 필요한 사양을 포함합니다.

다음 코드는 presence 유효성 검사 헬퍼를 사용하여 Person 인스턴스에 name 필드 값이 포함되도록 요구하는 방법을 보여 줍니다.

class Person
  include Mongoid::Document
  
  field :name, type: String
  validates :name, presence: true
end

이 가이드 의 일반적인 유효성 검사 섹션에서 다른 유용한 유효성 검사 헬퍼에 대해 학습 수 있습니다.

비교 규칙

comparison 헬퍼를 사용하여 지정된 필드 값을 기반으로 문서 유효성을 검사할 수 있습니다.

comparison 헬퍼는 다음 옵션을 지원합니다.

• greater_than: 값은 제공된 값보다 커야 합니다.

• greater_than_or_equal_to: 값은 제공된 값보다 크거나 같아야 합니다.

• equal_to: 값은 제공된 값과 같아야 합니다.

• less_than: 값은 제공된 값보다 작아야 합니다.

• less_than_or_equal_to: 값은 제공된 값보다 작거나 같아야 합니다.

• other_than: 값은 제공된 값과 달라야 합니다.

이 예시 Order 모델에 대해 다음과 같은 비교 유효성 검사 규칙을 정의합니다.

• delivery_date: 다음 값 이후(보다 큰)여야 합니다. order_date

• quantity: 다음보다 작아야 합니다. 5

class Order
  include Mongoid::Document
  
  field :order_date, type: DateTime
  field :delivery_date, type: DateTime
  field :quantity, type: Integer
  validates :delivery_date, comparison: { greater_than: :order_date }
  validates :quantity, comparison: { less_than: 5 }
end

서식 지정 규칙

format 헬퍼를 사용하여 필드 값이 정규 표현식 과 일치하는지 여부에 따라 문서 유효성을 검사할 수 있습니다. with 옵션을 사용하여 정규 표현식 지정합니다.

이 예시 User 모델에 대한 형식 유효성 검사 규칙을 정의하여 username 필드 에 문자만 포함되도록 합니다.

class User
  include Mongoid::Document
  
  field :username, type: String
  validates :username, format: { with: /\A[a-zA-Z]+\z/ }
end

validates_format_of :username, with: /\A[a-zA-Z]+\z/

포함 또는 제외 규칙

inclusion 및 exclusion 헬퍼를 사용하여 필드 값이 지정된 값 목록에 있는지 여부에 따라 문서 유효성을 검사할 수 있습니다. in 옵션을 사용하여 값 목록을 지정합니다.

이 예시 shipping 필드 값이 허용되는 값 중 하나인지 확인하기 위해 Order 모델에 포함 유효성 유효성 검사 규칙을 정의합니다.

class Order
  include Mongoid::Document
  
  field :shipping, type: String
  validates :shipping, inclusion: { in: %w(standard priority overnight) }
end

유무 규칙

presence 및 absence 헬퍼를 사용하여 필드 값이 있는지 여부(비어 있음)에 따라 문서 유효성을 검사할 수 있습니다.

이 예시 Order 모델에 대한 부재 유효성 검사 규칙을 정의하여 delivery_date 필드 값이 nil 또는 빈 문자열이 되도록 합니다.

class Order
  include Mongoid::Document
  
  field :delivery_date, type: String
  validates :delivery_date, absence: true
end

validates_presence_of :delivery_date

고유성 규칙

필드 값이 컬렉션 의 다른 값과 고유한지 여부에 따라 uniqueness 헬퍼를 사용하여 문서 유효성을 검사할 수 있습니다. scope 옵션을 사용하여 Mongoid가 고유성 검사를 제한하는 데 사용하는 필드 이름을 하나 이상 지정할 수 있습니다.

이 예시 first_name 필드 값이 동일한 last_name 값을 가진 문서 내에서 고유하도록 Person 모델에 대한 고유성 유효성 유효성 검사 규칙을 정의합니다.

class Person
  include Mongoid::Document
  
  field :first_name, type: String
  field :last_name, type: String
  validates :first_name, uniqueness: { scope: :last_name }
end

validates_uniqueness_of :first_name

validates_uniqueness_of :name, conditions: -> { where(:age.gte => 10) }

연관 관계 검증

You can use the validates_associated helper to validate any associations that your model has. When you include this validation rule, Mongoid validates any association documents any time you try to save an instance. To learn more about associations, see the Use Data Associations guide.

이 예시 포함된 Book 인스턴스에 대한 유효성 검사 검사 규칙을 실행 위해 Author 모델에 대한 연결 유효성 유효성 검사 규칙을 정의합니다.

class Author
  include Mongoid::Document
  
  embeds_many :books
  validates_associated :books
end

사용자 지정 유효성 검사 규칙

validates_each 및 validates_with 헬퍼를 사용하여 사용자 지정 유효성 검사기를 만들 수 있습니다. 이러한 헬퍼에 대해 자세히 학습 예제를 보려면 액티브 레코드 문서에서 validates_each 및 validates_with 참조를 참조하세요.

사용자 지정 유효성 검사기에 대해 자세히 학습하려면 액티브 레코드 문서에서 사용자 지정 유효성 검사 수행하기 를 참조하세요.

트리거하다 유효성 검사

valid? 메서드를 사용하여 유효성 검사를 수동으로 실행 수 있습니다. 이 메서드는 객체 유효성 검사 통과하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

class Person
  include Mongoid::Document
  
  field :name, type: String
  field :age, type: Integer
  validates :age, comparison: { greater_than_or_equal_to: 0 }
end
# Returns true
Person.new(name: "Berta Odom", age: 4).valid?
# Returns false
Person.new(name: "Cody Peng", age: -5).valid?

Mongoid는 영구 데이터에서 valid? 를 실행 때 Active Record와 다르게 동작합니다. Active Record의 valid? 는 모든 유효성 검사를 실행하지만 Mongoid의 valid? 는 성능을 최적화하기 위해 메모리에 있는 문서에 대해서만 유효성 검사를 실행합니다.