Python Django 学习 (二) 【Django 模型】
注: 由于自己排版确实很难看,本文开始使用markdown编辑,希望有所改善
官方定义
A model is the single, definitive source of information about your data. It contains the essential fields and behaviors of the data you’re storing. Generally, each model maps to a single database table.
一个模型是关于你的数据的单个的、确定的信息源。它包含了你储存数据的必要的列和行为,基本上,一个模型映射一个单个的数据库表。
更改Django数据库配置
由于原生的django使用的是sqlite3, 本人熟悉mysql 所以最后使用mysql。
注:本文接着上一篇文章来的,如果没有相应的项目请按照上一篇内容操作一下。[Python Django 学习 (一) 【Django 框架初探】]
- 在 test_project项目中找到文件 test_project/test_project/settings.py 找到如下代码
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
}
}
- 将上述代码注释掉,添加如下代码:
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql',
'NAME': 'mysql',#数据库名字
'USER':'root',
'PASSWORD':'*****',
'HOST':'localhost',
'PORT':'3306',
}
}
- 确保一件事情,你的python3 的版本安装了 pymysql 、mysqlclient 使用pip 安装
pip3.6 install pymysql
pip3.6 install mysqlclient
# 我在安装mysqlclient时出现了问题,到 https://www.lfd.uci.edu找的包自己安装的
创建 test_app
在使用model时,官方文档说,“当你定了模型之后,你需要告诉Django你将使用这些模型。通过编辑setting.py中 INSTALL_APPS,将包含你的模型的app的名字放到里面”
- 打开 CMD 键入 如下指令:
python36 manage.py startapp test_app
-
将会在 test_project项目下 新建一个 test_app文件目录
-
作用说明
文件名 | 作用 |
---|---|
migrations | 将模型的更改,形成可执行的PY文件,使用指令迁移到数据库中 |
_init_.py | 标识当前文件路径是一个python包 |
admin.py | 可以在其中添加当前model,然后使用界面对数据库进行操作 |
apps.py | 当前app 配置 |
models.py | 存放当前app存在的模型,与数据库一一对应 |
tests.py | 存放当前app的测试 |
views.py | 存在当前app的页面模板 |
- 将 test_app 添加到 test_project/test_project/settings.py文件中,如下:
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
# new add
'test_app',
]
添加 testmodel 到 test_app中、迁移到数据库
- 打开 文件 test_project/test_app/modes.py 更改代码如下:
from django.db import models
# Create your models here.
class TestModel(models.Model):
# django 有一个机制 在没有设置自增主键的时候会自动创建一个主键,
test_name = models.CharField(max_length=100, default='no_name') # 字符类型的字段 设置最大长度与默认值
test_content = models.CharField(max_length=50,default='male') # 字符类型的字段 设置最大长度与默认值
# 如果不指定表名,django默认表明是 'appname_classname'
class Meta:
'''
使用如下语句定义表名
db_table = 'test_model'
'''
def __unicode__(self):
return '%d: %s' % (self.pk, self.test_name)
- 打开 CMD 键入 如下命令:
python36 manage.py makemigrations #不指定app将迁移全部数据
python36 manage.py makemigrations test_app # 可以选择单个app进行数据迁移
#以上两个都可以,在app多的时候,建议使用下面的单个迁移
#该命令只是生成迁移文件,并没有真正的操作数据库
#######################################################################################
#返回如下结果
Migrations for 'test_app':
test_app\migrations\0001_initial.py
- Create model TestModel
- 下面我查看文件夹 test_project\test_app\migrations 增加了文件 0001_initial.py,第一次迁移文件名应该都是这个,之后会不同。查看 文件 0001_initial.py 内容如下:
# Generated by Django 2.0 on 2018-11-15 03:00
from django.db import migrations, models
class Migration(migrations.Migration):
initial = True
dependencies = [
]
operations = [
migrations.CreateModel(
name='TestModel',
fields=[
('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('test_name', models.CharField(default='no_name', max_length=100)),
('test_content', models.CharField(default='male', max_length=50)),
],
),
]
# 我们可以看到,钱 Migration类中,定义了新的 模型 TestModel,并且有三个字段 id、test_name、test_content
- 我每次迁移的时候都会查看,生成的迁移文件,确保都是我想要的数据库改动。打开CMD 键入指令:
python36 manage.py migrate
#该指令将,真正将建表操作到mysql数据库中
#######################################################################################
#会看到如下提示
Operations to perform:
Apply all migrations: admin, auth, contenttypes, sessions, test_app
Running migrations:
Applying test_app.0001_initial... OK
#可以发现执行了 刚才的 0001_initial.py 文件中的内容
- 我们打开mysql 数据库查看,是否存在表
mysql> show create table test_app_testmodel
-> ;
+--------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Table | Create Table |
+--------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| test_app_testmodel | CREATE TABLE `test_app_testmodel` (
`id` int(11) NOT NULL AUTO_INCREMENT,
`test_name` varchar(100) NOT NULL,
`test_content` varchar(50) NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci |
+--------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
1 row in set (0.01 sec)
- 至此,模型与数据库已经实现了同步。
使用 django admin管理数据库数据
- 之前说过 test_app下的文件 admin.py 添加如下内容:
from django.contrib import admin
from .models import TestModel
# Register your models here.
@admin.register(TestModel)
class TestModelAdmin(admin.ModelAdmin):
list_display = ('pk', 'test_name') #在后台列表下显示的字段
-
进入 django admin页面 输入超级用户用户名、密码
-
通过 admin 管理 test model,点击上面的 Test models 可以通过页面进行增、删、改、查的操作
介绍一下Django提供的字段类型
- 基本类型
AutoField #自增列,如果不存在的话会添加一个自增的ID列
BigAutoField # 64位的,比上面自增列大
BigIntegerField #64 位的整型
BinaryField #原生的二进制列
BooleanField#布尔
CharField#字符串,注意该字段必须指定 max_length
DateField#日期,可以指定auto_now 与 auto_now_add可以自动填充当前列为当前时间
DateTimeField# datetime
DecimalField# 小数点
DurationField# 与python的timedelta对应
EmailField
FileField
FileField and FieldFile
FilePathField
FloatField
ImageField
IntegerField
GenericIPAddressField
NullBooleanField
PositiveIntegerField
PositiveSmallIntegerField
SlugField
SmallIntegerField
TextField
TimeField
URLField
UUIDField
# 不是所有的 field 都用过,有兴趣请自行尝试
- ArrayField
最近使用 Postgresql 开发,发现它支持,array类型。在Django,中同样支持,代码如下:
class TestModel(models.Model):
test_array = ArrayField(models.CharField(max_length=96, null=False, default=''), default="{}", size="99")
# 意思为增加一个 test_array数组字段,并且数组元素都是char ,可以更换成其他类型
#此处default {}是因为 postgresql在检测的时候强制插入数据为 '{a,b,c,d}',default空的话会报错
class Meta:
db_table = 'test_model'
def __str__(self):
return self.node
代码中的增删改查
- 分别在以下文件中添加如下代码,路由具体说明将会重新写一篇文章
# test_project/test_project/urls.py
from django.conf.urls import url
from django.contrib import admin
from django.urls import path,include
urlpatterns = [
url(r'^admin/', admin.site.urls),
path('', include('test_app.urls')),#包括test_app的url
]
#创建 test_project/test_app/urls.py
from django.conf.urls import url
from test_app import views
urlpatterns = [
url('test_app/test_model', views.test_model),
]
- 查
# 需要定义一个查询的api
# test_project/test_app/views.py
from django.shortcuts import render
from django.http import HttpResponse
from . import models
import json as json
from django.core import serializers
def test_model(request):
data = models.TestModel.objects.all()
data_json = json.loads(serializers.serialize('json', data))#将queryset变成json输出
print(str(data_json))
return HttpResponse(data_json);
#启动Django服务后,在浏览器中输入 localhost:8000/test_app/test_model
#打印结果将在cmd显示
# 更换不同的查询方式,打印输出结果
# 数据库中插入了两条数据
models.TestModel.objects.all() #获取所有的数据 返回queryset
models.TestModel.objects.all().values('test_name') #只取test_name列 返回queryset
models.TestModel.objects.get("id=1") #只要id=1 返回object
models.TestModel.objects.all().filter("id=2") #只要id=2 返回queryset
models.TestModel.objects.all().exclude("id=2") #排除id=2 返回queryset
#打印结果
*******
[{'model': 'test_app.testmodel', 'pk': 1, 'fields': {'test_name': 'name1', 'test_content': 'content1'}}, {'model': 'test_app.testmodel', 'pk': 2, 'fields': {'test_name': 'test2', 'test_content': 'content2'}}]
*******
<QuerySet [{'test_name': 'name1'}, {'test_name': 'test2'}]>
*******
TestModel object (1)
*******
[{'model': 'test_app.testmodel', 'pk': 2, 'fields': {'test_name': 'test2', 'test_content': 'content2'}}]
*******
<QuerySet [<TestModel: TestModel object (1)>]>
*******
#更细节的查询,官网查看吧
https://docs.djangoproject.com/en/2.0/topics/db/queries/
- 增
#更改 test_project/test_app/urls.py,添加对于增加数据的url配置
from django.conf.urls import url
from test_app import views
urlpatterns = [
url('test_app/test_model', views.test_model),
# new add
url('test_app/test_addto_model', views.add_test_model),
]
#更改 test_project/test_app/views.py 新增如下函数代码
def add_test_model(request):
models.TestModel.objects.create(
test_name="name_add_by_code",test_content="content_add")
new_data = models.TestModel.objects.all()
new_data_json = json.loads(serializers.serialize('json', new_data))
return HttpResponse(new_data_json);
#启动 django 服务后,访问链接 localhost:8000/test_app/test_addto_model
页面输入结果:
{'model': 'test_app.testmodel', 'pk': 1, 'fields': {'test_name': 'name1', 'test_content': 'content1'}}{'model': 'test_app.testmodel', 'pk': 2, 'fields': {'test_name': 'test2', 'test_content': 'content2'}}{'model': 'test_app.testmodel', 'pk': 3, 'fields': {'test_name': 'name_add_by_code', 'test_content': 'content_add'}}
数据库查询结果
mysql> select * from test_app_testmodel;
+----+------------------+--------------+
| id | test_name | test_content |
+----+------------------+--------------+
| 1 | name1 | content1 |
| 2 | test2 | content2 |
| 3 | name_add_by_code | content_add |
+----+------------------+--------------+
3 rows in set (0.00 sec)
增加成功
# 由于考虑到数据完整行,简单介绍一下 Django 的 【事物】
from django.db import transaction
with transaction.atomic():
#数据库操作
#上面是最简单的方法,过程中报错将不会操作数据库
#详情参加官网:https://docs.djangoproject.com/en/2.0/topics/db/transactions/
- 改
#不做演示了,直接上代码
models.UserInfo.objects.filter(test_name='nam1').update(test_content='content1_update')
- 删
#删除的时候一定要filter一下呦
models.UserInfo.objects.filter(test_name='test2').delete()
数据库结构的导入到代码
- 下载了项目代码,但是本地数据库中没有项目表结构
- 数据库在后台改动了,要同步到代码中
python36 manage.py inspectdb
注:在使用makemigrations 与 migrate时,每一次的 makemigrations 是基于上一个makemigrations进行比较的,如果某一次的makemigrations后,migrate失败,切记到 app下 migrations文件夹下删除,最新的makemigrations文件,然后修改model代码,重新makemigrations,否则将会报错一直迁移不到数据库中。被这个坑了好久。