Django 用表单验证数据笔记

最新推荐文章于 2024-06-25 15:08:05 发布

wuhaiwenpps

最新推荐文章于 2024-06-25 15:08:05 发布

阅读量259

点赞数

分类专栏： django 文章标签： python django

本文链接：https://blog.csdn.net/wuhaiwenpps/article/details/108729902

版权

django 专栏收录该内容

6 篇文章 0 订阅

订阅专栏

表单

html中的表单

单纯从前端的html来说，表单是用来提交数据给服务器的，不管后台的服务器用的是Django还是PHP语言，还是其他语言，只要把input标签放在form标签中，然后再添加一个提交按钮，那么以后点击提交按钮，就可以将input标签中对应的值提交给服务器了。

Django中的表单

Django中的表单丰富了传统的HTML语言中的表单，在Django中的表单，主要做以下两件事
1、渲染表单模板
2、表单验证数据是否合法

Django中表单使用流程

在讲解Django表单的具体每部分的细节之前，我们首先来看下整体的使用流程
首先我们在后台服务器定义一个表单类，继承自django.forms.Form

#forms.py
class MessageBoardForm(forms.Form):
	title = forms.CharField(max_length=3, label='标题', min_length=2, error_messages={"min_length": "标题字段不符合要求"})
    content = forms.CharField(widget=forms.Textarea, label="内容", error_messages={"required": "conten字段必须填写t"})
    email = forms.EmailField(label="邮箱")
    reply = forms.BooleanField(required=False, label="回复")

然后在视图中，根据GET还是POST请求来做相应的操作，如果是GET请求，那么返回一个空的表单，如果是POST请求，那么将提交上来的数据进行校验

from .forms import MessageForm
from django.views import View

class IndexView(View):
    def get(self,request):
        form = MessageForm()
        return render(request,"index.html",{"forms":form})
    def post(self,request):
        form = MessageForm(request.POST)
        if form.is_valid():
            print(form.cleaned_data)
            title = form.cleaned_data.get("title")
            return HttpResponse("提交成功")
        else:
            print(form.errors)
            return HttpResponse("提交失败")

index.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>首页</title>
</head>
<body>

<form action="" method="post">
    {% csrf_token %}
    <table>
        {{ forms.as_table }}
    </table>
        <td></td>
        <td><input type="submit" value="提交"></td>
</form>
</body>
</html>

我们在最外面给了一个form标签，然后在里面使用了table标签来进行美化，在使用form对象渲染的时候，使用的是table的方式，当然还可以使用ul的方式（as_ul）,也可以使用p标签的方式(as_p)，并且在后面我们还加上了一个提交按钮，这样就可以生成一个表单了

常用的Field

使用Field可以是对数据验证的第一步，你期望这个提交上来的数据是什么类型，那么就使用什么类型的Field

CharField

用来接收文本

参数
max_length:这个字段值的最大长度
min_length:这个字段值的最小长度
required:这个字段是否是必须的，默认是必须的
error_messages:在某个条件验证失败的时候，给出错误信息

EmailField

用来接收邮件，会自动验证邮件是否合法
错误信息的key：required，invalid

FloatField

用来接收浮点类型，并且如果验证通过后，会将这个字段的值转换为浮点类型

参数
max_value:最大的值
min_value:最小的值
错误信息的key：required，invalid，max_value，min_value

IntegerField

用来接收整形，并且验证通过后，会将这个字段的值转换为整型

参数
max_value:最大的值
min_value:最小的值
错误信息的key：required,invalid,max_value,min_value

URLField

用来接收url格式的字符串
错误信息的key：required、invalid

常用验证器

在验证某个字段的时候，可以传递一个validators参数用来指定验证器，进一步对数据进行过滤，验证器有很多，但是很多验证器我们其实已经通过这个Field或者一些参数就可以指定了，比如EmailVaildator，我们可以通过EmailField来指定，比如MaxValueValidator，我们可以通过max_value参数来指定。

MaxValueValidaror：验证最大值
MinValueValidaror：验证最小值
MinLengthValidaror：验证最小长度
MaxLengthValidaror：验证最大长度
EmailValidaror：验证是否是邮箱格式
RegexValidator：如果还需要更加复杂的验证，那么我们可以通过正则表达式的验证器：RegexValidator。

