模型是你的数据的唯一的、权威的信息源。它包含你所储存数据的必要字段和行为。通常,每个模型对应数据库中唯一的一张表。
- 每个模型都是django.db.models.Model的一个Python 子类。
- 模型的每个属性都表示为数据库中的一个字段。
- Django 提供一套自动生成的用于数据库访问的API。
定义一个模型
定义一个模型会在MySQL中创建一个表,他的属性相当于数据库中的字段,每一个属性都映射到一个数据库中的一列
下面定义一个,book的模型,他有title,price,data,publish,author这5个属性
在Django的model下:
from django.db import models
# Create your models here.
class Book(models.Model):
title = models.CharField(max_length=32)
price = models.IntegerField()
date = models.DateField()
publish = models.CharField(max_length=32)
author = models.CharField(max_length=32)
以上book模型会在数据库中生成一张book表,相当于mysql的如下语句
CREATE TABLE myapp_person (
"id" serial NOT NULL PRIMARY KEY,
"title" varchar(32) NOT NULL,
...
"author" varchar(32) NOT NULL
);
注意事项:
- 这个表的名称为book,是根据模型自动生成的
- id字段是自动添加的,但这个可以被重写
- Django 会根据设置文件中指定的数据库类型来使用相应的SQL 语句。
使用模型
以上定义好模型之后,就是告诉Django使用模型了
- 你要做的就是修改配置文件中的INSTALLED_APPS 设置,在其中添加models.py所在应用的名称
- 使用python3 manage.py makemigrations给应用生成迁移脚本。
- 运行命令python3 manage.py migrate
字段
对于一个模型来说,最重要的和不可或缺的是列出该模型在数据库中定义的字段。字段由fields类属性指定。要注意选择的字段名称不要和模型 API 冲突,比如clean、save 或者delete。
字段类型
模型中的每个字段都是 Field子类的某个实例。
title = models.CharField(max_length=32) # 字符串
price = models.IntegerField() # 整数
date = models.DateField() # 时间
字段选项
每个字段有一些特有的参数,详见模型字段参考。例如,CharField(和它的派生类)需要max_length参数来指定VARCHAR` 数据库字段的大小。
还有一些适用于所有字段的通用参数。这里我们只简单介绍一些最常用的:
- null:如果为True,Django 将会把数据库中空值保存为NULL。默认值是 False.
- blank:如果为True,该字段允许为空值,默认为False。
要注意,这与 null不同。null纯粹是数据库范畴,指数据库中字段内容是否允许为空,而 blank是表单数据输入验证范畴的。如果一个字段的blank=True,表单的验证将允许输入一个空值。如果字段的blank=False`,该字段就是必填的。 - default:字段的默认值。可以是一个值或者可调用对象。如果可调用 ,每个新对象被创建它都会被调用。
- help_text:表单部件额外显示的帮助内容。即使字段不在表单中使用,它对生成文档也很有用。
- primary_key:如果为True,那么这个字段就是模型的主键。如果任何字段都没有设置主键,那么Django会自动生成一个id的主键
- unique:如果该值设置为 True, 这个数据字段在整张表中必须是唯一的
自增主键
默认情况下,Django 会给每个模型添加下面这个字段:
id = models.AutoField(primary_key=True)
这是一个自增主键字段。
如果你想指定一个自定义主键字段,只要在某个字段上指定 primary_key=True 即可。如果 Django 看到你显式地设置了 Field.primary_key,就不会自动添加 id 列。
每个模型只能有一个字段指定primary_key=True(无论是显式声明还是自动添加)。
关系
显然,关系数据库的威力体现在表之间的相互关联。 Django 提供了三种最常见的数据库关系:多对一(many-to-one),多对多(many-to-many),一对一(one-to-one)。
多对一关系
Django 使用 django.db.models.ForeignKey 定义多对一关系。和使用其它字段类型一样:在模型当中把它做为一个类属性包含进来。
比如制造商和汽车的关系,一个汽车只能对应一个制造商,而一个只造成能造很多汽车
from django.db import models
class Manufacturer(models.Model):
# ...
pass
class Car(models.Model):
manufacturer = models.ForeignKey(Manufacturer)
# ...
多对多关系
Django使用ManyToManyField来定义多对多关系,用法和其他Field字段类型一样:在模型中做为一个类属性包含进来。
比如一个披萨可以有多重馅,一种馅料也可以位于多个披萨上,如下
from django.db import models
class Topping(models.Model):
# ...
pass
class Pizza(models.Model):
# ...
toppings = models.ManyToManyField(Topping)
使用上述语句他会自动创建第三张表来存放两者之间的关系
你也可以自己手动创建一张表
一般情况下,我们定义多对多的关系,是专门新建一个中介模型。但是,建立这种模型要在源模型上增加一个through参数指向中介模型
比如我们定义一个记录音乐家和音乐小组的应用,一个音乐小组可以有多个音乐家,一个音乐家也可以参加多个音乐小组
from django.db import models
class Person(models.Model):
name = models.CharField(max_length=128)
def __str__(self): # __unicode__ on Python 2
return self.name
class Group(models.Model):
name = models.CharField(max_length=128)
members = models.ManyToManyField(Person, through='Membership')
def __str__(self): # __unicode__ on Python 2
return self.name
class Membership(models.Model):
person = models.ForeignKey(Person)
group = models.ForeignKey(Group)
date_joined = models.DateField() # 也可以在中介模型中添加其他字段
invite_reason = models.CharField(max_length=64)
创建每一行数据
实例化每一行数据有两种方法,一种是create,还有一种方法是直接实例化,然后save()
既然你已经设置好ManyToManyField 来使用中介模型(在这个例子中就是Membership),接下来你要开始创建多对多关系。你要做的就是创建中介模型的实例:
>>> ringo = Person.objects.create(name="Ringo Starr")
>>> paul = Person.objects.create(name="Paul McCartney")
>>> beatles = Group.objects.create(name="The Beatles")
>>> m1 = Membership(person=ringo, group=beatles,
... date_joined=date(1962, 8, 16),
... invite_reason="Needed a new drummer.")
>>> m1.save()
>>> beatles.members.all()
[<Person: Ringo Starr>]
>>> ringo.group_set.all()
[<Group: The Beatles>]
>>> m2 = Membership.objects.create(person=paul, group=beatles,
... date_joined=date(1960, 8, 1),
... invite_reason="Wanted to form a band.")
>>> beatles.members.all()
[<Person: Ringo Starr>, <Person: Paul McCartney>]
创建多对多关系
>>> ringo = Person.objects.create(name="Ringo Starr")
>>> paul = Person.objects.create(name="Paul McCartney")
>>> beatles = Group.objects.create(name="The Beatles")
>>> Group.members.add(ringo, paul)
与普通的多对多字段不同,你不能使用add、 create和赋值语句(比如,beatles.members = [...])来创建关系,这是因为你不能只创建 Person和 Group之间的关联关系,你还要指定 Membership模型中所需要的所有信息;
而简单的add、create 和赋值语句是做不到这一点的。所以它们不能在使用中介模型的多对多关系中使用。此时,唯一的办法就是创建中介模型的实例。
remove()方法被禁用也是出于同样的原因。但是clear()方法却是可用的。它可以清空某个实例所有的多对多关系
>>> # Beatles have broken up
>>> beatles.members.clear()
>>> # Note that this deletes the intermediate model instances
>>> Membership.objects.all()
[]
一对一关系
OneToOneField用来定义一对一关系。 用法和其他字段类型一样:在模型里面做为类属性包含进来。
模型的方法
我们可以通过重写模型上面自定义的方法来自定义底层功能
from django.db import models
class Person(models.Model):
first_name = models.CharField(max_length=50)
last_name = models.CharField(max_length=50)
def __str__(self):
return '%s %s' % (self.first_name, self.last_name)
在执行str()函数是,会按照自定义的方式显示