django--forms

时间  2019-11-14
标签 django forms 栏目 Python 繁體版
原文   原文链接

forms模块的功能

　　1 表单提交验证前端

　　2 生成HTML标签python

　　其余git

　　提交后保留页面数据正则表达式

建立forms类

　　首先从django中引入forms，通常会在application中新建一个文件专门保存form类，由于每个表的验证都须要一个独特的forms。数据库

class SubY(forms.Form):
            user=forms.CharField(min_length=6,error_messages=error_ms,widget=forms.TextInput(attrs={"class":"c1","placeholder":"用户名"}))
    email = forms.EmailField(error_messages=error_ms)
    shengfen = forms.ChoiceField(choices=[(1,"gaga"),(2,"gaga2")])

　　注意：1 这里的forms字段只能比其相关联models多不能少django

　　　　　2 三者的字段的名字必须一致。model中，HTML中的name属性值，和forms字段。json

　　验证的使用

 1 def send_email(request):
 2     email = request.POST.get("email")
 3     obj_forms = SubY_send_email(request.POST)
 4     error_info = ReturnInfo()
 5     time_now = datetime.datetime.now()
 6     # print(time_now)
 7     # print(datetime.datetime.now()) # 即便这个时间存在django数据库中会变成UTC时间，
 8     # 由于django收到的指令是按本身的默认utc时间保存的。
 9     if obj_forms.is_valid():
10         if models.UserMain.objects.filter(email=email).exists():
11             error_info.status_exist = False
12             error_info.error_general = "该邮箱已经被注册"
13             return HttpResponse(json.dumps(error_info.__dict__))
14         else:
15             try:
16                 obj_email = models.EmailSend_limit.objects.get(email_addr=email)
17             except Exception as e:
18                 models.EmailSend_limit.objects.create(
19                     email_addr=email,
20                     time_last=datetime.datetime.now(),   #  如果在这里使用now
21                     # 就使得这个字段bond上了timezone信息，
22                     # 再次进行更新的时候，如果没有tz信息会出现警告并转换成当初设定的时候的时间
23                     # RuntimeWarning: DateTimeField EmailSend_limit.time_last received
24                     # a naive datetime (2016-12-23 03:03:48.530491) while time zone support is active.进入数据库时变成了22号
25                     time_first=datetime.datetime.now(),
26                     num_send=1
27                 )
28                 createEmailTemp(email)
29                 error_info.error_general = "邮件已发送"
30                 return HttpResponse(json.dumps(error_info.__dict__))
31             else:
32                 time_first = obj_email.time_first
33                 time_last = obj_email.time_last
34                 time_Hour = time_now - datetime.timedelta(hours=1)
35                 time_first = time_first.replace(tzinfo=None)# time zone info 或者tzinfo=UTC()
36                 # 保存到django中时间会被django加上一个时区信息，而datatime生成的是没时区信息的时间。
37                 if time_Hour >= time_first:   # 取出的时间是off-aware不能跟now的时间off-naive比较
38                     obj_email.time_last = datetime.datetime.now()
39                     obj_email.time_first = datetime.datetime.now()
40                     obj_email.num_send = 1
41                     obj_email.save()
42                     createEmailTemp(email)
43                     error_info.error_general = "邮件已发送"
44                     return HttpResponse(json.dumps(error_info.__dict__))
45                 else:
46                     time_last = time_last.replace(tzinfo=None)
47                     if (time_now - datetime.timedelta(minutes=1)) < time_last or obj_email.num_send > 10:
48                         error_info.time_limit = False
49                         error_info.error_general = "操做太频繁，请一小时后重试"
50                         return HttpResponse(json.dumps(error_info.__dict__))
51                     else:
52                         createEmailTemp(email)
53                         obj_email.num_send += 1
54                         time_l = datetime.datetime.now().replace(tzinfo=None)
55                         obj_email.time_last = time_l
56                         print(time_l)
57                         obj_email.save()
58                         error_info.error_general = "邮件已发送"
59                         return HttpResponse(json.dumps(error_info.__dict__))
60     else:
61         error_info.status = False
62         error_info.error_detail = obj_forms.errors.as_data()
63         return HttpResponse(json.dumps(error_info.__dict__,cls=JsonCustomEncoder))

　　　　上述代码中，第三行建立了一个forms类。而且直接将POST传入到了obj中。对应的forms类：app

class SubY_send_email(forms.Form):
    email = forms.EmailField(error_messages=error_ms)

　　　　当调用第九行is_valid()方法的时候，此时forms类验证完毕而且返回一个布尔值。ide

　　　　obj.clean()返回给验证正确的字段。函数

　　　　obj.errors没有括号返回给错误信息。

　　　　　　eroors后接有as_data()：

{'user': [ValidationError(['不能为空'])], 'email': [ValidationError(['不能为空'])]}