from django.core import validators
class MyForm(forms,form):
	telephone = forms.CharField(calidators=[validators.RegexValidator("1[345678]\d{9}",message="请输入正确的手机号")])

自定义验证器

有时候对一个字段验证，不是一个长度，一个正则表达式能够写清楚的，还需要一些其他复杂的逻辑，那么我们可以对某个字段，进行自定义的验证，比如在注册的表单验证中，我们想要验证手机号码是否已经被注册过了，那么这时候就需要在数据库中进行判断才知道，对某个字段进行自定义的验证方式是，定义一个方法，这个方法的名字定义规则是：clean_fieldname。如果验证失败，那么就抛出一个验证错误，比如要验证用户表中手机号和之前是否在数据库中存在，那么可以通过以下代码实现

class MyForm(forms.Form):
		telephone = forms.CharField(calidators=[validators.RegexValidator("1[345678]\d{9}",message="请输入正确的手机号")])
		def clean_telephone(self):
			telephone = self.cleaned_data.get('telephone')
			exists = User.objects.filter(telephone=telephone).exists()
			if exists:
				raise forms.ValidationError('手机号码已经存在！')
			return telephone

以上是对某个字段进行验证，如果验证数据的时候，需要针对多个字段进行验证，那么可以重写clean()方法，比如要在注册的时候，要判断提交的两个密码是否相等。

class MyForm(forms.Form):
		telephone = forms.CharField(calidators=[validators.RegexValidator("1[345678]\d{9}",message="请输入正确的手机号")])
		pwd1=forms.CharField(max_length=12)
		pwd2=forms.CharField(max_length=12)
		def clean(self):
			cleaned_data = super().clean()
			pwd1 = cleaned_data.get('pwd1')
		def clean(self):
			cleaned_data = super().clean()
			pwd1 = self.cleaned_data.get('pwd1')
			pwd1 = self.cleaned_data.get('pwd1')
			if pwd1 !=pwd2:
				raise forms.ValidationError('两次密码不一致!')
			return cleaned_data

提取错误信息

如果验证失败了，那么有一些错误信息是我们需要传给前端的，这时候我们可以通过以下属性来获取：
1、form.errors:这个属性获取的错误信息是一个包含了html标签的错误信息
2、form.errors.get_json_data():这个方法获取到的是一个字典类型的错误信息，将某个字段的名字作为key，错误信息作为值的一个字典
3、forms.as_json():这个方法是将form.get_json_data()返回的字典dump成json格式的字符串，方便进行传输
4、上述方法获取的字段的错误值，都是一个比较复杂的数据，比如以下：
{‘username’:[{‘message’:‘Enter a valid URL’,‘code’:‘invalid’},{‘message’:‘Ensure this value has at most 4 characters (it ha 22)’,‘code’:‘max_length’}]}

那么如果我只想把错误信息放在一个列表中，而不要再放在一个字典中，这时候我们可以定义一个方法，把这个数据重新整理一份。

class MyForm(forms.Form):
	username = forms.URLField(max_length=4)
	
	def get_errors(self):
		errors = self.errors.get_json_data()
		new_errors = {}
		for key,message_dicts in errors.items():
			message = []
			for message in message_dicts:
				message.append(message['message'])
			new_error[key] = message
		return new_errors

这样就可以把某个字段所有的错误信息直接放在这个列表中。

ModelForm

大家在写表单的时候，会发现表单中的Field和模型中的Field基本上是一模一样的，而且表单中需要验证的数据，也就是我们模型中需要保存的，那么这时候我们就可以将模型中的字段和表单中的字段进行绑定
比如现在有个Article的模型

from django.db import models
from django.core import validators
class Article(models.Model):
		title = models.CharField(max_length=10,validators=[validators.MinLengthValidator(limit_value=3)])
		content = models.TextField()
		author = models.CharField(max_length=100)
		category = models.CharField(max_length=100)
		create_time = models.DateTimeField(auto_now_add=True)

那么在写表单的时候，就不需要把Article模型中所有的字段都一个个重复写一遍了。

