码迷,mamicode.com
首页 > 其他好文 > 详细

4.model 字段

时间:2018-05-01 10:48:44      阅读:170      评论:0      收藏:0      [点我收藏+]

标签:obj   mes   需要   解析   rms   system   修改   例子   use   

   

一、字段名

   

字段名

类型

参数

AutoField(Field)

- int自增列,

必须填入参数 primary_key=True

BigAutoField(AutoField)

- bigint自增列

必须填入参数 primary_key=True

SmallIntegerField(IntegerField):

SmallIntegerField(IntegerField):

  

PositiveSmallIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)

- 正小整数 0 ~ 32767

  

IntegerField(Field)

- 整数列(有符号的) -2147483648 ~ 2147483647

  

PositiveIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)

- 正整数 0 ~ 2147483647

  

BigIntegerField(IntegerField):

- 长整型(有符号的) -9223372036854775808 ~ 9223372036854775807

  

BooleanField(Field)

- 布尔值类型

  

NullBooleanField(Field):

- 可以为空的布尔值

  

CharField(Field)

- 字符类型

- 必须提供max_length参数, max_length表示字符长度

TextField(Field)

- 文本类型

  

EmailField(CharField):

- 字符串类型,Django Admin以及ModelForm中提供验证机制

  

GenericIPAddressField(Field)

- 字符串类型,Django Admin以及ModelForm中提供验证 Ipv4和Ipv6

- 参数:

protocol,用于指定Ipv4或Ipv6, ‘both‘,"ipv4","ipv6" unpack_ipv4, 如果指定为True,则输入::ffff:192.0.2.1时候,可解析为192.0.2.1,

开启刺功能,需要protocol="both"

URLField(CharField)

- 字符串类型,Django Admin以及ModelForm中提供验证 URL

  

SlugField(CharField)

- 字符串类型,Django Admin以及ModelForm中提供验证支持 字母、数字、下划线、连接符(减号)

  

CommaSeparatedIntegerField(CharField)

- 字符串类型,格式必须为逗号分割的数字

  

UUIDField(Field)

- 字符串类型,Django Admin以及ModelForm中提供对UUID格式的验证

  

FilePathField(Field)

- 字符串,Django Admin以及ModelForm中提供读取文件夹下文件的功能

- 参数:

path, 文件夹路径 ,

match=None, 正则匹配

recursive=False, 递归下面的文件夹 allow_files=True, 允许文件 allow_folders=False, 允许文件夹

FileField(Field)

- 字符串,路径保存在数据库,文件上传到指定目录

- 参数:

upload_to = "" 上传文件的保存路径

storage = None 存储组件,默认django.core.files.storage.FileSystemStorage

ImageField(FileField)

- 字符串,路径保存在数据库,文件上传到指定目录

- 参数:

upload_to = "" 上传文件的保存路径

storage = None 存储组件,默认django.core.files.storage.FileSystemStorage width_field=None, 上传图片的高度保存的数据库字段名(字符串)

height_field=None 上传图片的宽度保存的数据库字段名(字符串)

DateTimeField(DateField)

- 日期+时间格式 YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ]

  

DateField(DateTimeCheckMixin, Field)

- 日期格式 YYYY-MM-DD

  

TimeField(DateTimeCheckMixin, Field)

- 时间格式 HH:MM[:ss[.uuuuuu]]

  

DurationField(Field)

- 长整数,时间间隔,数据库中按照bigint存储,ORM中获取的值为datetime.timedelta类型

  

FloatField(Field)

- 浮点型

  

DecimalField(Field)

- 10进制小数

- 参数:

max_digits,小数总长度

decimal_places,小数位长度

BinaryField(Field)

- 二进制类型

  

注:当model中如果没有自增列,则自动会创建一个列名为id的列,自增列必须为主键,因为mysql一张表中只能有一个自增列。英文详解如下:

   

‘AutoField‘

‘integer AUTO_INCREMENT‘,

‘BigAutoField‘

‘bigint AUTO_INCREMENT‘,

‘BinaryField‘

‘longblob‘,

‘BooleanField‘

‘bool‘,

‘CharField‘

‘varchar(%(max_length)s)‘,

‘CommaSeparatedIntegerField‘

‘varchar(%(max_length)s)‘,

‘DateField‘

‘date‘,

‘DateTimeField‘

‘datetime‘,

‘DecimalField‘

‘numeric(%(max_digits)s, %(decimal_places)s)‘,

‘DurationField‘

‘bigint‘,

‘FileField‘

‘varchar(%(max_length)s)‘,

‘FilePathField‘

‘varchar(%(max_length)s)‘,

‘FloatField‘

‘double precision‘,

‘IntegerField‘

‘integer‘,

‘BigIntegerField‘

‘bigint‘,

‘IPAddressField‘

