Django笔记教程：三、Model进阶

Model 进阶学习

简介

Django经常被用于一些创业团队，乃是因为其非常适合敏捷开发，开发效率非常之高。Model 作为Django重要组成部分也是亮点之一，着实需要我们花时间好好梳理一遍。
ORM需要好好学习一下，运用得当可以大大的提升代码的简洁性。Django的model模块，遵循了DRY（don’t repeat yourself）原则，也会使得代码更加容易维护，只需修改一次，肯定会大大提高程序的健壮性以及可维护性。
而且ORM也使得该框架更加灵活且松解耦。例如有些码农不喜欢django的模版，更偏爱其他的模版渲染引擎。django视图方法并未强制一定要使用自身的模版引擎，你一可以尝试实用jinjia2等等。同时ORM屏蔽了底层数据库的语法，你可以运行非常多的数据库类型（mysql,mongo?don’t care，改一下engine配置即可），当然性能肯定会降低一些，毕竟多封装了一层。

一路走来,踩过无数的大坑，发现网上很多网友的博文是误导性的，所以想在这里写一片文章梳理一下model的全貌，以备复习，也供给大家一个参考，如果发现错误希望可以帮忙指正，谢谢。

本文结构：

1. model常用字段定义
2. model的初级用法
3. model的高级用法
4. model的一些坑

1.model常用字段定义

    V=models.CharField(max_length=None[, **options])　　　　#varchar
    V=models.EmailField([max_length=75, **options])　　　　#varchar
    V=models.URLField([verify_exists=True, max_length=200, **options])　　　　#varchar
    V=models.FileField(upload_to=None[, max_length=100, **options])　　　　#varchar
    #upload_to指定保存目录可带格式，
    V=models.ImageField(upload_to=None[, height_field=None, width_field=None, max_length=100, **options])
    V=models.IPAddressField([**options])　　　　#varchar
    V=models.FilePathField(path=None[, match=None, recursive=False, max_length=100, **options])　#varchar
    V=models.SlugField([max_length=50, **options])　　　　#varchar，标签，内含索引
    V=models.CommaSeparatedIntegerField(max_length=None[, **options])　　　　#varchar
    V=models.IntegerField([**options])　　　　#int
    V=models.PositiveIntegerField([**options])　　　　#int 正整数
    V=models.SmallIntegerField([**options])　　　　#smallint
    V=models.PositiveSmallIntegerField([**options])　　　　#smallint 正整数
    V=models.AutoField(**options)　　　　#int；在Django代码内是自增
    V=models.DecimalField(max_digits=None, decimal_places=None[, **options])　　　　#decimal
    V=models.FloatField([**options])　　　　#real
    V=models.BooleanField(**options)　　　　#boolean或bit
    V=models.NullBooleanField([**options])　　　　#bit字段上可以设置上null值
    V=models.DateField([auto_now=False, auto_now_add=False, **options])　　　　#date
    #auto_now最后修改记录的日期；auto_now_add添加记录的日期
    V=models.DateTimeField([auto_now=False, auto_now_add=False, **options])　　　　#datetime
    V=models.TimeField([auto_now=False, auto_now_add=False, **options])　　　　#time
    V=models.TextField([**options])　　　　#text
    V=models.XMLField(schema_path=None[, **options])　　　　#text
    ——————————————————————————–
    V=models.ForeignKey(othermodel[, **options])　　　　#外键，关联其它模型，创建关联索引
    V=models.ManyToManyField(othermodel[, **options])　　　　#多对多，关联其它模型，创建关联表
    V=models.OneToOneField(othermodel[, parent_link=False, **options])　　　　#一对一，字段关联表属性

2.model初级用法

首先我们拿官网的例子作为示范，这个例子非常的经典，被用在django book以及其他很多相关的书籍当中。
我们首先假定如下的概念：

• 一个作者有姓，名，email地址。
• 出版商有名称，地址，所在的city,province,country,website.
• 书籍有书名和出版日期。它有一个或者多个作者[many-2-many]。但是只有一个出版商([one 2 many])，被称为外键[foreign key]。

在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()

    def __unicode__(self):
        return self.name

class Author(models.Model):
    first_name = models.CharField(max_length=30)
    last_name = models.CharField(max_length=40)
    email = models.EmailField()

    def __unicode__(self):
        return u'%s %s' % (self.first_name, self.last_name)