from django import forms
from .models import Article

class AddForms(forms.ModelForm):
    class Meta:
        model = Article
        fields = '__all__'
#自定义错误信息
        error_messages = {
            "title":{
                "max_length":"最大长度为xxx",
                "min_length":"最小长度为xxx"
            }
        }

MyForm是继承自forms.ModelForm，然后在表单中定义了一个Meta类，在Meta类中指定了model=Article，以及fields=“all”,这样就可以将Article模型中所有的字段都复制过来，进行验证，如果只想针对其中几个字段进行验证，那么可以给fields指定一个列表，将需要的字段写进去。比如只想验证title和content，那么可以使用以下代码实现

from django import forms
from .models import Article

class AddForms(forms.ModelForm):
    class Meta:
        model = Article
        #fields = ["title"]     只验证title
        #exclude = ["title","content"]   除title和content外全部验证
        fields = '__all__'
#自定义错误信息
        error_messages = {
            "title":{
                "max_length":"最大长度为xxx",
                "min_length":"最小长度为xxx"
            }
        }

save方法

ModelForm还有save()方法，可以在验证完成后直接调用save方法，就可以将这个数据保存到数据库中了

class AddArticle(View):
    def get(self,request):
        return render(request,"add.html")
    def post(self,request):
        form = AddForms(request.POST)
        if form.is_valid():
            form.save()
            return HttpResponse("success")
        else:
            print(form.errors.get_json_data())
            return HttpResponse("fail")

这个方法必须要在clean没有问题后才能使用，如果在clean之前使用，会抛出异常，另外，我们在调用save方法的时候，如果传入一个commit=False，那么只会生成这个模型的对象，而不会把这个对象真正的插入到数据库中，比如表单上验证的字段没有包含模型中所有的字段，这时候就可以先创建对象，再根据填充其他字段，把所有字段的值都补充完成后，再保存到数据库中。

form=MyForm(request.POST)
if form.is_valid():
    article = form.save(commit=False)
    article.category="Python"
    article.save()
    return HttpResponse("success")
else:
    print(form.get_errors())
    return HttpResponse("fail")

文件上传

前端HTML代码实现

1、在前端中，我们需要填入一个form标签，然后在这个form标签中指定enctype = “multipart/form-data”,不然就不能上传文件
2、在form标签中添加一个input标签，然后指定input标签的name，以及type=“file”

<form action="" method="post" enctype="multipart/form-data">
		<input type="file" name="myfile">
</form>

后端代码的实现

后端的主要工作是接受文件，然后存储文件，接受文件的方式跟接受POST的方式是一样的，只不过是通过FILES来实现的。

def save_file(file):
	with open('somefile.txt','wb') as fp:
		for chunk in file.chunks():
			fp.write(chunk.read())
def index(request):
	if request.method=="GET":
		form = MyForm()
		return render(request,"index.html",{'form':form})
	else:
	myfile = request.FILES.get('myfile')
	save_file(myfile)
	return HttpResponse("success")

以上代码通过request.FILES接收到文件后，再写入到指定的地方，这样就可以完成一个文件的上传功能了。
在这里插入图片描述

使用模型来处理上传的文件

在定义模型的时候，我们可以给存储文件的字段指定为FileField，这个Field可以传递一个upload_to参数，用来指定上传上来的文件保存到哪里，比如我们让他保存到项目的files文件夹下

#models.py
from django.db import models
from django.core import validators
class Article(models.Model):
		title = models.CharField(max_length=10,validators=[validators.MinLengthValidator(limit_value=3)])
		content = models.TextField()
		author = models.CharField(max_length=20)
		category = models.CharField(max_length=100)
		create_time = models.DateTimeField(auto_now_add=True)
		image = models.FileField(upload_to="files",null=True)
		#image = models.FileField(upload_to="%Y%m%d",null=True)   按照年月日路径保存

#views.py
class AddArticle(View):
    def get(self,request):
        return render(request,"add.html")
    def post(self,request):
       
        title = request.POST.get("title")
        content = request.POST.get("content")
        author = request.POST.get("author")
        category = request.POST.get("category")
        image = request.FILES.get('image')
        article = Article(title=title,content=content,author=author,category=category,image=image)
        article.save()
        return HttpResponse("success")
