六:Models示例
Django本身提供了非常强大易使用的ORM组件,并且支持多种数据库。
配置连接数据文件
在自己创建的project 目录下编辑settings.py
DATABASES = { 'default': { 'ENGINE': 'django.db.backends.mysql', # mysql 数据库 'NAME': 'dbname', #确保此数据库已存在 'HOST':'', 'PORT':'', 'USER':'root', 'PASSWORD':'' } }
假设下面的概念,字段关系:
1,一个作者有姓,名及email地址
2,出版商有名称,地址,所在城市,省,国家,网站
3,书籍有书名和出版日期。它有一个或多个作者,只有一个出版商
#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项目中 激活这些模型。将上面的模型所在的app添加到配置文件的安装应用列表中。
# settings.py INSTALLED_APPS = ( 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.sites', 'app01', # 自己所创建的Django项目名 )
按照模型的配置生成表结构
命令行模式:
python manage.py makemigrations # 生成同步记录
python manage.py migrate # 开始同步数据库
基本数据访问
数据同步完成之后就可以在命令行模式 使用 python manage.py shell 就可以进入Django提供的高级python API
>>> 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>]如果需要一步创建与存储到数据库,就需要使用 objects.create() 方法
>>> 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
__unicode__() 和 __str__()
当我们打印整个publisher 列表时,我们没有得到想要的信息,无法把对象区分。
[<Publisher: Publisher object>, <Publisher: Publisher object>]为了解决这个问题,只需要为publisher对象添加一个方法。这个方法告诉python 如果将对象以unicode的方式显示出来。
def __str__(self): return self.name # name为需要显示的字段名。可以返回多个 # return "<%s %s>" %(self.first_name,self.last_name)注:在python 2.x 里面使用 __unicode_() python3.x 里面使用 __str__()
插入和更新数据
插入数据:
p = Publisher(name='Apress', ... address='2855 Telegraph Ave.', ... city='Berkeley', ... state_province='CA', ... country='U.S.A.', ... website='http://www.apress.com/') p.save() # 这一步才会插入数据库更新数据:
>>> p.name = 'Apress Publishing' # 直接赋值,就是更改数据 >>> p.save() # 保存
查找对象
>>> Publisher.objects.all() [<Publisher: Apress>, <Publisher: O'Reilly>] # 相当于SQL 语句 SELECT id, name, address, city, state_province, country, website FROM books_publisher;注意:Django 在选择所有数据时并没有使用 select * ,而是显示列出了所有字段。因为 select * 会更慢,而且最重要的是列出所有字段遵循了python 界的一个信条:明言胜于暗示
数据过滤
filter() 方法进行数据过滤
>>> Publisher.objects.filter(name='Apress') [<Publisher: Apress>]可以使用多个 filter() 来缩小范围:
>>> Publisher.objects.filter(country="U.S.A.", state_province="CA") [<Publisher: Apress>]进行模糊匹配:
>>> Publisher.objects.filter(name__contains="press") [<Publisher: Apress>] # 在name和contains 之间有两个下划线。# Django 使用双下划线来表明会进行一些操作。
转为原生的SQL:
SELECT id, name, address, city, state_province, country, website FROM books_publisher WHERE name LIKE '%press%';
获取单个对象
使用get() 方法获取单个对象
>>> Publisher.objects.get(name="Apress") <Publisher: Apress>这里返回的是单个对象,而不是列表。所以如果结果是多个对象,就会导致抛出异常。
如果没有查询到结果也会抛出异常:
>>> Publisher.objects.get(name="Penguin") Traceback (most recent call last): ... DoesNotExist: Publisher matching query does not exist.这个DoesNotExist 异常是 publisher 这个model 类的一个属性,即publisher.DoesNotExist。在应用中可以捕获并处理这个异常。
try: p = Publisher.objects.get(name='Apress') except Publisher.DoesNotExist: print "Apress isn't in the database yet." else: print "Apress is in the database."
数据排序
使用order_by() 方法进行排序
>>> Publisher.objects.order_by("name") [<Publisher: Apress>, <Publisher: O'Reilly>]对多个字段进行排序
>>> Publisher.objects.order_by("state_province", "address") [<Publisher: Apress>, <Publisher: O'Reilly>]倒序,在前面加一个 - 前缀:
>>> Publisher.objects.order_by("-name") [<Publisher: O'Reilly>, <Publisher: Apress>]尽管和灵活,但是每次都要用 order_by() 显得有点啰嗦。大多数只会通过某些字段进行排序,这中情况下Django 可以指定模型的缺省排序方式:
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 self.name class Meta: ordering = ['name'] # 缺省排序字段class Meta ,内嵌于Publisher这个类的定义中(如果class Publisher是顶格的,那么class Meta 在它之下不要缩进4个空格)。可以在任意一个模型中使用Meta类,来设置一些与特定模型相关的选择。Meta 还可以设置其他选项。如果设置了这个选项,那么触发检索时特意额外使用了 order_by() ,否则,当你使用Django的数据库API去检索时,Publisher对象的相关返回值默认都会按照name字段排序。
连锁查询
同时进行过滤和排序查询
>>> Publisher.objects.filter(country="U.S.A.").order_by("-name") [<Publisher: O'Reilly>, <Publisher: Apress>]
限制返回的数据
只显示第一条数据
>>> Publisher.objects.order_by('name')[0] <Publisher: Apress>[ ] 内类似一个列表
比如取第一条和第二条
>>> Publisher.objects.order_by('name')[0:2]但是不支持 负索引
更新多个对象
在插入和更新数据中,使用save()方法,这个方法会更新一行里面的说有列。
>>> p = Publisher.objects.get(name='Apress') >>> p.name = 'Apress Publishing' >>> p.save() # 原生的SQL语句: SELECT id, name, address, city, state_province, country, website FROM books_publisher WHERE name = 'Apress'; 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 = 52; #假设ID为52从原生的SQL来看save() 方法是更新了一行内的所有字段。
如果想只更新某一个字段
>>> Publisher.objects.filter(id=52).update(name='Apress Publishing')转为的原生SQL
UPDATE books_publisher SET name = 'Apress Publishing' WHERE id = 52;update()方法对任何结果集都有效。因此可以同时更新多条记录
>>> Publisher.objects.all().update(country='USA') 2 #update()方法会返回一个整数数值,表示受到影响的记录条数。
删除对象
使用delete()方法
>>> p = Publisher.objects.get(name="O'Reilly") >>> p.delete() >>> Publisher.objects.all() [<Publisher: Apress Publishing>] # 同也可以删除多条数据 >>> Publisher.objects.filter(country='USA').delete() >>> Publisher.objects.all().delete() >>> Publisher.objects.all() []在删除数据的时候要小心,一旦使用all()方法,所有的数据将会被删除。
如果需要删除部分的数据,就不需要调用all()方法。
>>> Publisher.objects.filter(country='USA').delete()