Django基础篇：forms组件-钩子函数、字段参数、类型、源码分析，Modelform,cookie与session
2022.5.23 forms组件钩子函数及字段操作、cookie和session
- forms组件钩子函数
- forms组件字段参数
- forms组件字段类型
- forms组件源码分析
- ModelForm简介
- cookie与session简介
- django操作cookie
一、forms组件钩子函数
钩子函数的含义就是在程序的执行过程中穿插额外的逻辑；
只要在forms类中创建了某字段，那么就有对应的钩子函数，在django中是自动生成的:（def clean_字段名(self):...）
1、局部钩子
局部钩子，一个钩子函数只能操作一个字段名；
钩子函数是数据经过了字段第一层参数校验之后才会执行；
def clean_name(self): # 自动生成的函数名 专门用于对name字段添加额外的校验规则
# 1.先获取用户名
name = self.cleaned_data.get('name')
# 2.判断用户名是否已存在
is_exist = models.User.objects.filter(name=name)
if is_exist:
# 3.提示信息
self.add_error('name', '用户名已存在')
# 4.最后将你勾上来的name返回回去
return name
2、全局钩子
全局钩子，使用clean可以操作多个字段；
def clean(self):
# 1.获取多个字段数据
password = self.cleaned_data.get('password')
confirm_password = self.cleaned_data.get('confirm_password')
if not password == confirm_password:
self.add_error('confirm_password', '两次密码不一致 你个傻帽!!!')
# 最后将整个数据返回
return self.cleaned_data
二、forms组件字段参数
from django import forms
min_length 最小长度
max_length 最大长度
label 字段名称
error_messages 错误提示
min_value 最小值
max_value 最大值
initial 默认值
validators 正则校验器
# eg:
from django.core.validators import RegexValidator
phone = forms.CharField(
validators=[
RegexValidator(r'^[0-9]+$', '请输入数字'),
RegexValidator(r'^159[0-9]+$', '数字必须以159开头')],
)
widget 控制渲染出来的标签各项属性
# eg:
password = forms.CharField( widget=forms.widgets.PasswordInput(attrs={'class':'form-control'}) )
# forms.widgets.控制type的类型(attrs=控制各项属性:class id ...)
forms.widgets.PasswordInput() # 密码保护
forms.widgets.RadioSelect() # Radio
forms.widgets.Select() # 单选select
forms.widgets.SelectMultiple() # 多选select
forms.widgets.CheckboxInput() # 单选checkbox
forms.widgets.CheckboxSelectMultiple() # 多选checkbox
choices 选择类型的标签内部对应关系
可以直接编写 也可以从数据库中获取
# eg:
hobby = forms.MultipleChoiceField(
choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
)
def __init__(self, *args, **kwargs):
super(MyForm,self).__init__(*args, **kwargs)
self.fields['hobby'].choices = models.Classes.objects.all().values_list('id','caption')
三、forms组件字段类型
复制代码
Field
required=True, 是否允许为空
widget=None, HTML插件
label=None, 用于生成Label标签或显示内容
initial=None, 初始值
help_text='', 帮助信息(在标签旁边显示)
error_messages=None, 错误信息 {'required': '不能为空', 'invalid': '格式错误'}
validators=[], 自定义验证规则
localize=False, 是否支持本地化
disabled=False, 是否可以编辑
label_suffix=None Label内容后缀
CharField(Field)
max_length=None, 最大长度
min_length=None, 最小长度
strip=True 是否移除用户输入空白
IntegerField(Field)
max_value=None, 最大值
min_value=None, 最小值
FloatField(IntegerField)
...
DecimalField(IntegerField)
max_value=None, 最大值
min_value=None, 最小值
max_digits=None, 总长度
decimal_places=None, 小数位长度
BaseTemporalField(Field)
input_formats=None 时间格式化
DateField(BaseTemporalField) 格式：2015-09-01
TimeField(BaseTemporalField) 格式：11:12
DateTimeField(BaseTemporalField)格式：2015-09-01 11:12
DurationField(Field) 时间间隔：%d %H:%M:%S.%f
...
RegexField(CharField)
regex, 自定制正则表达式
max_length=None, 最大长度
min_length=None, 最小长度
error_message=None, 忽略，错误信息使用 error_messages={'invalid': '...'}
EmailField(CharField)
...
FileField(Field)
allow_empty_file=False 是否允许空文件
ImageField(FileField)
...
注：需要PIL模块，pip3 install Pillow
以上两个字典使用时，需要注意两点：
- form表单中 enctype="multipart/form-data"
- view函数中 obj = MyForm(request.POST, request.FILES)
URLField(Field)
...
BooleanField(Field)
...
NullBooleanField(BooleanField)
...
ChoiceField(Field)
...
choices=(), 选项，如：choices = ((0,'上海'),(1,'北京'),)
required=True, 是否必填
widget=None, 插件，默认select插件
label=None, Label内容
initial=None, 初始值
help_text='', 帮助提示
ModelChoiceField(ChoiceField)
... django.forms.models.ModelChoiceField
queryset, # 查询数据库中的数据
empty_label="---------", # 默认空显示内容
to_field_name=None, # HTML中value的值对应的字段
limit_choices_to=None # ModelForm中对queryset二次筛选
ModelMultipleChoiceField(ModelChoiceField)
... django.forms.models.ModelMultipleChoiceField
TypedChoiceField(ChoiceField)
coerce = lambda val: val 对选中的值进行一次转换
empty_value= '' 空值的默认值
MultipleChoiceField(ChoiceField)
...
TypedMultipleChoiceField(MultipleChoiceField)
coerce = lambda val: val 对选中的每一个值进行一次转换
empty_value= '' 空值的默认值
ComboField(Field)
fields=() 使用多个验证，如下：即验证最大长度20，又验证邮箱格式
fields.ComboField(fields=[fields.CharField(max_length=20), fields.EmailField(),])
MultiValueField(Field)
PS: 抽象类，子类中可以实现聚合多个字典去匹配一个值，要配合MultiWidget使用
SplitDateTimeField(MultiValueField)
input_date_formats=None, 格式列表：['%Y--%m--%d', '%m%d/%Y', '%m/%d/%y']
input_time_formats=None 格式列表：['%H:%M:%S', '%H:%M:%S.%f', '%H:%M']
FilePathField(ChoiceField) 文件选项，目录下文件显示在页面中
path, 文件夹路径
match=None, 正则匹配
recursive=False, 递归下面的文件夹
allow_files=True, 允许文件
allow_folders=False, 允许文件夹
required=True,
widget=None,
label=None,
initial=None,
help_text=''
GenericIPAddressField
protocol='both', both,ipv4,ipv6支持的IP格式
unpack_ipv4=False 解析ipv4地址，如果是::ffff:192.0.2.1时候，可解析为192.0.2.1， PS：protocol必须为both才能启用
SlugField(CharField) 数字，字母，下划线，减号（连字符）
...
UUIDField(CharField) uuid类型
四、forms组件源码分析
"""
看源码可以提升编程能力(CBV源码)
也可以从中获取出更多的使用方式(JsonResponse)
"""
1.从is_valid入手
def is_valid(self):
return self.is_bound and not self.errors
# 查看类源码发现只要给类传参self.is_bound肯定是True
2.查看errors
@property
def errors(self):
if self._errors is None:
self.full_clean()
return self._errors
# 查看了源码发现self._errors初始化就是None 所以肯定走full_clean方法
3.查看full_clean
def full_clean(self):
self._errors = ErrorDict()
if not self.is_bound:
return
self.cleaned_data = {}
if self.empty_permitted and not self.has_changed():
return
self._clean_fields()
self._clean_form()
self._post_clean()
4.查看clean_fields
try:
if isinstance(field, FileField):
initial = self.get_initial_for_field(field, name)
value = field.clean(value, initial)
else:
value = field.clean(value)
self.cleaned_data[name] = value
if hasattr(self, 'clean_%s' % name):
value = getattr(self, 'clean_%s' % name)()
self.cleaned_data[name] = value
except ValidationError as e:
self.add_error(name, e)
# 查看源码发现校验数据的整个过程内部都有异常处理机制
所以可以利用这个异常处理在后端代码中设置主动报什么错：
is_exist = models.User.objects.filter(name=name)
if is_exist:
from django.core.exceptions import ValidationError
raise ValidationError('用户名不存在 你个DSB')
五、ModelForm简介
forms组件主要配合主要配合models里面的默写类一起使用，但是默写类里面的字段需要在forms类中相当于重写一遍，代码冗余；
因此为了更好的结合forms与models的关系，有了一个ModelForm（基于forms组件），封装程度更高；
# 编写ModelForm类
class MyUser(forms.ModelForm):
class Meta:
model = models.User # 指定关联的表
fields = '__all__' # 所有的字段全部生成对应的forms字段
labels = {
'name': '用户名',
'age': '年龄',
'addr': '地址',
'email': '邮箱'
}
widgets = {
"name": forms.widgets.TextInput(attrs={"class": "form-control"}),
}
# 使用ModelForm
def reg(request):
form_obj = MyUser()
if request.method == 'POST':
form_obj = MyUser(request.POST)
if form_obj.is_valid():
# form_obj.save() # 新增数据
edit_obj = models.User.objects.filter(pk=5).first()
form_obj = MyUser(request.POST, instance=edit_obj) # 是新增还是保存就取决于有没有instance参数：instance=要修改的对象
form_obj.save() # 编辑数据
return render(request, 'reg.html', locals())
六、cookie与session简介
# cookie简介
早期的互联网应用程序都是不保存用户状态的,所有人发送请求返回的都是相同的页面;
现如今几乎所有的应用程序都可以保存用户状态!!!>>>:如何实现的???
HTTP协议四大特性之一:无状态
让服务端知道你是谁的方式很单一>>>:携带用户名和密码(身份标识);
每次操作之前都需要输入用户名和密码
当你成功登录之后浏览器会在本地帮你保存用户名和密码;
每次操作浏览器自动发送用户名和密码
cookie本质
指代服务端让客户端保存的数据(存储在客户端上与用户信息相关的数据);
'''简单的记忆:cookie就是存在客户端的东西'''
# session简介
早期的cookie是直接存储的用户明文相关信息,不安全;
用户登录成功之后,服务端生成一个随机字符串,返回给客户端保存;
之后客户端每次发请求携带该随机字符串,服务端获取之后比对后台数据;
eg:
服务端
随机字符串1 用户数据1
随机字符串2 用户数据2
随机字符串3 用户数据3
客户端
随机字符串1、随机字符串2、随机字符串3
session本质
指代服务端保存的跟用户信息相关的数据
'''简单的记忆:session就是存在服务端的东西'''
"""
1.session的工作必须依赖于cookie
2.客户端也有权拒绝保存数据
"""
ps:针对身份标识问题有很多方式 cookie和session是最基本的
token、jwt...
七、django操作cookie
# 视图函数返回值
return HttpResonse()
return render()
return redirect()
...
不直接返回对象 而是先用变量名指代 然后操作对象方法
res = HttpResonse()
return res
res = render()
return res
res = redirect()
return res
# 基本使用
res.set_cookie() # 设置
res.COOKIE.get() # 获取
# 有很多视图函数需要添加登录认证，有时候又需要取消登录认证，怎么做？
装饰器
def login_auth(func_name):
def inner(request, *args, **kwargs):
if request.COOKIES.get('name'):
res = func_name(request, *args, **kwargs)
return res
else:
return redirect('/login/')
return inner
@login_auth
def home(request):
# if request.COOKIES.get('name'):
# return HttpResponse("只有登录的用户才可以查看home页面")
# return redirect('/login/')
return HttpResponse("只有登录的用户才可以查看home页面")
@login_auth
def index(request):
# if request.COOKIES.get('name'):
# return HttpResponse("只有登录的用户才可以查看index页面")
# return redirect('/login/')
return HttpResponse("只有登录的用户才可以查看index页面")
@login_auth
def func(request):
# if request.COOKIES.get('name'):
# return HttpResponse("只有登录的用户才可以查看func页面")
# return redirect('/login/')
return HttpResponse("只有登录的用户才可以查看func页面")
浙公网安备 33010602011771号