#add.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<form action="" method='post' enctype="multipart/form-data">
{% csrf_token %}
    标题<input type="text" name="title"><br>
    内容<textarea  name="content"></textarea><br>
    作者<input type="text" name="author"><br>
    类别<input type="text" name="category"><br>
    上传图片<input type="file" name="image"><br>
    <input type="submit" value="提交"><br>
</form>
</body>
</html>

指定MEDIA_ROOT和MEDIA_URL

以上我们是使用了upload_to来指定上传的文件的目录，我们也可以指定MEDIA_ROOT，就不需要再FileField中指定upload_to，它会自动的将文件上传到MEDIA_ROOT的目录下。

#settings.py
MEDIA_ROOT = os.path.join(BASE_DIR,"media")
MEDIA_URL = "/media/"

然后我们就可以在urls.py中添加MEDIA_ROOT目录下的访问路径。

from django.urls import path
from front import views
from django.conf.urls.static import static
from django.conf import settings
urlpatterns = [
		path("",views.index),
]+ static(settings.MEDIA_URL,document_root = settings.MEDIA_ROOT)

限制上传的文件拓展名

如果想要限制上传的文件的拓展名，那么我们就需要用到表单来进行限制，我们可以使用普通的Form表单，也可以使用ModelForm，直接从模型中读取字段

上传文件

#models.py
from django.db import models
from django.core import validators
class Article(models.Model):
		title = models.CharField(max_length=10,validators=[validators.MinLengthValidator(limit_value=3)])
		content = models.TextField()
		author = models.CharField(max_length=20)
		category = models.CharField(max_length=100)
		create_time = models.DateTimeField(auto_now_add=True)
		image = models.FileField(upload_to="%Y%m%d",null=True,validators=[validators.FileExtensionValidator(['txt','doc'])])

#views.py
class AddArticle(View):
    def get(self,request):
        return render(request,"add.html")
    def post(self,request):
        form = AddForms(request.POST,request.FILES)
        if form.is_valid():
            form.save()
            return HttpResponse("success")
        else:
            print(form.errors.get_json_data())
            return HttpResponse("fail")

# forms.py

from django import forms
from .models import Article

class AddForms(forms.ModelForm):
    class Meta:
        model = Article
        #fields = ["title"]     只验证title
        #exclude = ["title"]   除title外全部验证
        fields = '__all__'
        # exclude = ["image"]
        error_messages = {
            "title":{
                "max_length":"最大长度为10",
                "min_length":"最小长度为2"
            },
            "content":{
                'required':'必须输入content'
            },
            "image":{
                "required":"文件必须上传",
                "invalid_extension":"文件类型不正确"
            }
        }

上传图片

上传图片跟上传普通文件是一样的，只不过是上传图片的时候Django会判断上传的文件是否是图片的格式（除了判断后缀名，还会判断是否是可用的图片），如果不是，那么就会验证失败，我们首先来定义一个包含ImageField的模型

class Article(models.Model):
	title = models.CharField(max_length=100)
	content = models.TextField()
	thumbnail = models.ImageField(upload_to="%Y%m%d")

因为要验证是否是合格的图片，因此我们还需要用一个表单来验证，表单我们就直接使用ModelForm就可以了

class BookForms(forms.Form):
	files = forms.ImageField(error_message={"invalid_image":"格式不对"})

注意：使用ImageField，必须要安装Pillow：pip install pillow

wuhaiwenpps

关注

0
点赞
踩
1

收藏

觉得还不错? 一键收藏
0
评论
Django 用表单验证数据笔记

表单html中的表单单纯从前端的html来说，表单是用来提交数据给服务器的，不管后台的服务器用的是Django还是PHP语言，还是其他语言，只要把input标签放在form标签中，然后再添加一个提交按钮，那么以后点击提交按钮，就可以将input标签中对应的值提交给服务器了。Django中的表单Django中的表单丰富了传统的HTML语言中的表单，在Django中的表单，主要做以下两件事1、渲染表单模板2、表单验证数据是否合法...
复制链接

扫一扫