class Book(models.Model):
    title = models.CharField(max_length=100)
    authors = models.ManyToManyField(Author)
    publisher = models.ForeignKey(Publisher)
    publication_date = models.DateField()

    def __unicode__(self):
        return self.title

并且记得在配置里面加入app model注册,

之后可以用python manage.py validate 校验模型的正确性。
也可以用python mange.py sqlall books 来查看sql生成的语句。

后面还需要执行
python manage.py syncdb

基本的添加数据

基本的选择对象

• 获取全体对象：
  Publisher.objects.all()可以用来获取所有的对象.
• 筛选部分对象：
  Publisher.objects.filter(name='Apress')可以用来筛选所有name是Apress的publisher.(获取的是一个对象列表)
• 获取单个对象
  Publisher.objects.get(name='Apress')
  获取一个名字是Apress的开发商(只获取单个对象)。 filter的条件会在高级部分列出。
• 排序:
  publisher.objects.order_by("state_province","-address").这句代码几乎囊括了排序的精华:).我们可以看到是多字段排序，同时，address前面有一个-代表的是逆排序。
  当然，一般情况下，只需要按照某个字段进行排序，这种情况下可以指定模型的缺省排序方式：
  
• 连查:
  除了单个查询，我们还可以用下面这种方式来查询
  Publisher.objects.filter(name='xxoo').order_by('-name')[0]
  这段程序并不会执行两次，而是最后转化为一句sql语句来执行（考虑的太周到）.
• 更新多个对象：
  我们知道，之前我们用p.save()来更新对象，如果涉及到很多条数据需要一次性更新，这个时候该如何呢？Django也考虑到了这一点，可以用如下的方式来更新：
  Publisher.objects.all().update(country='China')，一次性将所有的Publisher的国家更新为china。
• 删除对象:
  前面讲了添加、更新，这里补充一下删除，删除主要是筛选出对象后执行delete()方法.
  Publisher.objects.filter(country='USA').delete()

3.model的高级用法

访问外键

>>>b=Book.objects.get(id=1)
>>>b=p.publisher
<publisher:Apress Publishing>
>>>b.publisher.website
u'http://www.xuancan.net.cn'

对于Foreignkey 来说，关系的另外一端，也可以追溯回来，不过由于不是对称关系，所以有一些区别，获得的是一个list，而非单一对象:

>>>p=Publisher.objects.get(name="Apress Publishing")
>>>p.book_set.all()
[<Book:The Chinese english>,<Book:the good good study>,...]

访问多对多值

多对多和外键工作方式类似，不过我们处理的是QuerySet而非模型实例。例如，查看书籍的作者：

>>>b = Book.objects.get(id=1)
>>>b.authors.all()
[<Author:liushuchun>,<Author:nobb>]
>>>b.authors.filter(fisrt_name="liushuchun")
[<Author:liushuchun>]

我们可以看到这就是类似objects来用了。

更改数据库结构

Django有一个不完善的地方是，一旦model确定下来后，再想通过命令来更新是无法更新的，会报错，这个时候就要学会用手动的方式更改数据库结构。
具体的过程：
1. 先在models.py文件中，找到你要添加字段的模型，添加（也可以是删除修改，只是sql语句有一些区别）上该字段，如下所示（抱歉，截图多了个等号）

2. 在cmd下，通过cd命令进入应用目录，也就是manage.py文件所在的目录
3. 然后使用python manage.py sqlall[app_name]命令，打印出app中包括的所有模型的sql语言表示

3. 找到你想要添加字段的表，找到你已经添加过的字段test，记下sql语句
4. 进入 manage.py shell 创建一个cursor实例，用于执行sql语句

5. 执行该sql语句，看好了，这个sql语句是刚才我让你记下的sql语句，执行这个命令就可以完成向数据库添加字段.

6. 最后，我们要验证添加字段是否成功，仍然在manage.py shell中，通过调用模型来检查是否成功。
这里我们只说了添加字段，其他删除或者修改字段类似。

manager管理器添加自定义方法

管理器是Django查询数据库时会使用到的一个特别的对象，在Book.objects.all()语法中，objects就是管理器，在django中，每一个model至少有一个管理器，而且，你也可以创建自己的管理器来自定义你的数据库访问操作。一方面可以增加额外的管理器方法，另一方面可以根据你的需求来修改管理器返回的QuerySet。
这是一种”表级别”的操作，下面我们给之前的Book类增加一个方法title_count()，它根据关键字，
返回标题中包括这个关键字的书的个数。

class BookManager(models.Manager):
    def title_count(self, keyword):
        return self.filter(title__icontains=keyword).count()
