Django之路：QuerySet API，后台和表单

时间 2019-11-12

标签 django 之路 queryset api 后台表单栏目 Python 繁體版

原文原文链接

1、Django QuerySet API

Django模型中咱们学习了一些基本的建立和查询。这里专门讲如下数据库接口相关的接口（QuerySet API），固然你也能够选择暂时跳过这节。若是之后用到数据库相关的时候也能够在看看。html

从数据库中查询出来的结果通常是一个集合，这个集合叫作QuerySet。python

文中的例子大部分是基于这个blog/models.pyreact

from django.db import models
 
 
class Blog(models.Model):
    name = models.CharField(max_length=100)
    tagline = models.TextField()
 
    def __unicode__(self):  # __str__ on Python 3
        return self.name
 
class Author(models.Model):
    name = models.CharField(max_length=50)
    email = models.EmailField()
 
    def __unicode__(self):  # __str__ on Python 3
        return self.name
 
class Entry(models.Model):
    blog = models.ForeignKey(Blog)
    headline = models.CharField(max_length=255)
    body_text = models.TextField()
    pub_date = models.DateField()
    mod_date = models.DateField()
    authors = models.ManyToManyField(Author)
    n_comments = models.IntegerField()
    n_pingbacks = models.IntegerField()
    rating = models.IntegerField()
 
    def __unicode__(self):  # __str__ on Python 3
        return self.headline

一、QuerySet 建立对象的方法正则表达式

>>> from blog.models import Blog
>>> b = Blog(name='Beatles Blog', tagline='All the latest Beatles news.')
>>> b.save()
 
总之，一共有四种方法
# 方法 1
Author.objects.create(name="wulaoer", email="wulaoer@163.com")
 
# 方法 2
twz = Author(name="wulaoer", email="wulaoer@163.com")
twz.save()
 
# 方法 3
twz = Author()
twz.name="wulaoer"
twz.email="wulaoer@163.com"
 
# 方法 4，首先尝试获取，不存在就建立，能够防止重复
Author.objects.get_or_create(name="wulaoer", email="wulaoer@163.com")
# 返回值(object, True/False)

备注：前三种方法返回的都是对应的object，最后一种方法返回的是一个元组，（object，True/False），建立时返回True，已经存在时返回False数据库

当有一对多，多对一，或者多对多的关系的时候，先把相关的对象查询出来django

>>> from blog.models import Entry
>>> entry = Entry.objects.get(pk=1)
>>> cheese_blog = Blog.objects.get(name="Cheddar Talk")
>>> entry.blog = cheese_blog
>>> entry.save()

二、获取对象的方法（上一篇的部分代码）服务器

Person.objects.all() # 查询全部
Person.objects.all()[:10] 切片操做，获取10我的，不支持负索引，切片能够节约内存，不支持负索引，后面有相应解决办法，第7条
Person.objects.get(name="wulaoer") # 名称为 wulaoer 的一条，多条会报错
 
get是用来获取一个对象的，若是须要获取知足条件的一些人，就要用到filter
Person.objects.filter(name="abc") # 等于Person.objects.filter(name__exact="abc") 名称严格等于 "abc" 的人
Person.objects.filter(name__iexact="abc") # 名称为 abc 可是不区分大小写，能够找到 ABC, Abc, aBC，这些都符合条件
 
Person.objects.filter(name__contains="abc") # 名称中包含 "abc"的人
Person.objects.filter(name__icontains="abc") #名称中包含 "abc"，且abc不区分大小写
 
Person.objects.filter(name__regex="^abc") # 正则表达式查询
Person.objects.filter(name__iregex="^abc")# 正则表达式不区分大小写
 
# filter是找出知足条件的，固然也有排除符合某条件的
Person.objects.exclude(name__contains="WZ") # 排除包含 WZ 的Person对象
Person.objects.filter(name__contains="abc").exclude(age=23) # 找出名称含有abc, 可是排除年龄是23岁的