　　　　　　能够看到data类型中返回有错误字段名称，错误类，和自定义的错误信息。可是在传导前端的时候使用json的dumps方法，ValidationError 不是py基本类型 不                        能json。因此建立一个自定义的json来处理：

class JsonCustomEncoder(json.JSONEncoder):
    def default(self,field):
        if isinstance(field, ValidationError):
            return {field.code:field.message}
        else:
            return json.JSONEncoder.default(self,field)
#  上面的函数保证了 在json的过程当中 遇到ValidationError错误是进行这个类来解释
JsonCustomEncoder

　　　　　　as_json()：返回的是json的字符串。直接dumps回去就成。

　　　　　　as_text()：返回成列表的text。不经常使用，默认。

forms类中的字段和插件

　　字段和其中参数：

Field
    required=True,               是否容许为空
    widget=None,                 HTML插件
    label=None,                  用于生成Label标签或显示内容
    initial=None,                初始值
    help_text='',                帮助信息(在标签旁边显示)
    error_messages=None,         错误信息 {'required': '不能为空', 'invalid': '格式错误'}
    show_hidden_initial=False,   是否在当前插件后面再加一个隐藏的且具备默认值的插件（可用于检验两次输入是否一直）
    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类型
    ...
View Code

　　插件

　　插件用于在模块语言中直接生成对应的HTML标签。

TextInput(Input)
NumberInput(TextInput)
EmailInput(TextInput)
URLInput(TextInput)
PasswordInput(TextInput)
HiddenInput(TextInput)
Textarea(Widget)
DateInput(DateTimeBaseInput)
DateTimeInput(DateTimeBaseInput)
TimeInput(DateTimeBaseInput)
CheckboxInput
Select
NullBooleanSelect
SelectMultiple
RadioSelect
CheckboxSelectMultiple
FileInput
ClearableFileInput
MultipleHiddenInput
SplitDateTimeWidget
SplitHiddenDateTimeWidget
SelectDateWidget
View Code

　　

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
# 单radio，值为字符串
# user = fields.CharField(
#     initial=2,
#     widget=widgets.RadioSelect(choices=((1,'上海'),(2,'北京'),))
# )
 
# 单radio，值为字符串
# user = fields.ChoiceField(
#     choices=((1, '上海'), (2, '北京'),),
#     initial=2,
#     widget=widgets.RadioSelect
# )
 
# 单select，值为字符串
# user = fields.CharField(
#     initial=2,
#     widget=widgets.Select(choices=((1,'上海'),(2,'北京'),))
# )
 
# 单select，值为字符串
# user = fields.ChoiceField(
#     choices=((1, '上海'), (2, '北京'),),
#     initial=2,
#     widget=widgets.Select
# )
 
# 多选select，值为列表
# user = fields.MultipleChoiceField(
#     choices=((1,'上海'),(2,'北京'),),
#     initial=[1,],
#     widget=widgets.SelectMultiple
# )
 
 
# 单checkbox
# user = fields.CharField(
#     widget=widgets.CheckboxInput()
# )
 
 
# 多选checkbox,值为列表
# user = fields.MultipleChoiceField(
#     initial=[2, ],
#     choices=((1, '上海'), (2, '北京'),),
#     widget=widgets.CheckboxSelectMultiple
# )

在使用选择标签时，须要注意choices的选项能够从数据库中获取，可是因为是静态字段 ***获取的值没法实时更新***，那么须要自定义构造方法从而达到此目的。

方式一：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
from  django.forms  import  Form
from  django.forms  import  widgets
from  django.forms  import  fields
from  django.core.validators  import  RegexValidator
 
class  MyForm(Form):
 
     user  =  fields.ChoiceField(
         # choices=((1, '上海'), (2, '北京'),),
         initial = 2 ,
         widget = widgets.Select
     )
 
     def  __init__( self ,  * args,  * * kwargs):
         super (MyForm, self ).__init__( * args,  * * kwargs)
         # self.fields['user'].widget.choices = ((1, '上海'), (2, '北京'),)
         # 或
         self .fields[ 'user' ].widget.choices  =  models.Classes.objects. all ().value_list( 'id' , 'caption' )

方式二：

使用django提供的ModelChoiceField和ModelMultipleChoiceField字段来实现

1
2
3
4
5
6
7
8
9
10
from  django  import  forms
from  django.forms  import  fields
from  django.forms  import  widgets
from  django.forms  import  models as form_model
from  django.core.exceptions  import  ValidationError
from  django.core.validators  import  RegexValidator
 
class  FInfo(forms.Form):
     authors  =  form_model.ModelMultipleChoiceField(queryset = models.NNewType.objects. all ())
     # authors = form_model.ModelChoiceField(queryset=models.NNewType.objects.all())

