django-web框架

什么是django?

Django is a high-level Python Web framework that encourages rapid development and clean, pragmatic design. Built by experienced developers, it takes care of much of the hassle of Web development, so you can focus on writing your app without needing to reinvent the wheel. It’s free and open source.

Django是一个高级Python Web框架,它鼓励快速的开发和简洁、实用的设计。它由经验丰富的开发人员开发而成,他们负责解决大部分Web开发中的麻烦,让你能专注与应用程序的编写,而不需要重新发明轮子。它是一个免费、开源的项目。

运行环境

django只需要你安装有python环境就可以运行起来,而且它不依赖其他第三方模块,一个包就能完成网站开发。

安装

1
pip install django

Django中的MTV设计模式

MVC设计模式

MVC全名是Model View Controller,是模型(Model)-视图(View)-控制器(Controller)的缩写。

  1. Model(模型)表示应用程序核心(通常模型对象负责在数据库中存取数据)。

  2. View(视图)显示数据(通常视图是依据模型数据创建的)。

  3. Controller(控制器)处理输入(通常控制器负责从视图读取数据,控制用户输入,并向模型发送数据)。

MTV设计模式

  1. M 代表模型(Model):负责业务对象和数据库的关系映射(ORM)。

  2. T 代表模板 (Template):负责如何把页面展示给用户(html)。

  3. V 代表视图(View):负责业务逻辑,并在适当时候调用Model和Template。

除了上述三层之外,django还提供了一个URL分发器,用于将一个个URL的请求分发到对应的View处理。

django工作流程

  1. 浏览器发起请求;

  2. web server(nginx)对请求进行转发,静态文件直接访问/其他请求转发到wsgi服务器;

  3. wsgi server接收请求,将请求转发给django,并由中间件进行预处理;

  4. 预处理完的请求,被转发到URL分发器,URL分发器将请求发送给对应的View进行处理;

5a. 若请求涉及到数据库操作,则通过models对数据库进行CRUD操作,并将结果通过templates渲染返回;

5b. 若请求不涉及数据库操作,则直接返回相应的templates页面;

5d. 若操作异常,则将异常返回。

  1. View将返回的页面返回给wsgi server,wsgi server将页面返回给web server;

  2. web server将请求结果返回给浏览器。

开始一个新的django项目

初始化工程

1
django-admin startproject demo_project

初始化app

1
django-admin startapp demo_app

工程目录如下所示:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
.
├── demo_app # app目录
│   ├── admin.py # admin控制器,在使用django自带admin时使用
│   ├── apps.py
│   ├── __init__.py
│   ├── migrations
│   │   └── __init__.py
│   ├── models.py # 用于将数据库抽象化为orm对象
│   ├── tests.py # 单元测试
│   └── views.py # 用于请求逻辑的具体实现
├── demo_project
│   ├── __init__.py
│   ├── settings.py # 公共设置
│   ├── urls.py # 公共urls分发
│   └── wsgi.py # wsgi服务器接口
└── manage.py # 本地调试接口

配置

settings

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# 常用配置

# 是否启用debug模式
DEBUG = True

# 允许访问的hosts
ALLOWED_HOSTS = []

# 加载的APPS列表
INSTALLED_APPS = []

# 中间件
MIDDLEWARE = []

# URL分发入口
ROOT_URLCONF = ''

# 指定templates路径
TEMPLATES = []

# wsgi服务器入口
WSGI_APPLICATION = ''

# 数据库配置
DATABASES = {}

# 默认语言设置
LANGUAGE_CODE = 'en-us'

# 时区设置
TIME_ZONE = 'UTC'

# 静态文件前缀设置
STATIC_URL = '/static/'

初始化数据库/配置admin账户

1
2
3
4
5
6
7
8
9
10
11
12
# 初始化数据库
python manage.py makemigrations
python manage.py migrate

# 创建admin帐号
python manage.py createsuperuser

Username (leave blank to use 'wuyue'): admin
Email address: admin@qq.com
Password:
Password (again):
Superuser created successfully.

运行django,http://127.0.0.1:8000

1
2
# 默认url http://127.0.0.1:8000
python manage.py runserver

admin后台

认证模块介绍

  1. 用户

username : 用户名

password : 密码

first_name : 名字

last_name : 姓氏

email : 电子邮箱

is_superuser : 标识是否为超级用户

is_staff : 标识是否能登录本后台

is_active : 标识账户活跃状态

permission : 用户权限

group : 用户所属用户组

last_login : 最后一次登录

date_joined : 加入时间

name : 组名称

permission : 权限

models设置

以简单的个人博客后台为例:

  1. 总共三个表,文章/分类/标签;

  2. 表关系:文章和分类(一对多),文章和标签(多对多)。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
# -*- coding: utf-8 -*-
from __future__ import unicode_literals

from django.db import models

# Create your models here.