三、QuerySet是可迭代的，好比：session

es = Entry.objects.all()
for e in es:
    print(e.headline)

Entry.objects.all()或者es就是QuerySet是查询全部的Entry条目。app

注意事项：函数

(1)、若是只是检查Entry中是否有对象，应该用Entry.objects.all().exists()

(2)、QuerySet支持切片Entry.objects.all()[:10]取出10条，能够节省内存

(3)、用len(es)能够获得Entry的数量，可是推荐用Entry.objects.count()来查询数量，后者用的是SQL: SELECT COUNT(*)

(4)、list(es)能够强行将QuerySet变成列表

四、QuerySet是能够用pickel序列化到硬盘读取出来的

>>> import pickle
>>> query = pickle.loads(s)     # Assuming 's' is the pickled string.
>>> qs = MyModel.objects.all()
>>> qs.query = query            # Restore the original 'query'.

五、QuerySet查询结果排序

做者按照名称排序

Author.objects.all().order_by('name')
Author.objects.all().order_by('-name') # 在 column name 前加一个负号，能够实现倒序

六、QuerySet支持链式查询

Author.objects.filter(name__contains="wulaoer").filter(email="wulaoer@163.com")
Author.objects.filter(name__contains="wu").exclude(email="wulaoer@163.com")
 
# 找出名称含有abc, 可是排除年龄是23岁的
Person.objects.filter(name__contains="abc").exclude(age=23)

七、QuerySet不支持负索引

Person.objects.all()[:10] 切片操做，前10条
Person.objects.all()[-10:] 会报错！！！
 
# 1. 使用 reverse() 解决
Person.objects.all().reverse()[:2] # 最后两条
Person.objects.all().reverse()[0] # 最后一条
 
# 2. 使用 order_by，在栏目名（column name）前加一个负号
Author.objects.order_by('-id')[:20] # id最大的20条

八、QuerySet重复的问题，使用.distinct()去重

通常的状况下，QuerySet中不会出来重复的，重复是很罕见的，可是当跨越多张表进行检索后，结果并到一块儿，能够回出来重复的值(我最近就遇到过这样的问题)

qs1 = Pathway.objects.filter(label__name='x')
qs2 = Pathway.objects.filter(reaction__name='A + B >> C')
qs3 = Pathway.objects.filter(inputer__name='wulaoer')
 
# 合并到一块儿
qs = qs1 | qs2 | qs3
这个时候就有可能出现重复的
 
# 去重方法
qs = qs.distinct()

Django 后台

django的后台咱们只要加少些代码，就能够实现强大的功能。

与后台相关文件：每一个app中的admn.py文件与后台相关。

下面示例是作一个后台添加博客文章的例子：

1、新建一个名称问wlr_admin的例子：

django-admin.py startproject wlr_admin

2、新建一个叫作blog的app

# 进入 wlr_admin 文件夹
cd wlr_admin
 
# 建立 blog 这个 app
python manage.py startapp blog

注意：不一样版本的Django建立project和app出来的文件会有一些不一样

3、修改blog文件夹中的models.py　　

# coding:utf-8
from django.db import models
 
 
class Article(models.Model):
    title = models.CharField(u'标题', max_length=256)
    content = models.TextField(u'内容')
 
    pub_date = models.DateTimeField(u'发表时间', auto_now_add=True, editable = True)
    update_time = models.DateTimeField(u'更新时间',auto_now=True, null=True)

4、把blog加入到settings.py中的INSTALLED_APPS中

INSTALLED_APPS = (
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
 
    'blog',
)

提示：INSTALLED_APPS是一个元组，每次加入新的app的时候，在后面都加一个逗号，这是一个好习惯。

5、同步全部的数据表

# 进入包含有 manage.py 的文件夹
python manage.py syncdb
 