　　自定义验证规则

方式一：

1
2
3
4
5
6
7
8
9
from  django.forms  import  Form
from  django.forms  import  widgets
from  django.forms  import  fields
from  django.core.validators  import  RegexValidator
 
class  MyForm(Form):
     user  =  fields.CharField(
         validators = [RegexValidator(r '^[0-9]+$' ,  '请输入数字' ), RegexValidator(r '^159[0-9]+$' ,  '数字必须以159开头' )],
     )

方式二：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
import  re
from  django.forms  import  Form
from  django.forms  import  widgets
from  django.forms  import  fields
from  django.core.exceptions  import  ValidationError
 
 
# 自定义验证规则
def  mobile_validate(value):
     mobile_re  =  re. compile (r '^(13[0-9]|15[012356789]|17[678]|18[0-9]|14[57])[0-9]{8}$' )
     if  not  mobile_re.match(value):
         raise  ValidationError( '手机号码格式错误' )
 
 
class  PublishForm(Form):
 
 
     title  =  fields.CharField(max_length = 20 ,
                             min_length = 5 ,
                             error_messages = { 'required' :  '标题不能为空' ,
                                             'min_length' :  '标题最少为5个字符' ,
                                             'max_length' :  '标题最多为20个字符' },
                             widget = widgets.TextInput(attrs = { 'class' :  "form-control" ,
                                                           'placeholder' :  '标题5-20个字符' }))
 
 
     # 使用自定义验证规则
     phone  =  fields.CharField(validators = [mobile_validate, ],
                             error_messages = { 'required' :  '手机不能为空' },
                             widget = widgets.TextInput(attrs = { 'class' :  "form-control" ,
                                                           'placeholder' : u '手机号码' }))
 
     email  =  fields.EmailField(required = False ,
                             error_messages = { 'required' : u '邮箱不能为空' , 'invalid' : u '邮箱格式错误' },
                             widget = widgets.TextInput(attrs = { 'class' :  "form-control" ,  'placeholder' : u '邮箱' }))

方法三：自定义方法

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
from  django  import  forms
     from  django.forms  import  fields
     from  django.forms  import  widgets
     from  django.core.exceptions  import  ValidationError
     from  django.core.validators  import  RegexValidator
 
     class  FInfo(forms.Form):
         username  =  fields.CharField(max_length = 5 ,
                                     validators = [RegexValidator(r '^[0-9]+$' ,  'Enter a valid extension.' ,  'invalid' )], )
         email  =  fields.EmailField()
 
         def  clean_username( self ):
             """
             Form中字段中定义的格式匹配完以后，执行此方法进行验证
             :return:
             """
             value  =  self .cleaned_data[ 'username' ]
             if  "666"  in  value:
                 raise  ValidationError( '666已经被玩烂了...' ,  'invalid' )
             return  value

方式四：同时生成多个标签进行验证

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
from  django.forms  import  Form
from  django.forms  import  widgets
from  django.forms  import  fields
 
from  django.core.validators  import  RegexValidator
 
 
############## 自定义字段 ##############
class  PhoneField(fields.MultiValueField):
     def  __init__( self ,  * args,  * * kwargs):
         # Define one message for all fields.
         error_messages  =  {
             'incomplete' :  'Enter a country calling code and a phone number.' ,
         }
         # Or define a different message for each field.
         f  =  (
             fields.CharField(
                 error_messages = { 'incomplete' :  'Enter a country calling code.' },
                 validators = [
                     RegexValidator(r '^[0-9]+$' ,  'Enter a valid country calling code.' ),
                 ],
             ),
             fields.CharField(
                 error_messages = { 'incomplete' :  'Enter a phone number.' },
                 validators = [RegexValidator(r '^[0-9]+$' ,  'Enter a valid phone number.' )],
             ),
             fields.CharField(
                 validators = [RegexValidator(r '^[0-9]+$' ,  'Enter a valid extension.' )],
                 required = False ,
             ),
         )
         super (PhoneField,  self ).__init__(error_messages = error_messages, fields = f, require_all_fields = False ,  * args,
                                          * * kwargs)
 
     def  compress( self , data_list):
         """
         当用户验证都经过后，该值返回给用户
         :param data_list:
         :return:
         """
         return  data_list
 
############## 自定义插件 ##############
class  SplitPhoneWidget(widgets.MultiWidget):
     def  __init__( self ):
         ws  =  (
             widgets.TextInput(),
             widgets.TextInput(),
             widgets.TextInput(),
         )
         super (SplitPhoneWidget,  self ).__init__(ws)
 
     def  decompress( self , value):
         """
         处理初始值，当初始值initial不是列表时，调用该方法
         :param value:
         :return:
         """
         if  value:
             return  value.split( ',' )
         return  [ None ,  None ,  None ]
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程