os:mac, django1.9.5,  python3.5

database:mysql

0.背景

django中每一个模型model都对应于数据库中的一张表，每个模型中的字段都对应于数据库表的列。

方便的是，django可以自动生成这些create table, alter table, drop table的操作。

想想看，如果我们每次修改django中的数据模型，又要去同步修改数据库中的模型，是多么麻烦的一件事。更不用说那些容易发生的细节上的错误了。

1.创建模型

假设我们为一个shopping mall创建一个简单的数据模型：

商场里分各个区域，如化妆品区，女装区，男装区等等。对应Area模型，有字段区域名name, 描述description, 管理人员manager。

接着，在每个区域中又有许多商铺。对应Store模型，有字段商铺名name, 外键area（Area与Store为一对多关系）。

而每个商铺里，贩卖各种商品。对应Item模型，有字段商品名name, 价格price, 外键store（Store与Item为一对多关系）。

 1 from django.db import models
 2 from django.contrib.auth.models import User
 3
 4
 5 class Area(models.Model):
 6     name = models.CharField(max_length=30)
 7     description = models.CharField(max_length=100)
 8     manager = models.ForeignKey(User, blank=True, null=True)
 9
10     def __str__(self):
11         return self.name
12
13
14 class Store(models.Model):
15     name = models.CharField(max_length=30)
16     area = models.ForeignKey(Area, on_delete=models.CASCADE, related_name='stores')
17
18     def __str__(self):
19         return self.name
20
21
22 class Item(models.Model):
23     name = models.CharField(max_length=30)
24     price = models.IntegerField()
25     store = models.ForeignKey(Store, on_delete=models.CASCADE)
26
27     def __str__(self):
28         return self.name

1.1 主键

我们注意到，在上面定义model时，我们并没有定义主键primary key。这是因为除非你显式指定，django会自动为你的模型增加一个字段名为id的主键。

id = models.AutoField(primary_key=True)

当然，我们也可以自定义主键，只要给字段设置primary_key=True就可以。这时候，django就不会自动为我们的模型设置id主键了。

primary_key=True意味着null=False 以及unique=True。也就是说，主键是非空且独一无二的，它是用来在这个表中标识这一行数据的。

在django的模型中，主键也是只读的。


1.2 外键

在模型中定义外键时，同步数据库后，django默认在外键字段名后加上"_id"作为数据库表的列名。

ForeignKey()常用的额外参数如下：

级联删除： on_delete=models.CASCADE

反向查询： 如我们在Store模型的外键store字段中设置realted_name='stores'，可以在关系的另一端，即area端反向查询到stores

1.3 __str__()方法

给每个模型定义__str__()方法是一个很好的做法，这不只是为了交互时方便，也是因为django会在其他一些地方用 __str__() 来显示对象。

注意__str__()方法必须返回字符串。

2.生成模型

每一次对model的修改，都需要运行以下两条命令来同步我们的数据库：

1 python manage.py makemigrations
2 python manage.py migrate

2.1 makemigrations

其中第一条命令的作用是生成migrations文件。

在我们的例子中，makemigrations后shell中会有以下输出：

1 Migrations for 'shop':
2   0001_initial.py:
3     - Create model Area
4     - Create model Store
5     - Create model Item

而这时候，在我们的app shop中能看到一个migrations文件夹，打开0001_initial.py，就能看到对应的migration语句。

2.2 migrate

而第二条命令的作用是将这些migrations应用到数据库上去。

在我们的例子中，migrate后shell中会有以下输出：

1 Operations to perform:
2   Apply all migrations: silk, sessions, admin, auth, shop, contenttypes
3 Running migrations:
4   Rendering model states... DONE
5   Applying shop.0001_initial... OK

自动生成的表名为app名（shop）和模型的小写名称（area, store, item）的组合（用下划线_组合）。如在app shop下的模型Area对应数据库中的shop_area表。

2.3 说明

每个app的migration文件都会在app中的migrations文件夹下被生成。

在django中，每一次对模型以及模型中的字段的增加，删除或修改，都会在执行python manage.py makemigrations后生成相应的migrations。

建议仔细检查makemigrations后shell中的输出，尤其是在对模型进行了复杂的改变时。检查完毕后再执行migrate。

当然，如果你在运行makemigrations后反悔了，大可以不执行migrate，而是转去删除刚刚生成的migrations文件。

everyone deserves a second chance:)

3.数据库的基本操作

3.1 增

我们先为shopping mall增加一个化妆品区：

1 from django.shortcuts import HttpResponse
2 from .models import Area
3
4
5 def add_area(request):
6     area = Area.objects.create(name='cosmetic', description='充满香味儿的区域')
7
8     return HttpResponse('added!')

其中，第六行代码 area = Area.objects.create(name='cosmetic', description='充满香味儿的区域')

所对应的mysql语句为：

insert into shop_area(name,description) values('cosmetic','充满香味儿的区域');

3.2 查

现在，我们来列出shopping mall中的所有区域：

1 from django.shortcuts import HttpResponse
2 from .models import Area
3
4
5 def list_area(request):
6     area = Area.objects.all()
7     print(area)                    # 在shell输出[<Area: 'cosmetic'>],如果没有定义__str__(),将输出无意义的[<Area: Area object>]
8
9     return HttpResponse('listed!')

第六行代码 area = Area.objects.all()

相当于mysql语句：

select * from shop_area;

复习一下：shop_area为django为模型自动生成的表名（app_model）

3.3 改

在3.1中，我们并没有为化妆品区指定管理人员。现在，我们修改化妆品区的信息，将rinka指定为管理人员。

首先，我们要创建一个rinka用户。这里我将创建一个名为rinka的superuser：

python manage.py createsuperuser

接着，将我们创建的rinka用户指定为化妆品区的管理人员：

 1 from django.shortcuts import HttpResponse
 2 from .models import Area
 3 from django.contrib.auth.models import User
 4
 5
 6 def update_area(request):
 7     rinka = User.objects.get(username='rinka')
 8     area = Area.objects.get(id=1)
 9     area.manager = rinka
10     area.save()
11
12     return HttpResponse('updated!')

注意必须调用对象的save()方法，对对象实例的修改才会保存到数据库中去。这是一个容易出错的地方。

第8~10行代码对应的mysql语句为：

update shop_area set manager_id=1 where id=1;

复习一下：manager_id为django默认为外键生成的列名（foreignkey_id）

3.4删

删除操作很简单，我们现在来删除数据库表shop_area中id为1的那行数据：

1 from django.shortcuts import HttpResponse
2 from .models import Area
3
4
5 def delete_area(request):
6     area = Area.objects.get(id=1)
7     area.delete()
8
9     return HttpResponse('deleted!')

第6~7行语句对应的mysql语句为：

delete from shop_area where id=1;

总结

django中数据库基本操作：

1.同步数据库

python manage.py makemigrations  #生成migrations

python manage.py migrate   #应用migrations

2.增

Model.objects.create(**kwargs)

3.查

Model.objects.all()

4.改

m = Model.objects.get(id=1)

m.name = 'new_name'

m.save()

5.删

m = Model.objects.get(id=1)

m.delete()