‘char(15)‘,

‘GenericIPAddressField‘

‘char(39)‘,

‘NullBooleanField‘

‘bool‘,

‘OneToOneField‘

‘integer‘,

‘PositiveIntegerField‘

‘integer UNSIGNED‘,

‘PositiveSmallIntegerField‘

‘smallint UNSIGNED‘,

‘SlugField‘

‘varchar(%(max_length)s)‘,

‘SmallIntegerField‘

‘smallint‘,

‘TextField‘

‘longtext‘,

‘TimeField‘

‘time‘,

‘UUIDField‘

‘char(32)‘,

   

二、字段中常用参数

null 数据库中字段是否可以为空,注意和blank比较

db_column 数据库中字段的列名

db_tablespace

default 数据库中字段的默认值

primary_key 数据库中字段是否为主键

db_index 数据库中字段是否可以建立索引

unique 数据库中字段是否可以建立唯一索引

unique_for_date 数据库中字段【日期】部分是否可以建立唯一索引

unique_for_month 数据库中字段【月】部分是否可以建立唯一索引

unique_for_year 数据库中字段【年】部分是否可以建立唯一索引

verbose_name Admin中显示的字段名称

blank Admin中是否允许用户输入为空

editable Admin中是否可以编辑

help_text Admin中该字段的提示信息

choices Admin中显示选择框的内容,用不变动的数据放在内存中从而避免跨表操作

如:gf = models.IntegerField(choices=[(0, ‘何穗‘),(1, ‘大表姐‘),],default=1)

error_messages 自定义错误信息(字典类型),从而定制想要显示的错误信息;

字典健:null, blank, invalid, invalid_choice, unique, and unique_for_date

如:{‘null‘: "不能为空.", ‘invalid‘: ‘格式错误‘}

validators 自定义错误验证(列表类型),从而定制想要的验证规则

   

例子:

   

from django.core.validators import EmailValidator

from django.core.validators import RegexValidator

   

test = models.CharField(

        max_length=32,

        error_messages={

                ‘c1‘: 优先错信息1‘,

                ‘c2‘: 优先错信息2‘,

                ‘c3‘: 优先错信息3‘,

        },

        validators=[

                RegexValidator(regex=‘root_\d+‘, message=错误了, code=‘c1‘),

                RegexValidator(regex=‘root_112233\d+‘, message=又错误了, code=‘c2‘),

                EmailValidator(message=又错误了, code=‘c3‘), ])

   

三、Meta信息:

class Meta:

        # 数据库中生成的表名称 默认 app名称 + 下划线 + 类名

        db_table = "table_name"

        # 联合索引

        index_together = [("pub_date", "deadline"), ]

        # 联合唯一索引

        unique_together = (("driver", "restaurant"),)

        # admin中显示的表名称

        verbose_name = "用名信息"

        # verbose_namesadmin中复数形式

        verbose_name_plural = verbose_name

#定义排序规

ordering = "-object_id" #通过object_id做到许排序。

   

四、model字段格式检查

1、触发Model中的验证和错误提示

1Django Admin中的错误信息会优先根据Admin内部的ModelForm错误信息提示,如果都成功,才来检查Model的字段并显示指定错误信息

#model.py文件中

class UserInfo(models.Model):

        nid = models.AutoField(primary_key=True)

        username = models.CharField(max_length=32)

        email = models.EmailField(error_messages={‘invalid‘: 格式错了.‘})

这样就会提示格式错误

   

2)调用Model对象的 clean_fields 方法

# views.py

def index(request):

        obj = models.UserInfo(username=‘11234‘, email=‘uu‘)

        try:

                print(obj.clean_fields())

        except Exception as e:

                print(e)

        return HttpResponse(‘ok‘)

# Modelclean方法是一个钩子,可用于定制操作,如:上述的异常处理。

   

3Admin中修改错误提示,(也即是用django的form方法)

from django import forms

from django.contrib import admin

from model_club import models

   

class UserInfoForm(forms.ModelForm):

        username = forms.CharField(error_messages={‘required‘: 用户名不能为空.‘})

        email = forms.EmailField(error_messages={‘invalid‘: 邮箱格式错误.‘})

        age = forms.IntegerField(initial=1, error_messages={‘required‘: 请输入数值.‘, ‘invalid‘: 年龄必须为数值.‘})

   

        class Meta:

                model = models.UserInfo

                # fields = (‘username‘,)

                fields = "__all__"

   

class UserInfoAdmin(admin.ModelAdmin):

        form = UserInfoForm

   

admin.site.register(models.UserInfo, UserInfoAdmin)

   

   

   

   

   

   

4.model 字段

标签:obj   mes   需要   解析   rms   system   修改   例子   use   

原文地址:https://www.cnblogs.com/liuqianli/p/8975558.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!