class Book(models.Model):
    title = models.CharField(max_length=100)
    authors = models.ManyToManyField(Author)
    publisher = models.ForeignKey(Publisher)
    publication_date = models.DateField()
    num_pages = models.IntegerField(blank=True, null=True)

    #可以直接赋值替换掉默认的objects管理器，也可以定义一个新的管理器变量
    #调用时，直接使用这个新变量就可以了，一旦定义了新的管理器，默认管理器
    #需要显示声明出来才可以使用
    # objects = models.Manger()
    objects = BookManager()

    def __unicode__(self):
        return self.title

结果为：

>>>Book.objects.title_count('python')
2

上面的代码可以看到，创建自定义的Manager的步骤：
1. 继承models.Manager，定义新的管理器方法，在方法中使用self，也就是manager本身来
进行操作
2. 把自定义的管理器对象赋值给objects属性来代替默认的管理器。
那为什么不直接创建个title_count函数来实现这个功能呢？
因为创建管理器类，可以更好地进行封装功能和重用代码。

修改返回的QuerySet

Book.objects.all()返回的是所有记录对象，可以重写Manager.get_query_set()方法，它返回的是你自定义的QuerySet，你之后的filter,slice等操作都是基于这个自定义的QuerySet。

from django.db import models

class RogerBookManager(models.Manager):
    def get_query_set(self):
        #调用父类的方法，在原来返回的QuerySet的基础上返回新的QuerySet
        return super(RogerBookManager, self).get_query_set().filter(title__icontains='python')

class Book(models.Model):
    title = models.CharField(max_length=100)
    author = models.CharField(max_length=50)

    #objects默认管理器需要显示声明，才能使用
    objects = models.Manager() # 默认的管理器
    roger_objects = RogerBookManager() # 自定义的管理器，用新变量

结果为：

>>>Book.objects.all()
[<Book:Coplier Theroy>,<Book:python>,...]
>>>Book.roger_objects.all()
[<Book:Python Tutorial>,<Book:Python tools>]

你可以为model定义多个不同的管理器来返回不同的QuerySet，不过要注意一点的是Django
会把你第一个定义的管理器当作是默认的管理器，也就是代码行中最上面定义的管理器。Django
有些其它的功能会使用到默认的管理器，为了能让它正常的工作，一种比较好的做法就是把原始默认
的管理器放在第一个定义。

Model添加方法(这部分是抄书)

和管理器的”表级别”操作相比，model的方法更像是”记录级别”的操作，不过，model的主要设计是用来
用”表级别”操作的，”记录级别”的操作往往是用来表示记录的状态的，是那些没有放在数据库表中，但是也
有意义的数据。举例说明：

from django.db import models

class Person(models.Model):
    first_name = models.CharField(max_length=50)
    last_name = models.CharField(max_length=50)
    birth_date = models.DateField()
    address = models.CharField(max_length=100)
    city = models.CharField(max_length=50)

    # 用来判读是否在baby boomer出生，可以不用放在数据库表中
    def baby_boomer_status(self):
        "Returns the person's baby-boomer status."
        import datetime
        if datetime.date(1945, 8, 1) <= self.birth_date <= datetime.date(1964, 12, 31):
            return "Baby boomer"
        if self.birth_date < datetime.date(1945, 8, 1):
            return "Pre-boomer"
        return "Post-boomer"

    # 用来返回全名，这个可以不被插入到数据库表中
    def get_full_name(self):
        "Returns the person's full name."
        return u'%s %s' % (self.first_name, self.last_name)

运行结果：

>>> p = Person.objects.get(first_name='Barack', last_name='Obama')
>>> p.birth_date
datetime.date(1961, 8, 4)
>>> p.baby_boomer_status()
'Baby boomer'
>>> p.get_full_name()
u'Barack Obama'

执行自定义SQL语句

如果你想执行自定义的SQL语句查询，可以使用django.db.connection对象：
可以使用SQL对数据库中所有的表进行操作，而不用引用特定的model类。
需要注意的是execute()函数使用的SQL语句需要使用到%s这样的格式符，而
不是直接写在里面。
这样的操作比较自由，比较好的做法是把它放在自定义管理器中：

from django.db import connection, models

class PythonBookManager(models.Manager):
    def books_titles_after_publication(self, date_string):
        cursor = connection.cursor()
        cursor.execute("""
            SELECT title
            FROM books_book
            WHERE publication_date > %s""", [date_string])
        #fetchall()返回的是元组的列表
        return [row[0] for row in cursor.fetchall()]

