1.form组件
功能一:校验数据:
1.用form组件实现简单的登陆校验功能,后端返回不符合校验规则的提示信息:
views.py:
def register(request):
error_dict = {'username': '', 'password': ''}
if request.method == 'POST':
username = request.POST.get('username')
password = request.POST.get('password')
print(username,password)
if username == 'jason':
error_dict['username'] = '用户名不能为jason'
if password == '123' or '123456':
error_dict['password'] = '密码过于简单,请重新输入'
return render(request,'register.html',locals())
reg99ister.html:
<body>
<form action="" method="post">
<p>username:
<input type="text" name="username">
<span style="color: red">{{ error_dict.username }}</span>
</p>
<p>password:
<input type="text" name="password">
<span style="color: red">{{ error_dict.password }}</span>
</p>
<p>
<input type="submit">
</p>
</form>
</body>
2.form组件校验用户数据:首先在views.py中产生一个类,定义好各个字段。
from django import forms
class MyForm(forms.Form):
username = forms.CharField(min_length=2,max_length=32)
age = forms.IntegerField(min_value=0,max_value=150)
email = forms.EmailField()
在test.py中测试数据:首先生成一个对象,在类的括号中传入数据。对象.is_valid()查看数据是否符合要求。
from app01 import views
form_obj = views.MyForm({'username':'max','age':25,'email':'[email protected]'})
print(form_obj.is_valid()) # True
3.对象.cleaned_data可以查看符合要求的数据,对象.errors可以查看不符合的数据以及
错误原因:
form_obj1 = views.MyForm({'username':'kevin','age':18,'email':'12345'})
print(form_obj1.is_valid()) # False
print(form_obj1.cleaned_data) # {'username': 'kevin', 'age': 18}
print(form_obj1.errors) # <ul class="errorlist"><li>email<ul class="errorlist"><li>Enter a valid email address.</li></ul></li></ul>
"""
1.默认所有字段必须传值。
2.多传的会忽略不做校验。
"""
2.forms组件渲染标签
之前我们在去前端获取用户输入都要用到form表单,今天我们提供一种新的方式:
1.forms组件渲染标签的方式1:在views写一个类,也就是一个表,在里面定义好字段名,在定义一个函数,用类产生一个对象,将该对象传到前端并且用对象名.as_p的方式即可:
views.py:
from django import forms
class MyForm(forms.Form):
'''label可以控制在页面上显示的名字,如果不设置默认显示字段名首字母大写'''
username = forms.CharField(max_length=5,min_length=2,label='姓名')
age = forms.IntegerField(max_value=150,min_value=0,label='年龄')
email = forms.EmailField(label='邮箱')
def ab_forms_func(request):
form_obj = MyForm()
return render(request,'formPage.html',locals())
formPage.html:
<body>
<p>用户注册</p>
{{ form_obj.as_p }}
</body>
"""
封装程度不高,扩展性差,主要用于本地测试
"""
2.依然是之前的用户对象,在前段.字段名.label就是字段名的别名,点字段名表示输入框:
<body>
<p>用户注册</p>
{# {{ form_obj.as_p }}#}
{{ form_obj.username.label }}
{{ form_obj.username }}
{{ form_obj.age.label }}
{{ form_obj.age }}
{{ form_obj.email.label }}
{# {{ form_obj.email }}#}
</body>
"""
扩展性高,但编写较为麻烦
"""
3.对form_obj进行for循环,在循环中分别格式化输出form.lable(别名)和form(输入框),推荐使用:
<body>
<p>用户注册</p>
{% for form in form_obj %}
<p>
{{ form.label }}
{{ form }}
</p>
{% endfor %}
</body>
"""
注意事项
forms组件之负责渲染获取用户数据的标签,也就意味着form标签与按钮都需要自己写。
前端的校验是弱不禁风的 最终都需要后端来校验 所以我们在使用forms组件的时候可以直接取消前端帮我们的校验:<form action="" novalidate>
"""
3.forms组件展示信息
1.对前端发来的信息进行校验,并且展示在前端:
前端form.errors.0:拿到标签中的错误信息
views.py:
from django import forms
class MyForm(forms.Form):
username = forms.CharField(max_length=5,min_length=2,label='姓名')
age = forms.IntegerField(max_value=150,min_value=0,label='年龄')
email = forms.EmailField(label='邮箱')
def ab_forms_func(request):
form_obj = MyForm()
if request.method == 'POST':
# print(request.POST) # <QueryDict: {'username': ['max'], 'age': ['25'], 'email': ['[email protected]'], '提交': ['提交']}>
'''MyForm()括号内需要填一个字典,正巧request.POST的到的结果就是一个字典,如果是post请求,将浏览器获取到的数据放入form_obj内,自动进行校验'''
form_obj = MyForm(request.POST)
return render(request,'formPage.html',locals())
formPage.html:
<body>
<p>用户注册</p>
{# 目前只要修改form表单中的method="post",就需要在settings中注掉csrf #}
<form action="" novalidate method="post">
{% for form in form_obj %}
<p>
{{ form.label }} # 展示标签
{{ form }} # 展示数据值
'''form.errors可以查看到错误信息,如果是get请求,form_obj是空对象,点不出结果。点0代表只拿标签中的文本'''
<span>{{ form.errors.0 }}</span> # 展示错误信息
</p>
{% endfor %}
<input type="submit" name="提交">
</form>
</body>
2.如果我们想让提示信息变成中文,并且编辑其内容:
2.1需要在类中用参数error_messages来编辑错误提示内容,编辑了之后如果哪一条未遵守就会提示相应的信息:
views.py:
from django import forms
class MyForm(forms.Form):
username = forms.CharField(max_length=5,min_length=2,label='姓名',error_messages={
'max_length':'姓名不能超过5个字符!',
'min_length': '姓名最少必须2个字符!',
'required': '姓名不能为空!'
})
age = forms.IntegerField(max_value=150,min_value=0,label='年龄',error_messages={
'max_value':'年龄范围超过最大值!',
'min_value':'年龄必须是正整数!',
'required': '年龄不能为空!' # 设置为空提醒
})
email = forms.EmailField(label='邮箱',error_messages={
'required': '邮箱不能为空!',
'invalid': '邮箱格式有误!' # 设置邮箱不合法提醒
})
def ab_forms_func(request):
form_obj = MyForm()
if request.method == 'POST':
form_obj = MyForm(request.POST)
return render(request,'formPage.html',locals())
formPage.html:
<body>
<p>用户注册</p>
{# 目前只要修改form表单中的method="post",就需要在settings中注掉csrf #}
<form action="" novalidate method="post">
{% for form in form_obj %}
<p>
{{ form.label }}
{{ form }}
<span style="color: red">{{ form.errors.0 }}</span>
</p>
{% endfor %}
<input type="submit" name="提交">
</form>
</body>
2.2在settings.py中导入模块:from django.conf import global_settings,ctrl+global_settings可以看到个国语言的简写,然后将LANGUAGE_CODE = 'en-us'改成其他语言简写,这样在页面中拿到的错误提示语言就是该国语言。
4.form组件校验补充
1.form针对字段数据的校验,提供了三种方式(可以一起使用):
1.直接写参数(max_length,min_value)
2.使用正则表达式:
在class中新加入一个字段:
phone = forms.CharField(label='电话' ,validators=[RegexValidator(r'^[0-9]+$', '请输入数字'), RegexValidator(r'^159[0-9]+$', '数字必须以159开头')],)
3.钩子函数(编写代码自定义校验):
2.钩子函数:是在前两部校验完成之后才会触发(钩子函数一定要定义在类中,是类中的方法,也是最后一道校验方式)。
局部钩子:每次只校验一个字段的数据(验证用户名是否已存在)
全局钩子:一次可以校验多个字段数据(校验两次密码输入是否一致)
2.1校验单个字段,函数需以clean_字段名命名,添加错误信息用self.add_error,返回值返回指定的字段名:
def clean_username(self):
'''拿到字段输入的名字'''
username = self.cleaned_data.get('username')
if username == 'jason':
'''返回错误信息'''
self.add_error('username','用户名jason已存在')
'''使用完要把变量名返回去'''
return username
2.2校验多个字段:函数以clean命名,添加错误信息用self.add_error,返回值返回所有的数据self.cleaned_data:
def clean(self):
password = self.cleaned_data.get('password')
confirm_pwd = self.cleaned_data.get('confirm_pwd')
if not password == confirm_pwd:
self.add_error('confirm_pwd', '两次密码输入不一致,请重新输入')
return self.cleaned_data
5.forms组件参数补充
min_length:最小长度
max_length:最大长度
min_value:最小值
min_value:最大值
label:自定义中文名
error_messgaes:自定义错误信息(键是字符串关键字,值是自定义提示)
validators:正则校验器
initial:给字段添加默认值
required=False:该信息允许为空;如果不填默认是required=True
widget:控制生成标签的各项属性
widget=forms.widgets.PasswordInput():密码按密文显示(需要提前导入模块:from django.forms import widgets,相当于form表单中的type='password')
widget=forms.widgets.TextInput():相当于form表单中的type='text'。
attrs={'class': 'form-control'}:添加第三方框架渲染的样式,要添加在widget=forms.widgets.TextInput()中的括号内。如果有多个类,中间用空格隔开:attrs={'class': 'form-control c1 c2'}
单选:
gender = forms.fields.ChoiceField(
choices=((1, "男"), (2, "女"), (3, "保密")),
label="性别",
initial=3,
widget=forms.widgets.RadioSelect()
)
单选下拉框:
hobby = forms.ChoiceField(
choices=((1, "篮球"), (2, "足球"), (3, "双色球"), ),
label="爱好",
initial=3,
widget=forms.widgets.Select()
)
多选下拉框:
hobby = forms.MultipleChoiceField(
choices=((1, "篮球"), (2, "足球"), (3, "双色球"), ),
label="爱好",
initial=[1, 3],
widget=forms.widgets.SelectMultiple()
)
单选checkbox:
keep = forms.ChoiceField(
label="是否记住密码",
initial="checked",
widget=forms.widgets.CheckboxInput()
)
多选checkbox:
hobby = forms.MultipleChoiceField(
choices=((1, "篮球"), (2, "足球"), (3, "双色球"),),
label="爱好",
initial=[1, 3],
widget=forms.widgets.CheckboxSelectMultiple()
)
6.Django所有内置字段
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类型
7.modelform组件
1.我们学习校验性组件的目的,绝大部分是为了数据录入数据库之前的各项审核,forms组件使用的时候需要对照模型类编写代码,不够方便。
2.modelform组件相较于form组件更强大。
from django import forms
from app01 import models
class MyModelForm(forms.ModelForm):
class Meta:
model = models.UserInfo
fields = '__all__'
labels = {
'username':'用户名'
}
def ab_mf_func(request):
modelform_obj = MyModelForm()
if request.method == 'POST':
modelform_obj = MyModelForm(request.POST,instance=User_obj)
if modelform_obj.is_valid():
modelform_obj.save() # models.UserInfo.objects.create(...)/update(...)
else:
print(modelform_obj.errors)
return render(request, 'modelFormPage.html', locals())
8.Django中间件
1.django有7个中间件,并且还支持用户自定义中间件。
2.当我们完成一些全局相关的功能(例如用户访问频率)、权限(中间件会获取到用户的权限以及访问的路由,并且查看该用户是否有该路由的权限)时需要用到中间件。
3.Django的中间件在settings中的MIDDLEWARE内。在中间件中我们发现中间件其实是一个类,但是多个类中都有两个相同的方法:process_request和process_response。
4.如何自定义中间件:
4.1在应用或者django项目下自定义个中间件
4.2参考自带中间件的代码编写并继承
4.3在类中编写五个可以自定义的方法:
需要掌握:
process_request
process_response
需要了解:
process_view
process_exception
process_template_response
5.中间件写好之后一定要在settings.py中的MIDDLEWARE中注册中间件才可以使用。
6.process_request:除了self还需一个参数request。请求来的时候会从上往下依次执行每一个注册了的中间件(类)中的process_request方法(函数)。没有该方法的中间件会依次跳过。MIDDLEWARE中中间件中排名越靠前,就限执行谁的该方法。
并且如果该方法返回了Httpresponse对象,那么就直接原路返回不再往后执行。
7.process_response:除了self还需两个参数request和response。请求走的时候会从下往上依次经过每一个中间件的该方法。response就是需要处理的数据。并且process_response方法还有返回值,返回值是response(也可以替换)。
8.如果在执行process_request方法的时候直接返回了HttpResponse对象,网络请求就不会再走下面的MyMiddleware2,而是直接走MyMiddleware1中的process_response,不再经过MyMiddleware2。