本文實(shí)例講述了Django框架model模型對(duì)象驗(yàn)證實(shí)現(xiàn)方法。分享給大家供大家參考，具體如下：

模型對(duì)象的驗(yàn)證

驗(yàn)證一個(gè)模型涉及三個(gè)步驟：

• 驗(yàn)證模型的字段 —— Model.clean_fields()
• 驗(yàn)證模型的完整性 —— Model.clean()
• 驗(yàn)證模型的唯一性 —— Model.validate_unique()

當(dāng)調(diào)用模型的full_clean() 方法時(shí)，這三個(gè)方法都將執(zhí)行。當(dāng)使用ModelForm時(shí)，is_valid() 將為表單中的所有字段執(zhí)行這些驗(yàn)證。如果你計(jì)劃自己處理驗(yàn)證出現(xiàn)的錯(cuò)誤，或者你已經(jīng)將需要驗(yàn)證的字段從ModelForm 中去除掉，你只需調(diào)用模型的full_clean() 方法。

Model.full_clean(exclude=None, validate_unique=True)

該方法按順序調(diào)用Model.clean_fields()、Model.clean() 和Model.validate_unique()（如果validate_unique 為True），并引發(fā)一個(gè)ValidationError，該異常的message_dict 屬性包含三個(gè)步驟的所有錯(cuò)誤?？蛇x的exclude 參數(shù)用來提供一個(gè)可以從驗(yàn)證和清除中排除的字段名稱的列表。ModelForm 使用這個(gè)參數(shù)來排除表單中沒有出現(xiàn)的字段，使它們不需要驗(yàn)證，因?yàn)橛脩魺o法修正這些字段的錯(cuò)誤。注意，當(dāng)你調(diào)用模型的save() 方法時(shí)，full_clean() 不會(huì) 自動(dòng)調(diào)用。如果你想一步就可以為你手工創(chuàng)建的模型運(yùn)行驗(yàn)證，你需要手工調(diào)用它。例如：

from django.core.exceptions import ValidationError
try:
  article.full_clean()
except ValidationError as e:
  # Do something based on the errors contained in e.message_dict.
  # Display them to a user, or handle them programmatically.
  pass

full_clean() 第一步執(zhí)行的是驗(yàn)證每個(gè)字段。

Model.clean_fields(exclude=None)

這個(gè)方法將驗(yàn)證模型的所有字段?？蛇x的exclude 參數(shù)讓你提供一個(gè)字段名稱列表來從驗(yàn)證中排除。如果有字段驗(yàn)證失敗，它將引發(fā)一個(gè)ValidationError。

full_clean() 第二步執(zhí)行的是調(diào)用Model.clean()。如要實(shí)現(xiàn)模型自定義的驗(yàn)證，應(yīng)該覆蓋這個(gè)方法。

Model.clean()

應(yīng)該用這個(gè)方法來提供自定義的模型驗(yàn)證，以及修改模型的屬性。例如，你可以使用它來給一個(gè)字段自動(dòng)提供值，或者用于多個(gè)字段需要一起驗(yàn)證的情形：

import datetime
from django.core.exceptions import ValidationError
from django.db import models
class Article(models.Model):
  ...
  def clean(self):
    # Don't allow draft entries to have a pub_date.
    if self.status == 'draft' and self.pub_date is not None:
      raise ValidationError('Draft entries may not have a publication date.')
    # Set the pub_date for published items if it hasn't been set already.
    if self.status == 'published' and self.pub_date is None:
      self.pub_date = datetime.date.today()

和Model.full_clean() 類似，調(diào)用模型的save() 方法時(shí)不會(huì)引起clean() 方法的調(diào)用。

在上面的示例中，Model.clean() 引發(fā)的ValidationError 異常通過一個(gè)字符串實(shí)例化，所以它將被保存在一個(gè)特殊的錯(cuò)誤字典鍵NON_FIELD_ERRORS中。這個(gè)鍵用于整個(gè)模型出現(xiàn)的錯(cuò)誤而不是一個(gè)特定字段出現(xiàn)的錯(cuò)誤：

from django.core.exceptions import ValidationError, NON_FIELD_ERRORS
try:
  article.full_clean()
except ValidationError as e:
  non_field_errors = e.message_dict[NON_FIELD_ERRORS]

若要引發(fā)一個(gè)特定字段的異常，可以使用一個(gè)字典實(shí)例化ValidationError，其中字典的鍵為字段的名稱。我們可以更新前面的例子，只引發(fā)pub_date 字段上的異常：

class Article(models.Model):
  ...
  def clean(self):
    # Don't allow draft entries to have a pub_date.
    if self.status == 'draft' and self.pub_date is not None:
      raise ValidationError({'pub_date': 'Draft entries may not have a publication date.'})
    ...

最后，full_clean() 將檢查模型的唯一性約束。

Model.validate_unique(exclude=None)

該方法與clean_fields() 類似，只是驗(yàn)證的是模型的所有唯一性約束而不是單個(gè)字段的值。可選的exclude 參數(shù)允許你提供一個(gè)字段名稱的列表來從驗(yàn)證中排除。如果有字段驗(yàn)證失敗，將引發(fā)一個(gè) ValidationError。

注意，如果你提供一個(gè)exclude 參數(shù)給validate_unique()，任何涉及到其中一個(gè)字段的unique_together 約束將不檢查。

希望本文所述對(duì)大家基于Django框架的Python程序設(shè)計(jì)有所幫助。

最新評(píng)論