前言
前边记录的URLconf和Django模板全都是介绍页面展示的东西,也就是表现层的内容。由于Python先天具备简单而强大的数据库查询执行方法,Django 非常适合开发数据库驱动网站。 这篇开始,进入到了Django模型,也就是数据库操作。
自带 Sqlite3 数据库查询方式
为了简单,使用Python自带的Sqlite3数据库进行实例说明。
先看一个传统的数据库操作示例:
1 from django.shortcuts import render 2 import sqlite3 3 from django.http import HttpResponse 4 5 # Create your views here. 6 def publist(request): 7 conn = sqlite3.connect(‘db.sqlite3‘) 8 cur = conn.cursor() 9 html = ‘<html><body>‘ 10 for record in cur.execute(‘select * from books_publisher‘): 11 for item in record: 12 html=html + str(item) +‘||‘ 13 html = html+‘<br />‘ 14 15 html=html+‘</body></html>‘ 16 conn.close() 17 18 #return HttpResponse(cur.execute(‘select * from books_publisher‘).fetchall()) 19 return HttpResponse(html)
这是你想要自己处理,所以使用了两个嵌套循环,其实实例根本不需这样的。第7、8和18行即可(这个结果会不一样,是个字段的字符串连接)。
结果如下截图:
简单入门查看这里,vamei的Python入门系列-数据库
这个方法,有几个问题:
- 将数据库连接参数硬行编码于代码之中。比如Mysql数据库
MySQLdb.connect(user=‘me‘, db=‘mydb‘, passwd=‘secret‘, host=‘localhost‘)
- 重复同样的代码: 创建数据库连接、创建数据库游标、执行某个语句、然后关闭数据库
- 切换数据库可能需要改变连接参数,甚至sql语句。
Django 数据库 API
正如你所期待的,Django数据库层正是致力于解决这些问题。 以下提前揭示了如何使用 Django 数据库 API 重写之前那个视图。
1 def publisher_list(request): 2 return HttpResponse(Publisher.objects.order_by(‘name‘))
结果如下截图:
结果稍有不同,这些接下来会说。重点要说的是,这,有没有太简洁了!
上边两个地址配置urls.py如下
1 url(r‘^books/publist/$‘,publist), 2 url(r‘^books/publisherlist/$‘,publisher_list),
设置并保存数据库配置
这里不介绍这些了,有想看的请查看原文的数据库配置一节(因为文章介绍比较老,所以有可能和现在的项目是有区别的,请注意)
下边的内容都假设已经配置好了数据库。我的实例是基于Sqlite的,所以没做任何配置,当你执行某些数据库操作时,Django帮我们自动做好了这些。
在项目目录下执行 python manager.py shell (再说一次,这个 命令是以正确Django配置启用Python交互解释器的一种方法。这里,Django要去查找正确的数据库配置)
>>> from django.db import connection >>> cursor = connection.cursor()
用于检测配置的数据库环境是否有异常。
第一个数据库应用程序
Django app
一个包含模型,视图和Django代码,并且形式为独立Python包的完整Django应用。
之前所有的实例我们是在一个project中进行的(还记得 python django-admin.py startproject mysite 吧)
那么 project 和 app 之间到底有什么不同呢?它们的区别就是一个是配置另一个是代码:
- 一个project包含很多个Django app以及对它们的配置
- 一个app是一套Django功能的集合,通常包括模型和视图,按Python的包结构的方式存在。
可以不用创建app,我们之前的站点已经说明了这点。但是系统对app有一个约定: 如果你使用了Django的数据库层(模型),你必须创建一个Django app。
创建app
他会创建一个books文件夹,里面包含如下文件
Django 紧紧地遵循MVC 模式的,由于 C 由框架自行处理,而 Django 里更关注的是模型(Model)、模板(Template)和视图(Views),因此Django也被称为 MTV框架 。
在Python代码里定义模型
Django模型是用Python代码形式表述的数据在数据库中的定义。 对数据层来说它等同于 CREATE TABLE 语句,只不过执行的是Python代码而不是 SQL,而且还包含了比数据库字段定义更多的含义。 Django用模型在后台执行SQL代码并把结果用Python的数据结构来描述。 Django也使用模型来呈现SQL无法处理的高级概念。
第一个模型
定义一个基本的 书籍/作者/出版商 数据库结构。
第一步是用Python代码来描述它们。 打开由‘startapp’命令创建的models.py 并输入下面的内容:
1 from django.db import models 2 3 class Publisher(models.Model): 4 name = models.CharField(max_length=30) 5 address = models.CharField(max_length=50) 6 city = models.CharField(max_length=60) 7 state_province = models.CharField(max_length=30) 8 country = models.CharField(max_length=50) 9 website = models.URLField() 10 11 class Author(models.Model): 12 first_name = models.CharField(max_length=30) 13 last_name = models.CharField(max_length=40) 14 email = models.EmailField() 15 16 class Book(models.Model): 17 title = models.CharField(max_length=100) 18 authors = models.ManyToManyField(Author) 19 publisher = models.ForeignKey(Publisher) 20 publication_date = models.DateField()
每个数据模型都是 django.db.models.Model 的子类。它的父类 Model 包含了所有必要的和数据库交互的方法,并提供了一个简洁漂亮的定义数据库字段的语法。每个模型相当于单个数据库表,每个属性也是这个表中的一个字段。属性名就是字段名,它的类型(例如CharField )相当于数据库的字段类型 (例如 varchar )。例如, Publisher 模块等同于下面这张表(用PostgreSQL的 CREATE TABLE 语法描述):
1 CREATE TABLE "books_publisher" ( 2 "id" serial NOT NULL PRIMARY KEY, 3 "name" varchar(30) NOT NULL, 4 "address" varchar(50) NOT NULL, 5 "city" varchar(60) NOT NULL, 6 "state_province" varchar(30) NOT NULL, 7 "country" varchar(50) NOT NULL, 8 "website" varchar(200) NOT NULL 9 );
“每个数据库表对应一个类”这条规则的例外情况是多对多关系。 在我们的范例模型中, Book 有一个多对多字段叫做 authors 。 该字段表明一本书籍有一个或多个作者,但 Book 数据库表却并没有 authors 字段。 相反,Django创建了一个额外的表(多对多连接表)来处理书籍和作者之间的映射关系。
最后需要注意的是,我们并没有显式地为这些模型定义任何主键。 除非你单独指明,否则Django会自动为每个模型生成一个自增长的整数主键字段,每个Django模型都要求有单独的主键id
模型安装
再次编辑 settings.py 文件, 找到 INSTALLED_APPS 设置。 INSTALLED_APPS 告诉 Django 项目哪些 app 处于激活状态。
使用‘#‘注释掉该项配置里面的默认项,同时注释掉MIDDLEWARE_CLASSES的默认设置条目,因为这些条目是依赖于刚才我们刚在INSTALLED_APPS注释掉的apps。
添加‘mysite.books‘到INSTALLED_APPS,如下
1 INSTALLED_APPS = ( 2 ## ‘django.contrib.admin‘, 3 ## ‘django.contrib.auth‘, 4 ## ‘django.contrib.contenttypes‘, 5 ## ‘django.contrib.sessions‘, 6 ## ‘django.contrib.messages‘, 7 ## ‘django.contrib.staticfiles‘, 8 ‘mysite.books‘, 9 ) 10 11 MIDDLEWARE_CLASSES = ( 12 ## ‘django.contrib.sessions.middleware.SessionMiddleware‘, 13 ## ‘django.middleware.common.CommonMiddleware‘, 14 ## ‘django.middleware.csrf.CsrfViewMiddleware‘, 15 ## ‘django.contrib.auth.middleware.AuthenticationMiddleware‘, 16 ## ‘django.contrib.messages.middleware.MessageMiddleware‘, 17 ## ‘django.middleware.clickjacking.XFrameOptionsMiddleware‘, 18 )
‘mysite.books‘指示我们正在编写的books app。 INSTALLED_APPS 中的每个app都使用 Python的路径描述,包的路径,用小数点“.”间隔。
现在我们可以创建数据库表了。 首先,用下面的命令验证模型的有效性:
如果我将上边settings.py中INSTALLED_APPS中添加的‘mysite.books‘改成’books‘则会出错,原因是路径错误(这个要看你的app创建的路径)
模型确认没问题了,运行下面的命令来生成 CREATE TABLE 语句
python manage.py sqlall books
在这个命令行中, books 是app的名称。 和你运行 manage.py startapp 中的一样
注意:
- 自动生成的表名是app名称( books )和模型的小写名称 ( publisher , book , author )的组合
- Django为每个表格自动添加加了一个 id 主键
- Django添加 "_id" 后缀到外键字段名(外键是用 REFERENCES 语句明确定义或者(以及)多对多自动生成的关系对应表中的外键)
- CREATE TABLE 语句会根据你的数据库而调整sql语句
不知你发现没,表books_book_authors中只有一个外键定义,按理应该还有一个book_id的外键
"book_id" integer NOT NULL REFERENCES "books_book" ("id"),
这里没有生成,不知道为什么?有知道的大牛园友,请指教
这就是models.py定义的数据模型对应的sql语句。sqlall 命令并没有在数据库中真正创建数据表,只是把SQL语句段打印出来,这样你可以看到Django究竟会做些什么。我们可以拷贝这些语句到数据库客户端执行,不过Django为我们提供了一种更简易的方式:‘syncdb‘命令
python manage.py syncdb
syncdb 命令是同步你的模型到数据库的一个简单方法。 它会根据 INSTALLED_APPS 里设置的app来检查数据库, 如果表不存在,它就会创建它。 需要注意的是, syncdb 并 不能将模型的修改或删除同步到数据库;如果你修改或删除了一个模型,并想把它提交到数据库,syncdb并不会做出任何处理。如果你再次运行 python manage.py syncdb ,什么也没发生,因为你没有添加新的模型或者 添加新的app。因此,运行python manage.py syncdb总是安全的,因为它不会重复执行SQL语句。
基本数据访问
创建模型之后,Django自动为这些模型提供了高级的Python API。 运行 python manage.py shell,运行如下代码
>>> from books.models import Publisher >>> p1 = Publisher(name=‘Apress‘, address=‘2855 Telegraph Avenue‘, ... city=‘Berkeley‘, state_province=‘CA‘, country=‘U.S.A.‘, ... website=‘http://www.apress.com/‘) >>> p1.save() >>> p2 = Publisher(name="O‘Reilly", address=‘10 Fawcett St.‘, ... city=‘Cambridge‘, state_province=‘MA‘, country=‘U.S.A.‘, ... website=‘http://www.oreilly.com/‘) >>> p2.save() >>> publisher_list = Publisher.objects.all() >>> publisher_list [<Publisher: Publisher object>, <Publisher: Publisher object>]
- 首先,导入Publisher模型类, 通过这个类我们可以与包含 出版社 的数据表进行交互。
- 接着,创建一个`` Publisher`` 类的实例并设置了字段‘name, address‘等的值。
- 调用该对象的 save() 方法,将对象保存到数据库中。 Django 会在后台执行一条 INSERT 语句。
- 最后,使用‘Publisher.objects‘属性从数据库取出出版商的信息,这个属性可以认为是包含出版商的记录集。 这个属性有许多方法,这里先介绍调用‘Publisher.objects.all()‘方法获取数据库中‘Publisher‘类的所有对象。这个操作的幕后,Django执行了一条SQL ‘SELECT‘ 语句。
当你使用Django modle API创建对象时Django并未将对象保存至数据库内,除非你调用 save() 方法。
如果不想分成创建对象,save到数据库 这样两步完成,可以使用如下语句:
>>> p1 = Publisher.objects.create(name=‘Apress‘, ... address=‘2855 Telegraph Avenue‘, ... city=‘Berkeley‘, state_province=‘CA‘, country=‘U.S.A.‘, ... website=‘http://www.apress.com/‘) >>> p2 = Publisher.objects.create(name="O‘Reilly", ... address=‘10 Fawcett St.‘, city=‘Cambridge‘, ... state_province=‘MA‘, country=‘U.S.A.‘, ... website=‘http://www.oreilly.com/‘) >>> publisher_list = Publisher.objects.all() >>> publisher_list
[<Publisher: Publisher object>, <Publisher: Publisher object>]
添加模块的字符串表现
当我们打印整个publisher列表时,我们没有得到想要的有用信息,而是像下面这样
[<Publisher: Publisher object>, <Publisher: Publisher object>]
我们可以简单解决这个问题,只需要为Publisher 对象添加一个方法 __unicode__() 。 __unicode__() 方法告诉Python如何将对象以unicode的方式显示出来
1 class Publisher(models.Model): 2 name = models.CharField(max_length=30) 3 address = models.CharField(max_length=50) 4 city = models.CharField(max_length=60) 5 state_province = models.CharField(max_length=30) 6 country = models.CharField(max_length=50) 7 website = models.URLField() 8 9 def __unicode__(self): 10 return u‘name:%s , address: %s ||‘ % (self.name,self.address)
再执行Publisher.objects.all()
>>> Publisher.objects.all() [<Publisher: name:Apress , address: 2855 Telegraph Avenue ||>, <Publisher: name: Apress , address: 10 Fawcett St. ||>, <Publisher: name:Apress , address: 2855 Te legraph Ave. ||>]
请确保每一个模型里都包含 __unicode__() 方法,这不只是为了交互时方便,也是因为 Django会在其他一些地方用 __unicode__() 来显示对象。
数据的增删改查
插入
创建实例对象,调用save()即可插入数据
更新
>>> p.name = ‘Apress Publishing‘ >>> p.save()
注意,这个save() 并不是只更新修改过的那个字段,所有的字段都会被更新!类似于:
UPDATE books_publisher SET name = ‘Apress Publishing‘, address = ‘2855 Telegraph Ave.‘, city = ‘Berkeley‘, state_province = ‘CA‘, country = ‘U.S.A.‘, website = ‘http://www.apress.com‘ WHERE id = 3;
而如下方式即可做到单列更新:用结果集(QuerySet)对象的update()方法
>>> Publisher.objects.all().update(country=‘USA‘)
类似于:
UPDATE books_publisher SET country= ‘USA‘
查找
>>> Publisher.objects.all()
所有的模型都自动拥有一个 objects 管理器,用于获取数据库记录,返回对应模型。
all()返回所有记录。
1、过滤方法filter
filter() 接受多个参数
>>> Publisher.objects.filter(country="U.S.A.", state_province="CA") [<Publisher: name:Apress , address: 2855 Telegraph Ave. ||>]
filter() 根据关键字参数来转换成 WHERE SQL语句。
SELECT id, name, address, city, state_province, country, website FROM books_publisher WHERE country = ‘U.S.A.‘ AND state_province = ‘CA‘;
注意 这里的‘=‘都是精确查找。
下边是模糊检索方式
>>> Publisher.objects.filter(name__contains="press") [<Publisher: name:Apress , address: 2855 Telegraph Avenue ||>, <Publisher: name: Apress , address: 10 Fawcett St. ||>, <Publisher: name:Apress , address: 2855 Te legraph Ave. ||>]
在 name 和 contains 之间有双下划线。在 name 和 contains 之间有双下划线。
SELECT id, name, address, city, state_province, country, website FROM books_publisher WHERE name LIKE ‘%press%‘;
还有一些其他的查找类型,比如 icontains(大小写无关的LIKE),startswith和endswith, 还有range(SQLBETWEEN查询)等
2、获取单个对象get
>>> Publisher.objects.get(country="U.S.A.") <Publisher: name:Apress , address: 2855 Telegraph Ave. ||>
当get方法获取到结果不为一个时(0个或者大于1个)会抛出异常
排序order_by()
>>> Publisher.objects.order_by("address") [<Publisher: name:Apress , address: 10 Fawcett St. ||>, <Publisher: name:Apress , address: 2855 Telegraph Ave. ||>, <Publisher: name:Apress , address: 2855 Tele graph Avenue ||>]
order_by()也可以接受多个参数,第二个字段会在第一个字段的值相同的情况下被使用到
Publisher.objects.order_by("state_province", "address")
我们还可以指定逆向排序,在前面加一个减号 - 前缀:
>>> Publisher.objects.order_by("-address") [<Publisher: name:Apress , address: 2855 Telegraph Avenue ||>, <Publisher: name: Apress , address: 2855 Telegraph Ave. ||>, <Publisher: name:Apress , address: 10 Fawcett St. ||>]
class Meta
1 class Publisher(models.Model): 2 name = models.CharField(max_length=30) 3 address = models.CharField(max_length=50) 4 city = models.CharField(max_length=60) 5 state_province = models.CharField(max_length=30) 6 country = models.CharField(max_length=50) 7 website = models.URLField() 8 9 def __unicode__(self): 10 return u‘name:%s , address: %s ||‘ % (self.name,self.address) 11 12 class Meta: 13 ordering=[‘-name‘]
class Meta内嵌于 Publisher 这个类的定义中,如果你设置了这个选项,那么除非你检索时特意额外地使用了 order_by(),否则,当你使用 Django 的数据库 API 去检索时,Publisher对象的相关返回值默认地都会按 name 字段排序。
删除delete()
>>> Publisher.objects.filter(country=‘USA‘).delete()
前边所有获取单条记录、多条记录均可以在返回的结果集后进行删除。
链式操作
>>> Publisher.objects.filter(id=52).update(name=‘Apress Publishing‘)
限制结果
>>> Publisher.objects.order_by(‘name‘)[0:4] [<Publisher: name:Apress , address: 2855 Telegraph Avenue ||>, <Publisher: name: Apress , address: 10 Fawcett St. ||>, <Publisher: name:Apress , address: 2855 Te legraph Ave. ||>]
超过索引不会报错。但是不支持Python的负索引。
小结
传统的Python数据库操作,Django app创建,Django的数据库 API,增删改查操作等。