Django框架model模型对象验证实现方法分析


Posted in Python onOctober 02, 2019

本文实例讲述了Django框架model模型对象验证实现方法。分享给大家供大家参考,具体如下:

模型对象的验证

验证一个模型涉及三个步骤:

  • 验证模型的字段 —— Model.clean_fields()
  • 验证模型的完整性 —— Model.clean()
  • 验证模型的唯一性 —— Model.validate_unique()

当调用模型的full_clean() 方法时,这三个方法都将执行。当使用ModelForm时,is_valid() 将为表单中的所有字段执行这些验证。如果你计划自己处理验证出现的错误,或者你已经将需要验证的字段从ModelForm 中去除掉,你只需调用模型的full_clean() 方法。

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

该方法按顺序调用Model.clean_fields()、Model.clean() 和Model.validate_unique()(如果validate_unique 为True),并引发一个ValidationError,该异常的message_dict 属性包含三个步骤的所有错误。可选的exclude 参数用来提供一个可以从验证和清除中排除的字段名称的列表。ModelForm 使用这个参数来排除表单中没有出现的字段,使它们不需要验证,因为用户无法修正这些字段的错误。注意,当你调用模型的save() 方法时,full_clean() 不会 自动调用。如果你想一步就可以为你手工创建的模型运行验证,你需要手工调用它。例如:

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() 第一步执行的是验证每个字段。

Model.clean_fields(exclude=None)

这个方法将验证模型的所有字段。可选的exclude 参数让你提供一个字段名称列表来从验证中排除。如果有字段验证失败,它将引发一个ValidationError。

full_clean() 第二步执行的是调用Model.clean()。如要实现模型自定义的验证,应该覆盖这个方法。

Model.clean()

应该用这个方法来提供自定义的模型验证,以及修改模型的属性。例如,你可以使用它来给一个字段自动提供值,或者用于多个字段需要一起验证的情形:

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() 类似,调用模型的save() 方法时不会引起clean() 方法的调用。

在上面的示例中,Model.clean() 引发的ValidationError 异常通过一个字符串实例化,所以它将被保存在一个特殊的错误字典键NON_FIELD_ERRORS中。这个键用于整个模型出现的错误而不是一个特定字段出现的错误:

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]

若要引发一个特定字段的异常,可以使用一个字典实例化ValidationError,其中字典的键为字段的名称。我们可以更新前面的例子,只引发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() 类似,只是验证的是模型的所有唯一性约束而不是单个字段的值。可选的exclude 参数允许你提供一个字段名称的列表来从验证中排除。如果有字段验证失败,将引发一个 ValidationError。

注意,如果你提供一个exclude 参数给validate_unique(),任何涉及到其中一个字段的unique_together 约束将不检查。

希望本文所述对大家基于Django框架的Python程序设计有所帮助。

Python 相关文章推荐
python通过smpt发送邮件的方法
Apr 30 Python
Python中的异常处理相关语句基础学习笔记
Jul 11 Python
Python使用plotly绘制数据图表的方法
Jul 18 Python
详解Python 模拟实现生产者消费者模式的实例
Aug 10 Python
Python3 chardet模块查看编码格式的例子
Aug 14 Python
python将字典列表导出为Excel文件的方法
Sep 02 Python
python flask搭建web应用教程
Nov 19 Python
python matplotlib拟合直线的实现
Nov 19 Python
django的autoreload机制实现
Jun 03 Python
Python如何自动获取目标网站最新通知
Jun 18 Python
解决运行django程序出错问题 'str'object has no attribute'_meta'
Jul 15 Python
python爬虫多次请求超时的几种重试方法(6种)
Dec 01 Python
Python 线程池用法简单示例
Oct 02 #Python
python multiprocessing多进程变量共享与加锁的实现
Oct 02 #Python
Python shutil模块用法实例分析
Oct 02 #Python
Windows平台Python编程必会模块之pywin32介绍
Oct 01 #Python
Python全栈之列表数据类型详解
Oct 01 #Python
python2和python3应该学哪个(python3.6与python3.7的选择)
Oct 01 #Python
使用Python制作一个打字训练小工具
Oct 01 #Python
You might like
php根据命令行参数生成配置文件详解
2019/03/15 PHP
用JavaScript页面不刷新时全选择,全删除(GridView)
2009/04/14 Javascript
jQuery 处理网页内容的实现代码
2010/02/15 Javascript
js获取location.href的参数实例代码
2013/08/02 Javascript
js 去掉空格实例 Trim() LTrim() RTrim()
2014/01/07 Javascript
jquery的ajax跨域请求原理和示例
2014/05/08 Javascript
webapp框架AngularUI的demo改造之路
2014/12/21 Javascript
JavaScript生成二维码图片小结
2015/12/27 Javascript
JavaScript设计模式初探
2016/01/07 Javascript
用move.js库实现百叶窗特效
2017/02/08 Javascript
详解vue.js全局组件和局部组件
2017/04/10 Javascript
Bootstrap下拉菜单更改为悬停(hover)触发的方法
2017/05/24 Javascript
AngularJs的UI组件ui-Bootstrap之Tooltip和Popover
2018/07/13 Javascript
javaScript实现游戏倒计时功能
2018/11/17 Javascript
TypeScript中的方法重载详解
2019/04/12 Javascript
Javascript组合继承方法代码实例解析
2020/04/02 Javascript
Python利用Nagios增加微信报警通知的功能
2016/02/18 Python
python学习之matplotlib绘制散点图实例
2017/12/09 Python
基于windows下pip安装python模块时报错总结
2018/06/12 Python
Python 运行 shell 获取输出结果的实例
2019/01/07 Python
基于wxPython的GUI实现输入对话框(2)
2019/02/27 Python
Python3.5 Pandas模块之DataFrame用法实例分析
2019/04/23 Python
numpy concatenate数组拼接方法示例介绍
2019/05/27 Python
Python操作Sqlite正确实现方法解析
2020/02/05 Python
django2.2 和 PyMySQL版本兼容问题
2020/02/17 Python
如何利用Python动态模拟太阳系运转
2020/09/04 Python
Python3.9.1中使用split()的处理方法(推荐)
2021/02/07 Python
HTML5 通过Vedio标签实现视频循环播放的示例代码
2020/08/05 HTML / CSS
中国领先的专业家电网购平台:国美在线
2016/12/25 全球购物
Otiumberg官网:英国半精致珠宝品牌
2021/01/16 全球购物
十八大闭幕感言
2014/01/22 职场文书
青年文明号汇报材料
2014/12/23 职场文书
工会经费申请报告
2015/05/15 职场文书
陪护人员误工证明
2015/06/24 职场文书
教你使用Python pypinyin库实现汉字转拼音
2021/05/27 Python
PyTorch dropout设置训练和测试模式的实现
2021/05/27 Python