当前位置:Gxlcms > 数据库问题 > 二、Django创建数据库模型

二、Django创建数据库模型

时间:2021-07-01 10:21:17 帮助过:11人阅读

类型名称 类方法 widget 必填参数 数值型 int自增列 AutoField TextInput primary_key=True bigint自增列 BigAutoField TextInput primary_key=True 小整数(32768~32767) SmallIntegerField TextInput   正小整型(0~32767) PositiveSmallIntegerField TextInput   整数(-2147483648~2147483647) IntegerField TextInput   正整数(0~2147483647) PositiveIntegerField TextInput   长整型(-9223372036854775808~9223372036854775807) BigIntegerField TextInput   浮点型 FloatField TextInput   10进制小数 DecimalField TextInput

max_digits:

小数总长度
decimal_places:小数位长度

二进制类型 BinaryField TextInput   字符型 字符型 CharField TextInput max_length 文本类型 TextField Textarea   Email类型(字符串) EmailField TextInput   IP4&6类型(字符串) GenericIPAddressField TextInput   URL类型(字符型) URLField TextInput   字母、数字、下划线、连接符(减号) SlugField TextInput   逗号分割的数字 CommaSeparatedIntegerField TextInput max_length UUID类型(字符型) UUIDField TextInput   文件型 提供读取文件夹下文件 FilePathField CharField 

path

它是一个 CharField ,它用来选择文件系统下某个目录里面的某些文件。它有三个专有的参数,只有第一个参数是必须的:

path:

这个参数是必需的。它是一个目录的绝对路径,而这个目录就是 FilePathField 用来选择文件的那个目录。比如: "/home/images"。

match:

可选参数。它是一个正则表达式字符串, FilePathField 用它来过滤文件名称,只有符合条件的文件才出现在文件选择列表中。要注意正则表达式只匹配文件名,而不是匹配文件路径。

例如:"foo.*\.txt$" 只匹配名为foo23.txt 而不匹配 bar.txt 和 foo23.gif。

recursive:

可选参数。它的值是 True 或 False。默认值是 False。它指定是否包含 path 下的子目录。

allow_files:

该项属于Django1.5新增内容。可选参数,它的值是 True 或 False。默认值是 True。它指定是否包含指定位置的文件。该项与allow_folders 必须有一个是 True。

allow_folders:

Django1.5新增内容。可选参数,它的值是True或False。默认是False。它指定是否包含指定位置的目录。该项与allow_files必须有一个是 True。

前面已经提到了 match 只匹配文件名称,而不是文件路径。所以下面这个例子:

 

FilePathField(path="/home/images", match="foo.*", recursive=True)?

 

将匹配 /home/images/foo.gif ,而不匹配 /home/images/foo/bar.gif。这是因为 match 只匹配文件名(foo.gif 和 bar.gif)。

默认情况下, FilePathField 实例在数据库中的对应列是varchar(100) 。和其他字段一样,你可以利用 max_length 参数改变字段的最大长度。

文件上传到指定目录 FileField FileInput

upload_to

class FileField(upload_to=None[, max_length=100, **options])

Note:该字段不支持primary_key和unique 参数,否则会抛出TypeError 异常。

它有一个必须的参数:

upload_to:

用于保存文件的本地文件系统。它根据 MEDIA_ROOT 设置确定该文件的 url 属性。

该路径可以包含 时间格式串strftime(),可以在上传文件的时候替换成当时日期/时间(这样,就不会出现在上传文件把某个目录塞满的情况了)。

该参数也可以是一个可调用项,比如是一个函数,可以调用函数获得包含文件名的上传路径。这个可调用项必须要接受两个参数,并且返回一个保存文件用的 Unix-Style 的路径(用/斜杠)。两个参数分别是:

instance :定义了当前 FileField 的 model 实例。更准确地说,就是以该文件为附件的 model 实例。

大多数情况下,在保存该文件时, model 实例对象还并没有保存到数据库,这是因为它很有可能使用默认的 AutoField,而此时它还没有从数据库中获得主键值。

filename :上传文件的原始名称。在生成最终路径的时候,有可能会用到它。

还有一个可选的参数:

storage:

负责保存和获取文件的对象。

默认的form widget是FileInput。

