注: 由于自己排版确实很难看,本文开始使用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,否则将会报错一直迁移不到数据库中。被这个坑了好久。