class Article(models.Model):
title = models.CharField(max_length=255, verbose_name="标题")
content = models.TextField(verbose_name="内容")
category = models.ForeignKey('Category', verbose_name="分类")
tag = models.ManyToManyField('tag', verbose_name="标签")
is_published = models.BooleanField(default=False, verbose_name="发布状态")
update_time = models.DateTimeField(verbose_name="更新时间")
dateline = models.DateTimeField(auto_now=True, verbose_name="创建时间")

def __unicode__(self):
return "%s" % self.title

class Meta:
verbose_name = "文章"
verbose_name_plural = verbose_name

class Category(models.Model):
category = models.CharField(max_length=255, verbose_name="分类")
desc = models.TextField(verbose_name="描述")

def __unicode__(self):
return "%s" % self.category

class Meta:
verbose_name = "分类"
verbose_name_plural = verbose_name

class Tag(models.Model):
tag = models.CharField(max_length=255, verbose_name="标签")

def __unicode__(self):
return "%s" % self.tag

class Meta:
verbose_name = "标签"
verbose_name_plural = verbose_name

admin设置

  1. 将model注册到admin后台;

  2. 控制model展示到admin的字段及形式。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# -*- coding: utf-8 -*-
from __future__ import unicode_literals

from django.contrib import admin
from .models import Article, Category, Tag

# Register your models here.

@admin.register(Article)
class ArticleAdmin(admin.ModelAdmin):
list_display = ('title', 'category', 'is_published', 'update_time',
'dateline')
list_filter = ('category__category',)
search_fields = ('title',)
actions = ['make_published']

def make_published(self, request, queryset):
queryset.update(is_published=1)

make_published.short_description = "发布所选的 文章"

@admin.register(Category)
class CategoryAdmin(admin.ModelAdmin):
list_display = ('category', 'desc')

@admin.register(Tag)
class TagAdmin(admin.ModelAdmin):
pass

django连接多个数据库

添加数据库连接配置

  1. 选择合适的engine,django支持的数据库(sqlite3, mysql, postgreSQL, oracle);

  2. 设置数据库连接的相关参数。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
},
xxx: {
'ENGINE': 'django.db.backends.mysql',
'NAME': xxx,
'USER': xxx,
'PASSWORD': xxx,
'HOST': xxx,
'PORT': '3306',
},
}

新增一个app,并添加到INSTALLED_APPS中

添加路由组件及数据库app对应的MAPPING

  1. 添加路由组件;

  2. 添加MAPPING。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
# 路由组件 path=工程目录/database_router.py

#!/usr/bin/env python
# -*- coding: utf-8 -*-

from django.conf import settings

DATABASE_MAPPING = settings.DATABASE_APPS_MAPPING

class DatabaseAppsRouter(object):
"""
A router to control all database operations on models for different
databases.

In case an app is not set in settings.DATABASE_APPS_MAPPING, the router
will fallback to the `default` database.

Settings example:

DATABASE_APPS_MAPPING = {'app1': 'db1', 'app2': 'db2'}
"""

def db_for_read(self, model, **hints):
""""Point all read operations to the specific database."""
if model._meta.app_label in DATABASE_MAPPING:
return DATABASE_MAPPING[model._meta.app_label]
return None

def db_for_write(self, model, **hints):
"""Point all write operations to the specific database."""
if model._meta.app_label in DATABASE_MAPPING:
return DATABASE_MAPPING[model._meta.app_label]
return None

def allow_relation(self, obj1, obj2, **hints):
"""Allow any relation between apps that use the same database."""
db_obj1 = DATABASE_MAPPING.get(obj1._meta.app_label)
db_obj2 = DATABASE_MAPPING.get(obj2._meta.app_label)
if db_obj1 and db_obj2:
if db_obj1 == db_obj2:
return True
else:
return False
return None

def allow_syncdb(self, db, model):
"""Make sure that apps only appear in the related database."""

if db in DATABASE_MAPPING.values():
return DATABASE_MAPPING.get(model._meta.app_label) == db
elif model._meta.app_label in DATABASE_MAPPING:
return False
return None

# 数据库app的MAPPING

DATABASE_ROUTERS = ['database_router.DatabaseAppsRouter']
DATABASE_APPS_MAPPING = {
# example:
# 'app_name':'database_name',
'default': 'default',
xxx: xxx,
}

抽象化表结构,生成models

1
python manage.py inspectdb --database=database table

django常用的第三方扩展

django-suit ​

基于bootstrap的后台管理主题,并集成了一些扩展功能,使admin的使用更灵活。

djcelery

许多Django应用需要执行异步任务, 以便不耽误http request的执行. 我们也可以选择许多方法来完成异步任务, 使用Celery是一个比较好的选择, 因为Celery有着大量的社区支持, 能够完美的扩展, 和Django结合的也很好. 并且djcelery允许我们通过界面管理任务,使任务定时执行。

django-rest-framework

Django REST framework 是一个强大且灵活的工具包,用以构建Web APIs。

为什么要使用REST framework? 

haystack

haystack是一个第三发Django的搜索模块。它的特点是一个统一的、熟悉的API允许你使用不同的搜索后端(如Solr,Elasticsearch,Whoosh,Xapian,等)而不需要修改你的代码。