1、form介绍

我们之前在HTML页面中利用form表单向后端提交数据时，都会写一些获取用户输入的标签并且用form标签把它们包起来。
与此同时我们在好多场景下都需要对用户的输入做校验，比如校验用户是否输入，输入的长度和格式等正不正确。如果用户输入的内容有错误就需要在页面上相应的位置显示对应的错误信息.。

Django form组件就实现了上面所述的功能。
总结一下，其实form组件的主要功能如下:

  • 生成页面可用的HTML标签
  • 对用户提交的数据进行校验（校验请求参数、也可以做请求参数的数据加工）
  • 保留上次输入内容

2、form使用

user_demo这个应用的模型类

  1. from django.db import models
  2. from django.core.paginator import Paginator
  4. # Create your models here.
  6. class NewUser(models.Model):
  7.     phone = models.CharField(verbose_name="手机号",max_length=11,unique=True)
  8.     email = models.EmailField(verbose_name="邮箱",max_length=50,unique=True)
  9.     nick = models.CharField(verbose_name="昵称", max_length=50)
  10.     password = models.CharField(verbose_name="密码",max_length=32)
  12.     class Meta:
  13.         verbose_name = "用户表"
  14.         verbose_name_plural = verbose_name
  15.         db_table = "new_user" # 映射的用户注册表名称
  17.     def __str__(self):
  18.         return self.nick

2.1、简写版本

2.1.1、在应用目录下创建forms.py文件，定义一个 自定义类

这个类用来校验注册接口

  1. from django import forms
  2. from . import models
  5. class RegisterForms(forms.Form):
  6.     phone = forms.CharField(min_length=11, max_length=11)
  7.     email = forms.EmailField()
  8.     nick = forms.CharField()
  9.     password = forms.CharField(min_length=6,max_length=13)
  10.     password2 = forms.CharField(min_length=6,max_length=13)
  12.     def clean_phone(self):
  13.         phone = self.cleaned_data["phone"]
  14.         if not phone.isdigit():
  15.             raise forms.ValidationError("手机号格式错误~")
  16.         if models.NewUser.objects.filter(phone=phone).exists():
  17.             raise forms.ValidationError("手机号已存在！")
  18.         return phone
  20.     def clean_email(self):
  21.         email = self.cleaned_data["email"]
  22.         if models.NewUser.objects.filter(email=email).exists():
  23.             raise forms.ValidationError("邮箱已存在！")
  24.         return email
  26.     def clean(self):
  27.         cleaned_data = super().clean()
  28.         if not self.errors: # 判断前面的 clean_xxx 基本的校验是否有错误
  29.             password = cleaned_data["password"]
  30.             password2 = cleaned_data["password2"]
  31.             if password2 != password:
  32.                 raise forms.ValidationError("两次输入的密码不一致！")
  33.             return cleaned_data

2.1.2、写一个对应的视图函数

这个视图函数就是注册接口，简写（没有操作数据库）

  1. from django.http import JsonResponse, HttpResponse
  2. from . import forms
  4. # Create your views here.
  6. def new_register(request):
  7.     form = forms.RegisterForms(request.POST)
  8.     # 实例化form对象的时候，把post提交过来的数据直接传进去
  9.     # form表单的参数应该与forms组件的字段名称一致
  10.     if form.is_valid():
  11.         print(form.cleaned_data)
  12.         return JsonResponse({"code":0,"msg":"success!"})
  13.         # return HttpResponse("ok")
  14.     else:
  15.         print(form.errors.get_json_data())
  16.         return JsonResponse(form.errors.get_json_data())
  17.         # return HttpResponse("error")

注意：
在urls.py文件中绑定 路由和这个视图函数

image.pngimage.png

2.2、完善版本

2.2.1、完善后的forms.py

  1. import hashlib
  3. from django import forms
  4. from . import models
  7. class RegisterForms(forms.Form):
  8.     phone = forms.CharField(min_length=11, max_length=11)
  9.     email = forms.EmailField()
  10.     nick = forms.CharField()
  11.     password = forms.CharField(min_length=6,max_length=13)
  12.     password2 = forms.CharField(min_length=6,max_length=13)
  14.     def clean_phone(self):
  15.         phone = self.cleaned_data["phone"]
  16.         if not phone.isdigit():
  17.             raise forms.ValidationError("手机号格式错误~")
  18.         if models.NewUser.objects.filter(phone=phone).exists():
  19.             raise forms.ValidationError("手机号已存在！")
  20.         return phone
  22.     def clean_email(self):
  23.         email = self.cleaned_data["email"]
  24.         if models.NewUser.objects.filter(email=email).exists():
  25.             raise forms.ValidationError("邮箱已存在！")
  26.         return email
  28.     def clean(self):
  29.         cleaned_data = super().clean()
  30.         if not self.errors: # 判断前面的 clean_xxx 基本的校验是否有错误
  31.             password = cleaned_data["password"]
  32.             password2 = cleaned_data["password2"]
  33.             if password2 != password:
  34.                 raise forms.ValidationError("两次输入的密码不一致！")
  36.             # 数据加工
  37.             cleaned_data.pop("password2") # 将请求参数的 password2 删除，和数据库字段一致
  38.             cleaned_data["password"]=md5(cleaned_data["password"]) # 将这个明文密码加密
  40.             return cleaned_data # 返回处理好的请求参数
  43. def md5(password:str)->str:
  44.     """
  45.     用来将明文密码MD5加密
  46.     :param password: 密码明文
  47.     :return: MD5加密后的密码
  48.     """
  49.     md5_password = hashlib.md5(password.encode())
  50.     return md5_password.hexdigest()

2.2.2、完善后的注册接口

  1. from django.http import JsonResponse, HttpResponse
  2. from . import forms
  4. # Create your views here.
  6. def new_register(request):
  7.     form = forms.RegisterForms(request.POST)
  8.     # 实例化form对象的时候，把post提交过来的数据直接传进去
  9.     # form表单的参数应该与forms组件的字段名称一致
  10.     if form.is_valid():
  11.         print(form.cleaned_data)
  12.         models.NewUser.objects.create(**form.cleaned_data) 
  13.         #解包form的字典数据
  14.         # 要求form的字典数据 数量、key名称 和数据库要交互的表保持一致
  15.         return JsonResponse({"code":0,"msg":"success!"})
  16.         # return HttpResponse("ok")
  17.     else:
  18.         print(form.errors.get_json_data())
  19.         return JsonResponse(form.errors.get_json_data())
  20.         # return HttpResponse("error")

image.pngimage.png

参考博客

脚本之家：Django中的forms组件实例详解
https://www.jb51.net/article/150420.htm