Note:在 model 中使用 FileField 或 ImageField 要按照以下的步骤:

  1. 在项目settings文件中,你要定义 MEDIA_ROOT ,将它的值设为用来存放上传文件的目录的完整路径。(基于性能的考虑,Django 没有将文件保存在数据库中),然后定义 MEDIA_URL ,将它的值设为表示该目录的网址。要确保 web 服务器所用的帐号拥有对该目录的写权限。
  2. 在 model 里面添加 FileField 或 ImageField ,并且确认已定义了 upload_to 项,让 Django 知道应该用MEDIA_ROOT的哪个子目录来保存文件。
  3. 存储在数据库当中的仅仅只是文件的路径(而且是相对于 MEDIA_ROOT 的相对路径)。你可能已经想到利用Django 提供的 url 这个方便的属性。举个例子,如果你的 ImageField 名称是 mug_shot,那么你可以在模板中使用{{ object.mug_shot.url }}?就能得到图片的完整网址。

例如,假设你的 MEDIA_ROOT 被设为 ‘/home/media‘,upload_to 被设为 ‘photos/%Y/%m/%d‘。 upload_to 中的 ‘%Y/%m/%d‘ 是一个strftime(),‘%Y‘ 是四位的年份,‘%m‘ 是两位的月份,‘%d‘ 是两位的日子。如果你在2007年01月15号上传了一个文件,那么这个文件就保存在/home/media/photos/2007/01/15 目录下。

如果你想得到上传文件的本地文件名称,文件网址或是文件的大小,你可以使用 name, url 和 size 属性。

Note:在上传文件时,要警惕保存文件的位置和文件的类型,这么做的原因是为了避免安全漏洞。对每一个上传文件都要验证,这样你才能确保上传的文件是你想要的文件。举个例子,如果你盲目地让别人上传文件,而没有对上传文件进行验证,如果保存文件的目录处于 web 服务器的根目录下,万一有人上传了一个 CGI 或是 PHP脚本,然后通过访问脚本网址来运行上传的脚本,那可就太危险了。千万不要让这样的事情发生!默认情况下,FileField 实例在数据库中的对应列是 varchar(100) ,和其他字段一样,你可以利用max_length 参数改变字段的最大长度。

图片上传到指定目录 ImageField FileInput upload_to class ImageField(upload_to=None[, height_field=None, width_field=None, max_length=100,**options])和FileField一样,只是会验证上传对象是不是一个合法的图象文件。除了那些在FileField中有效的参数之外, ImageField 还可以使用 File.height and File.width 两个属性 。它有两个可选参数:height_field:保存图片高度的字段名称。在保存对象时,会根据该字段设定的高度,对图片文件进行缩放转换。width_field:保存图片宽度的字段名称。在保存对象时,会根据该字段设定的宽度,对图片文件进行缩放转换。默认情况下,ImageField 实例对应着数据库中的varchar(100) 列。和其他字段一样,你可以使用max_length 参数来改变字段的最大长度。 日期型 日期型 DateField TextInput

auto_now

auto_now_add

日期时间型 DateTimeField TextInput 同DateField 时间型 TimeField TextInput 同DateField 布尔 布尔型 BooleanField CheckboxInput   空布尔 NullBooleanField NullBooleanSelect  

参数说明:

参数名称 默认值 说明
null False 数据库中字段是否可以为空
blank   django的Admin中添加数据时是否可允许空值
primary_key  False 主键,设置后,就会代替原来的自增 id 列
auto_now    自动创建---无论添加或修改,都是当前操作的时间
auto_now_add   自动创建---永远是创建时的时间
choices   Admin中显示选择框的内容,用不变动的数据放在内存中从而避免跨表操作

代码如下:

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

  

default   长度
verbose_name   Admin中字段的显示名称
db_column   数据库中的字段名称
unique False 不允许重复
db_index  False 数据库索引
editable False 在Admin里是否可编辑
error_messages   自定义错误信息(字典类型),从而定制想要显示的错误信息;
字典健:null, blank, invalid, invalid_choice, unique, and unique_for_date
如:{‘null‘: "不能为空.", ‘invalid‘: ‘格式错误‘}
auto_created False 自动创建
help_text   在Admin中提示帮助信息
validators   自定义错误验证(列表类型),从而定制想要的验证规则
 
from django.core.validators import RegexValidator
from django.core.validators import EmailValidator,URLValidator,DecimalValidator,MaxLengthValidator,MinLengthValidator,MaxValueValidator,MinValueValidator
#举个声明的例子如下:
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‘), ]
) 
upload-to    文件上传路径