注意：Django 1.7及以上的版本须要用如下命令
python manage.py makemigrations
python manage.py migrate

能够看到：

E:\wlr_admin>python manage.py syncdb
Creating tables ...
Creating table django_admin_log
Creating table auth_permission
Creating table auth_group_permissions
Creating table auth_group
Creating table auth_user_groups
Creating table auth_user_user_permissions
Creating table auth_user
Creating table django_content_type
Creating table django_session
Creating table blog_article

You just installed Django's auth system, which means you don't have any superusers defined.
Would you like to create one now? (yes/no): yes
Username (leave blank to use 'administrator'): wu
Email address:
Password:
Password (again):
Superuser created successfully.
Installing custom SQL ...
Installing indexes ...
Installed 0 object(s) from 0 fixture(s)

若是是Django不主动提示建立管理员（Django 1.9不提示）用下面的命令建立一个账号

python manage.py createsuperuser

6、修改admin.py

进入blog文件夹，修改admin.py文件（若是没有新建一个），内容以下：

from django.contrib import admin
from .models import Article
 
 
admin.site.register(Article)

只须要这三行代码，咱们就能够拥有一个强大的后台！

提示：urls.py中关于admin的已经默认开启。

7、打开开发服务器

python manage.py runserver
# 若是提示 8000 端口已经被占用，能够用 python manage.py runserver 8001 以此类推

访问http://127.0.0.1:8000/admin/输入设定的账号和密码，就能够看到：

点击Articles，动手输入添加几篇文章，就能够看到:

添加文章

根据须要选择保存方式。

建立两个文章看看。发现全部的文章都是叫Article object，这样确定很差，若是咱们要是修改，确定不知道要修改哪一个。

咱们修改如下blog中的models.py

# coding:utf-8
from django.db import models

# Create your models here.
class Article(models.Model):
    title = models.CharField(u'标题', max_length=256)
    content = models.TextField(u'内容')

    pub_date = models.DateTimeField(u'发表时间', auto_now_add=True, editable = True)
    update_time = models.DateTimeField(u'更新时间',auto_now=True, null=True)
    def __unicode__(self):# 在Python3中用 __str__ 代替 __unicode__
        return self.title

加了一个__unicode__函数，刷新后台网页，会看到：

因此推荐定义model的时候写一个__unicdoe__函数（或__str__函数）

技能提高：如何兼容python 2.x和python 3.x呢？

示例以下：

# coding:utf-8
from __future__ import unicode_literals
 
from django.db import models
from django.utils.encoding import python_2_unicode_compatible
 
@python_2_unicode_compatible
class Article(models.Model):
    title = models.CharField('标题', max_length=256)
    content = models.TextField('内容')
 
    pub_date = models.DateTimeField('发表时间', auto_now_add=True, editable = True)
    update_time = models.DateTimeField('更新时间',auto_now=True, null=True)
 
    def __str__(self):
        return self.title

python_2_unicode_compatible会自动作一些处理去适应python不一样版本，本例中的unicode_literals可让python 2.x也像python 3那个处理unicode字符，以便有更好地兼容性。

8、在列表显示与字段相关的其余内容

后台已经基本上作出来了，但是若是咱们还须要显示一些其余的fields，如何作呢？

from django.contrib import admin
from .models import Article
 
class ArticleAdmin(admin.ModelAdmin):
    list_display = ('title','pub_date','update_time',)
 
admin.site.register(Article,ArticleAdmin)

list_display就是来配置要显示的字段的，固然也能够显示非字段内容，或者字段相关的内容，好比：

class Person(models.Model):
    first_name = models.CharField(max_length=50)
    last_name = models.CharField(max_length=50)
 
    def my_property(self):
        return self.first_name + ' ' + self.last_name
    my_property.short_description = "Full name of the person"
 
    full_name = property(my_property)

在admin.py中

