前言
前边记录的URLconf和Django模板全都是介绍页面展示的东西，也就是表现层的内容。由于Python先天具备简单而强大的数据库查询执行方法，Django 非常适合开发数据库驱动网站。 这篇开始，进入到了Django模型，也就是数据库操作。
自带 Sqlite3 数据库查询方式
为了简单，使用Python自带的Sqlite3数据库进行实例说明。
先看一个传统的数据库操作示例：
from django.shortcuts import render
import sqlite3
from django.http import HttpResponse # Create your views here.
def publist(request):
conn = sqlite3.connect('db.sqlite3')
cur = conn.cursor()
html = '<html><body>'
for record in cur.execute('select * from books_publisher'):
for item in record:
html=html + str(item) +'||'
html = html+'<br />' html=html+'</body></html>'
conn.close() #return HttpResponse(cur.execute('select * from books_publisher').fetchall())
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 重写之前那个视图。
def publisher_list(request):
return HttpResponse(Publisher.objects.order_by('name'))
结果如下截图：
结果稍有不同，这些接下来会说。重点要说的是，这，有没有太简洁了！
上边两个地址配置urls.py如下
url(r'^books/publist/$',publist),
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 并输入下面的内容：
from django.db import models class Publisher(models.Model):
name = models.CharField(max_length=30)
address = models.CharField(max_length=50)
city = models.CharField(max_length=60)
state_province = models.CharField(max_length=30)
country = models.CharField(max_length=50)
website = models.URLField() class Author(models.Model):
first_name = models.CharField(max_length=30)
last_name = models.CharField(max_length=40)
email = models.EmailField() class Book(models.Model):
title = models.CharField(max_length=100)
authors = models.ManyToManyField(Author)
publisher = models.ForeignKey(Publisher)
publication_date = models.DateField()
每个数据模型都是 django.db.models.Model 的子类。它的父类 Model 包含了所有必要的和数据库交互的方法，并提供了一个简洁漂亮的定义数据库字段的语法。每个模型相当于单个数据库表，每个属性也是这个表中的一个字段。属性名就是字段名，它的类型（例如CharField ）相当于数据库的字段类型 （例如 varchar ）。例如， Publisher 模块等同于下面这张表（用PostgreSQL的 CREATE TABLE 语法描述）：
CREATE TABLE "books_publisher" (
"id" serial NOT NULL PRIMARY KEY,
"name" varchar(30) NOT NULL,
"address" varchar(50) NOT NULL,
"city" varchar(60) NOT NULL,
"state_province" varchar(30) NOT NULL,
"country" varchar(50) NOT NULL,
"website" varchar(200) NOT NULL
);
“每个数据库表对应一个类”这条规则的例外情况是多对多关系。 在我们的范例模型中， 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，如下
INSTALLED_APPS = (
## 'django.contrib.admin',
## 'django.contrib.auth',
## 'django.contrib.contenttypes',
## 'django.contrib.sessions',
## 'django.contrib.messages',
## 'django.contrib.staticfiles',
'mysite.books',
) MIDDLEWARE_CLASSES = (
## 'django.contrib.sessions.middleware.SessionMiddleware',
## 'django.middleware.common.CommonMiddleware',
## 'django.middleware.csrf.CsrfViewMiddleware',
## 'django.contrib.auth.middleware.AuthenticationMiddleware',
## 'django.contrib.messages.middleware.MessageMiddleware',
## 'django.middleware.clickjacking.XFrameOptionsMiddleware',
)
'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的方式显示出来
class Publisher(models.Model):
name = models.CharField(max_length=30)
address = models.CharField(max_length=50)
city = models.CharField(max_length=60)
state_province = models.CharField(max_length=30)
country = models.CharField(max_length=50)
website = models.URLField() def __unicode__(self):
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
class Publisher(models.Model):
name = models.CharField(max_length=30)
address = models.CharField(max_length=50)
city = models.CharField(max_length=60)
state_province = models.CharField(max_length=30)
country = models.CharField(max_length=50)
website = models.URLField() def __unicode__(self):
return u'name:%s , address: %s ||' % (self.name,self.address) class Meta:
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，增删改查操作等。