外键说明:

一对多:models.ForeignKey(其他表)

一对多:当一张表中创建一行数据时,有一个单选的下拉框(可以被重复选择)

例如:创建用户信息时候,需要选择一个用户类型【普通用户】【金牌用户】【铂金用户】等。

代码:

a=models.ForeignKey(to=‘TableName‘,to_field=‘id‘)

ForeignKey的参数:

参数名称 参数说明
to=None, 要进行关联的表名
to_field=None, 要关联的表中的字段名称
on_delete=None,

当删除关联表中的数据时,当前表与其关联的行的行为,内部可传递的变量有:

- models.CASCADE:删除关联数据,与之关联也删除
- models.DO_NOTHING:删除关联数据,引发错误IntegrityError
- models.PROTECT:删除关联数据,引发错误ProtectedError
- models.SET_NULL:删除关联数据,与之关联的值设置为null(前提FK字段需要设置为可空)
- models.SET_DEFAULT:删除关联数据,与之关联的值设置为默认值(前提FK字段需要设置默认值)
- models.SET:删除关联数据:

a. 与之关联的值设置为指定值,设置:models.SET(值)
b. 与之关联的值设置为可执行对象的返回值,设置:models.SET(可执行对象)

related_name=None, 反向操作时,使用的字段名,用于代替 【表名_set】
related_query_name=None, 反向操作时,使用的连接前缀,用于替换【表名】
limit_choices_to=None, 在Admin或ModelForm中显示关联数据时,提供的条件
db_constraint=True 是否在数据库中创建外键约束
parent_link=False 在Admin中是否显示关联数据

多对多:models.ManyToManyField(其他表)

多对多:在某表中创建一行数据是,有一个可以多选的下拉框

例如:创建用户信息,需要为用户指定多个爱好

ManyToManyField参数:

参数名称 参数说明

to=None

要进行关联的表名

related_name=None 反向操作时,使用的字段名,用于代替 【表名_set】 如: obj.表名_set.all()
related_query_name=None 反向操作时,使用的连接前缀,用于替换【表名】 如: models.UserGroup.objects.filter(表名__字段名=1).values(‘表名__字段名‘)
limit_choices_to=None

在Admin或ModelForm中显示关联数据时,提供的条件:
- limit_choices_to={‘nid__gt‘: 5}#
- limit_choices_to=lambda : {‘nid__gt‘: 5}

from django.db.models import Q
 - limit_choices_to=Q(nid__gt=10)
 - limit_choices_to=Q(nid=8) | Q(nid__gt=10)
 - limit_choices_to=lambda : Q(Q(nid=8) | Q(nid__gt=10)) & Q(caption=‘root‘)?
symmetrical=None 仅用于多对多自关联时,symmetrical用于指定内部是否创建反向操作的字段
through=None 自定义第三张表时,使用字段用于指定关系表
through_fields=None

自定义第三张表时,使用字段用于指定关系表中那些字段做多对多关系表:

from django.db import models
class Person(models.Model):
    name=models.CharField(max_length=50)
class Group(models.Model):
    name=models.CharField(max_length=128)
    members=models.ManyToManyField(
        Person,
        through=‘Membership‘,
        through_fields=(‘group‘, ‘person‘),
        )
class Membership(models.Model):
    group=models.ForeignKey(Group, on_delete=models.CASCADE)
    person = models.ForeignKey(Person,on_delete=models.CASCADE)
    inviter=models.ForeignKey(
        Person,
        on_delete=models.CASCADE,
        related_name="membership_invites",
        )
    invite_reason=models.CharField(max_length=64)?

  

db_constraint=True 是否在数据库中创建外键约束
db_table=None 默认创建第三张表时,数据库中表的名称

一对一:models.OneToOneField(其他表)

 

 

一对一:在某表中创建一行数据时,有一个单选的下拉框(下拉框中的内容被用过一次就消失了)

例如:原有含10列数据的一张表保存相关信息,经过一段时间之后,10列无法满足需求,需要为原来的表再添加5列数据

OneToOneField参数:

参数名称 参数说明
to 要进行关联的表名
to_field=None 要关联的表中的字段名称
on_delete=None 当删除关联表中的数据时,当前表与其关联的行的行为

 

 

二、Django创建数据库模型

标签:textarea   建模   布尔   datetime   执行   相关信息   设置   members   并且   

人气教程排行