from django.contrib import admin
from .models import Article, Person
 
 
class ArticleAdmin(admin.ModelAdmin):
    list_display = ('title', 'pub_date', 'update_time',)
 
 
class PersonAdmin(admin.ModelAdmin):
    list_display = ('full_name',)
 
admin.site.register(Article, ArticleAdmin)
admin.site.register(Person, PersonAdmin)

到这里咱们发现咱们又有新的需求，好比要改models.py中的字段，添加一个文章的状态。这时候咱们就须要改表，django1.7之前的都不会自动更改表，咱们须要用第三方插件South，参见Django迁移数据。

Django 1.7及以上用如下命令来同步数据库表的更改

python manage.py makemigrations
python manage.py migrate

本节代码下载：

zqxt_admin (Django 1.6).zip (基于Django 1.6，后台账号 tu 密码 zqxt)

zqxt_admin (Django 1.9).zip (基于 Django 1.9 后台账号 tu 密码 ziqiangxuetang)

其余一些经常使用的功能：

搜索功能：search_fields = ('title', 'content',) 这样就能够按照标题或内容搜索了　　

https://docs.djangoproject.com/en/dev/ref/contrib/admin/#django.contrib.admin.ModelAdmin.search_fields

筛选功能：list_filter = ('status',) 这样就能够根据文章的状态去筛选，好比找出是草稿的文章

https://docs.djangoproject.com/en/dev/ref/contrib/admin/#django.contrib.admin.ModelAdmin.list_filter

新增或修改时的布局顺序：https://docs.djangoproject.com/en/dev/ref/contrib/admin/#django.contrib.admin.ModelAdmin.fieldsets

有时候咱们须要对django admin site进行修改以知足本身的需求，那么咱们能够从那些地方入手呢？

如下举例说明：

一、定制加载的列表，根据不一样的人显示不一样的内容列表，好比输入员只能看见本身输入的，审核员能看到全部的草稿，这时候就须要重写get_queryset方法

class MyModelAdmin(admin.ModelAdmin):
    def get_queryset(self, request):
        qs = super(MyModelAdmin, self).get_queryset(request)
        if request.user.is_superuser:
            return qs
        else:
            return qs.filter(author=request.user)

该类实现的功能是若是是超级管理员就列出全部的，若是不是，就仅列出访问者本身相关的

二、定制搜索功能（django 1.6及以上才有）

class PersonAdmin(admin.ModelAdmin):
    list_display = ('name', 'age')
    search_fields = ('name',)
 
    def get_search_results(self, request, queryset, search_term):
        queryset, use_distinct = super(PersonAdmin, self).get_search_results(request, queryset, search_term)
        try:
            search_term_as_int = int(search_term)
            queryset |= self.model.objects.filter(age=search_term_as_int)
        except:
            pass
        return queryset, use_distinct

queryset是默认的结果，search_term是在后台搜索的关键词

三、修改保存时的一些操做，能够检查用户，保存的内容等，好比保存时加上添加人

from django.contrib import admin
 
class ArticleAdmin(admin.ModelAdmin):
    def save_model(self, request, obj, form, change):
        obj.user = request.user
        obj.save()

其中obj是修改后的对象，form是返回的表单（修改后的），当新建一个对象时change = False,当修改一个对象时change = True

若是须要获取修改前的对象的内容能够用

from django.contrib import admin
 
class ArticleAdmin(admin.ModelAdmin):
    def save_model(self, request, obj, form, change):
        obj_original = self.model.objects.get(pk=obj.pk)
        obj.user = request.user
        obj.save()

那么又有问题了，这里若是原来的obj不存在，也就是若是咱们是新建的一个怎么办呢，这个时候能够用try,except的方法尝试获取，固然更好的方法是判断如下这个对象是新建仍是修改，是新建就没有obj_original，是修改就有

from django.contrib import admin
 