class Book(models.Model):
    title = models.CharField(max_length=100)
    authors = models.ManyToManyField(Author)
    publisher = models.ForeignKey(Publisher)
    publication_date = models.DateField(blank=True, null=True)
    num_pages = models.IntegerField(blank=True, null=True)

    objects = models.Manager()
    python_objects = PythonBookManager()

一些django奇技淫巧

还在搜集中，后面会加上.

一些过滤字段方法

1.多表连接查询：当我知道这点的时候顿时觉得django太NX了。

  class A(models.Model):
    name = models.CharField(u'名称')
  class B(models.Model):
    aa = models.ForeignKey(A)
B.objects.filter(aa__name__contains='searchtitle')

1.5 我叫它反向查询，后来插入记录1.5，当我知道的时候瞬间就觉得django太太太NX了。

class A(models.Model):
name = models.CharField(u'名称')
class B(models.Model):
aa = models.ForeignKey(A,related_name="FAN")
bb = models.CharField(u'名称')

查A: A.objects.filter(FAN=’XXXX’)，都知道related_name的作用，A.FAN.all()是一组以A为外键的B实例，可前面这样的用法是查询出所有(B.aa=A且B.bb=XXXX)的A实例，然后还可以通过__各种关系查找，真赤激！！！

**2.条件选取querySet的时候，filter表示=，exclude表示!=querySet.distinct() 去重复

__exact 精确等于 like 'aaa'
 __iexact 精确等于 忽略大小写 ilike 'aaa'
 __contains 包含 like '%aaa%'
 __icontains 包含 忽略大小写 ilike '%aaa%'，但是对于sqlite来说，contains的作用效果等同于icontains。
__gt 大于
__gte 大于等于
__lt 小于
__lte 小于等于
__in 存在于一个list范围内
__startswith 以...开头
__istartswith 以...开头 忽略大小写
__endswith 以...结尾
__iendswith 以...结尾，忽略大小写
__range 在...范围内
__year 日期字段的年份
__month 日期字段的月份
__day 日期字段的日
__isnull=True/False

>> q1 = Entry.objects.filter(headline__startswith="What")
>> q2 = q1.exclude(pub_date__gte=datetime.date.today())
>> q3 = q1.filter(pub_date__gte=datetime.date.today())
>>> q = q.filter(pub_date__lte=datetime.date.today())
>>> q = q.exclude(body_text__icontains="food")

即q1.filter(pub_date__gte=datetime.date.today())表示为时间>=now，q1.exclude(pub_date__gte=datetime.date.today())表示为<=now

关于缓存：
queryset是有缓存的，a = A.objects.all(),print [i for i in a].第一次执行打印会查询数据库，然后结果会被保存在queryset内置的cache中，再执行print的时候就会取自缓存。

DJANGO or 查询

Q查询——对对象的复杂查询
F查询——专门取对象中某列值的操作

Q查询
1、Q对象(django.db.models.Q)可以对关键字参数进行封装，从而更好地应用多个查询，例如：

from django.db.models import Q
from login.models import New #models对象

news=New.objects.filter(Q(question__startswith='What'))

2、可以组合使用&,|操作符，当一个操作符是用于两个Q的对象,它产生一个新的Q对象。

Q(question__startswith='Who') | Q(question__startswith='What')

3、Q对象可以用~操作符放在前面表示否定，也可允许否定与不否定形式的组合

Q(question__startswith='Who') | ~Q(pub_date__year=2005)

4、应用范围

Poll.objects.get(
Q(question__startswith='Who'),
Q(pub_date=date(2005, 5, 2)) | Q(pub_date=date(2005, 5, 6))
)

等价于

SELECT * from polls WHERE question LIKE 'Who%'
AND (pub_date = '2005-05-02' OR pub_date = '2005-05-06')

5、Q对象可以与关键字参数查询一起使用，不过一定要把Q对象放在关键字参数查询的前面。

正确：
Poll.objects.get(
Q(pub_date=date(2005, 5, 2)) | Q(pub_date=date(2005, 5, 6)),
question__startswith='Who')

错误：
Poll.objects.get(
question__startswith='Who',
Q(pub_date=date(2005, 5, 2)) | Q(pub_date=date(2005, 5, 6)))

Done!有一些粗略，但是大概能用的上的，几乎都在这里了。

参考

the dango book2.0 http://www.djangobook.com/en/2.0/