class ArticleAdmin(admin.ModelAdmin):
    def save_model(self, request, obj, form, change):
        if change:# 更改的时候
            obj_original = self.model.objects.get(pk=obj.pk)
        else:# 新增的时候
            obj_original = None
 
        obj.user = request.user
        obj.save()

四、删除时作一些处理。

from django.contrib import admin
 
class ArticleAdmin(admin.ModelAdmin):
    def delete_model(self, request, obj):
        """
        Given a model instance delete it from the database.
        """
        # handle something here
        obj.delete()

Django 表单

有时候咱们须要在前台用get或post方法提交一些数据，因此本身写一个网页，用到hetml表单的知识。

第一节：源码下载zqxt_form_learn1.zip　　

好比写一个计算a和b之和的简单应用，网页上这么写

<!DOCTYPE html>
<html>
<body>
<p>请输入两个数字</p>
 
 
<form action="/add/" method="get">
    a: <input type="text" name="a"> <br>
    b: <input type="text" name="b"> <br>
     
    <input type="submit" value="提交">
</form>
 
 
</body>
</html>

把这些代码保存成一个index.html，放在templates文件夹中。

网页的值传到服务器是经过<input>或<textarea>标签中的name属性来传递的，在服务器端这么接收：

from django.http import HttpResponse
from django.shortcuts import render
 
def index(request):
    return render(request, 'index.html')
     
def add(request):
    a = request.GET['a']
    b = request.GET['b']
    a = int(a)
    b = int(b)
    return HttpResponse(str(a+b))

request.GET能够当作一个字典，用GET方法传递的值都会保存到其中，能够用request.GET.get('key', None)来取值，没有时不报错。

在将函数和网址对应上，就能够访问了，详情参见源码。

这样就完成了基本的功能，基本上能够用了。

可是，好比用户输入的不是数字，而是字母，就出错了，还有就是提交后再回来已经输入的数据也会没了。

固然若是咱们手动将输入以后的数据在views中都获取到再传递到网页，这样是可行的，可是很不方便，若是Django提供了更方便简易的forms来解决验证等这一系列的问题。

第二节，使用Django的表单（forms）

例子足够简单，可是能说明问题

源码下载：zqxt_forms.zip

新建一个 zqxt_form2 项目
django-admin.py startproject zqxt_form2
# 进入到 zqxt_form2 文件夹，新建一个 tools APP
python manage.py startapp tools

在tools文件夹中新建一个forms.py文件

from django import forms
 
class AddForm(forms.Form):
    a = forms.IntegerField()
    b = forms.IntegerField()

咱们的视图函数views.py中

# coding:utf-8
from django.shortcuts import render
from django.http import HttpResponse
 
# 引入咱们建立的表单类
from .forms import AddForm
 
def index(request):
    if request.method == 'POST':# 当提交表单时
     
        form = AddForm(request.POST) # form 包含提交的数据
         
        if form.is_valid():# 若是提交的数据合法
            a = form.cleaned_data['a']
            b = form.cleaned_data['b']
            return HttpResponse(str(int(a) + int(b)))
     
    else:# 当正常访问时
        form = AddForm()
    return render(request, 'index.html', {'form': form})

对应的模版文件index.html

<form method='post'>
{% csrf_token %}
{{ form }}
<input type="submit" value="提交">
</form>

再在urls.py中对应写上这个函数

from django.conf.urls import patterns, include, url
 
from django.contrib import admin
admin.autodiscover()
 
urlpatterns = patterns('',
    # 注意下面这一行
    url(r'^$', 'tools.views.index', name='home'),
    url(r'^admin/', include(admin.site.urls)),
)

新手可能以为这样变得更麻烦了，有些状况是这样的，可是Django的forms提供了：

一、模版中表单的渲染

二、数据的验证工做，某一些输入不合法也不会丢失已经输入的数据。

三、还能够定制更复杂的验证工做，若是提供了10个输入框，必需要输入其中两个以上，在forms.py中都很容易实现