文章目录

Django框架的介绍

Django的安装

Django框架开发

  • 项目创建
  • 目录结构
  • settings 文件介绍
  • URL 介绍
  • Django 中的路由配置
  • 视图函数(view)
  • 带有分组的路由和视图函数
  • 带有命名分组的路由和视图函数
  • HTTP协议的请求和响应
  • HTTP 请求
  • HTTP 响应
  • GET方式传参
  • POST传递参数
  • form 表单的name属性

Django框架的介绍

  • 2005年发布,采用Python语言编写的开源web框架
  • 早期时候的Django主做新闻和内容管理
  • 一个重量级的 Python Web框架,Django 配备了常用的大部分组件
1. 基本配置
2. 路由系统
3. 原生HTML模板系统
4. 视图 view
5. Model模型,数据库连接和ORM数据库管理
6. 中间件
7. Cookie & Session
8. 分页
9. 数据库后台管理系统admin
  • Django的用途
* 网站后端开发
* 微信公众号、微信小程序等后台开发
* 基于HTTP/HTTPS协议的后台服务器开发
	- 在线语音/图像识别服务器
	- 在线第三方身份验证服务器等
  • Django的官网
* 官方网址: <http://www.djangoproject.com>
* 中文文档(第三方):
	- <https:///>
	- <http://djangobook.py3k.cn/>
* Django的离线文档
	- 解压缩数据包 `django-docs-1.11-en.zip`
	- 用浏览器打开 `django-docs-1.11-en/index.html`

Django的安装

  • 查看已安装的版本
import django
django.VERSION
  • 安装
1. 在线安装
   $ sudo pip3 install django  安装django的最新版本
   $ sudo pip3 install django==1.11.8 安装django的指定版本   
2. 离线安装
   * 下载安装包
   * 安装离线包
       $ tar -xvf Django-1.11.8.tar.gz
       $ cd Django-1.11.8
       $ sudo python3 setup.py install
3. 用wheel离线安装
   * 下载安装包:
	   $ pip3 download -d django_packs django==1.11.8
   * 安装离线包
       $ pip3 install Django-1.11.8.whl
  • Django的卸载
$ pip3 uninstall django
  • Django 的开发环境
Django 1.11.x 支持 Python 2.7, 3.4, 3.5 和 3.6(长期支持版本 LTS)
注: Django 1.11.x 不支持 Python 3.7

Django框架开发

项目创建

  • $ django-admin startproject 项目名称
$ django-admin startproject mysite
  • 运行
$ cd mysite
$ python3 manage.py  # 查看命令
$ python3 manage.py runserver
$ python3 manage.py runserver 5000  # 指定只能使用127.0.0.1的5000端口访问本机
  • 启动时报错 The port already in use
解决方案:
1. ps aux | grep 'runserver' 过滤出之前启动的Django进程
2. sudo kill -9 进程id(PID)

目录结构

  • 示例:
$ django-admin startproject mysite
$ tree
mysite/
├── manage.py
└── mysite
    ├── __init__.py
    ├── settings.py
    ├── urls.py
    └── wsgi.py

1 directory, 5 files
  • 项目目录结构解析:
  • manage.py:此文件是项目管理的主程序,在开发阶段用于管理整个项目的开发运行和调试
manage.py 包含项目管理的子命令, 如:
- python3 manage.py runserver 启动服务
- python3 manage.py startapp 创建应用
- python3 manage.py migrate 数据库迁移
- ...
  • mysite :项目包的主文件夹(默认与项目名称一致)
1. __init__.py:包初始化文件,当此项目包被导入(import)时此文件会自动运行
2. wsgi.py
	- WSGI 即 Web Server Gateway Interface
	- WEB服务网关接口的配置文件,仅部署项目时使用
3. urls.py:项目的基础路由配置文件,所有的动态路径必须先走该文件进行匹配
4. settings.py
	- Django项目的配置文件, 此配置文件中的一些全局变量将为Django框架的运行传递一些参数
	- 启动服务时配置文件自动调用
	- 此配置文件中也可以定义一些自定义的变量用于作用全局作用域的数据传递
settings 文件介绍

https://docs.djangoproject.com/en/1.11/ref/settings/

  1. BASE_DIR 用于绑定当前项目的绝对路径(动态计算出来的), 所有文件都可以依赖此路径
  2. import os
    BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
  3. DEBUG 用于配置Django项目的启用模式
  4. 取值:
    1. True 表示开发环境中使用 `调试模式`(用于开发中)
    	- 检测到代码修改后,即刻重启进程,修改部分立即生效
    	- 所有报错都有相应提示信息显示在浏览器中
    2. False 表示当前项目运行在`生产环境中`(不启用调试)
  5. ALLOWED_HOSTS 设置允许访问到本项目的网络地址列表
  6. 取值:
    1. [] 空列表,表示只有请求头中host为`127.0.0.1`, `localhost`能访问本项目
    2. ['*'],表示任何请求头的host都能访问到当前项目
    3. ['192.168.1.3', '127.0.0.1'] 表示只有当前两个host头的值能访问当前项目
  7. 注意: 如果要在局域网其它主机也能访问此主机,启动方式应使用如下模式:python3 manage.py runserver 0.0.0.0:5000 # 指定网络设备所有主机都可以通过5000端口访问(需加ALLOWED_HOSTS = ['*'])
  8. INSTALLED_APPS 指定当前项目中安装的应用列表
  9. MIDDLEWARE 用于注册中间件
  10. TEMPLATES 用于指定模板的配置信息
  11. DATABASES 用于指定数据库的配置信息
  12. LANGUAGE_CODE 用于指定语言配置
  13. 取值:
    - 英文 : "en-us"
    - 中文 : "zh-Hans"
  14. TIME_ZONE 用于指定当前服务器端时区
  15. 取值:
    - 世界标准时间: "UTC"
    - 中国时区: "Asia/Shanghai"
  16. ROOT_URLCONF 用于配置根级 url 配置
  17. ROOT_URLCONF = 'mysite1.urls'
  18. 注: 此模块可以通过 from django.conf import settings 导入和使用
URL 介绍
  • url 即统一资源定位符 Uniform Resource Locator
  • 作用:用来表示互联网上某个资源的地址
  • 说明:互联网上的每个文件都有一个唯一的URL,它包含的信息指出文件的位置以及浏览器应该怎么处理它
  • URL的一般语法格式为:
protocol :// hostname[:port] / path [?query][#fragment]
  • protocol(协议)
http 通过 HTTP 访问该资源。 格式 `HTTP://`
https 通过安全的 HTTPS 访问该资源。 格式 `HTTPS://`
file 资源是本地计算机上的文件。格式: `file:///`
...
  • hostname(主机名) 是指存放资源的服务器的域名系统(DNS) 主机名、域名 或 IP 地址
  • port(端口号) 整数,可选,省略时使用方案的默认端口 各种传输协议都有默认的端口号,如http的默认端口为80
  • path(路由地址) 由零或多个“/”符号隔开的字符串,一般用来表示主机上的一个目录或文件地址 路由地址决定了服务器端如何处理这个请求
  • query(查询) 可选,用于给动态网页传递参数,可有多个参数,用“&”符号隔开,每个参数的名和值用“=”符号隔开
  • fragment(信息片断) 字符串,用于指定网络资源中的片断。例如一个网页中有多个名词解释,可使用fragment直接定位到某一名词解释[锚点]
  • 注: [] 代表其中的内容可省略
Django 中的路由配置
  • settings.py 中的ROOT_URLCONF 指定了主路由配置列表urlpatterns的文件位置
  • urls.py 主路由配置文件
# file : <项目名>/urls.py
urlpatterns = [
	url(r'^admin/', admin.site.urls),
	...  # 此处配置主路由
]

urlpatterns 是一个路由-视图函数映射关的列表,此列表的映射关系由url函数来确定

  • url() 函数
  • 用于描述路由与视图函数的对应关系
  • 模块: from django.conf.urls import url
  • 语法:
url(regex, views, name=None)
参数:
    - regex: 字符串类型,匹配的请求路径,允许是正则表达式
    - views: 指定路径所对应的视图处理函数的名称
    - name: 为地址起别名,在模板中地址反向解析时使用
视图函数(view)
  • 视图函数是用于接收一个浏览器请求并通过HttpResponse对象返回数据的函数。此函数可以接收浏览器请求并根据业务逻辑返回相应的内容给浏览器
  • 视图处理的函数的语法格式:
def xxx_view(request[, 其它参数...]):
    return HttpResponse对象
  • 参数: request用于绑定HttpRequest对象,通过此对象可以获取浏览器的参数和数据
  • 示例:
# file : <项目名>/views.py
from django.http import HttpResponse
def page1_view(request):
	html = "<h1>这是第1个页面</h1>"
return HttpResponse(html)
带有分组的路由和视图函数
  • 在视图函数内,可以用正则表达式分组 () 提取参数后用函数位置传参传递给视图函数
  • 一个分组表示一个参数,多个参数需要使用多个分组,并且使用个/隔开
http://127.0.0.1:8000/year/2018
http://127.0.0.1:8000/year/2019
http://127.0.0.1:8000/year/????  # 四位数字
带有命名分组的路由和视图函数
  • 在url 的正则表达式中可以使用命名分组(捕获分组)
  • 说明:在视图函数内,可以用正则表达式分组 (?P<name>pattern) 提取参数后用函数关键字传参传递给视图函数
# file : <项目名>/urls.py
urlpatterns = [
url(r'^admin/', admin.site.urls),
# http://127.0.0.1:8000/person/xiaoming/20
# http://127.0.0.1:8000/person/xiaolan/9
url(r'^person/(?P<name>\w+)/(?P<age>\d{1,2})',views.person_view),
]
# file : <项目名>/views.py
def person_view(request, name, age):
	...

HTTP协议的请求和响应

  • 请求是指浏览器端通过HTTP协议发送给服务器端的数据
  • 响应是指服务器端接收到请求后做相应的处理后再回复给浏览器端的数据

HTTP 请求

根据HTTP标准,HTTP请求可以使用多种请求方法

  • HTTP1.0定义了三种请求方法: GET, POST 和 HEAD方法(最常用)
  • HTTP1.1新增了五种请求方法:OPTIONS, PUT, DELETE, TRACE 和 CONNECT 方法。

方法

描述

GET

请求指定的页面信息,并返回实体主体[查询]

HEAD

类似于get请求,只不过返回的响应中没有具体的内容,用于获取报头

POST

向指定资源提交数据进行处理请求(例如提交表单或者上传文件)。数据被包含在请求体中。POST请求可能会导致新的资源的建立和/或已有资源的修改[插入]

PUT

从客户端向服务器传送的数据取代指定的文档的内容[更新]

DELETE

请求服务器删除指定的页面[删除]

CONNECT

HTTP/1.1协议中预留给能够将连接改为管道方式的代理服务器

OPTIONS

允许客户端查看服务器的性能

TRACE

回显服务器收到的请求,主要用于测试或诊断

  • HttpRequest对象
  • 视图函数的第一个参数是HttpRequest对象
  • 服务器接收到http协议的请求后,会根据请求数据报文创建HttpRequest对象
  • HttpRequest属性
  • path_info: URL字符串
  • method:字符串,表示HTTP请求方法,常用值:‘GET’、‘POST’
  • encoding:字符串,表示提交的数据的编码方式
  • 如果为None则表示使用浏览器的默认设置,一般为’utf-8’
  • 这个属性是可写的,可以通过修改它来修改访问表单数据使用的编码,接下来对属性的任何访问将使用新的encoding值
  • GET:QueryDict查询字典的对象[类字典对象],包含get请求方式的所有数据
print('GET is:', request.GET)
# GET is: <QueryDict: {'a': ['1'], 'b': ['2']}>
  • POST:QueryDict查询字典的对象,包含post请求方式的所有数据
  • FILES:类似于字典的对象,包含所有的上传文件信息
  • COOKIES:Python字典,包含所有的cookie,键和值都为字符串
  • session:似于字典的对象,表示当前的会话
  • body: 字符串,请求体的内容(POST或PUT)
  • environ: 字符串,客户端运行的环境变量信息
  • scheme : 请求协议(‘http’/‘https’)
  • request.get_full_path() : 请求的完整路径
  • request.get_host() : 请求的主机
  • request.META : 请求中的元数据(消息头)
  • request.META[‘REMOTE_ADDR’] : 客户端IP地址

HTTP 响应

  • 当浏览者访问一个网页时,浏览者的浏览器会向网页所在服务器发出请求。当浏览器接收并显示网页前,此网页所在的服务器会返回一个包含HTTP状态码的信息头用以响应浏览器的请求。
  • HTTP状态码的英文为HTTP Status Code。
  • 常见的HTTP状态码:
  • 200 - 请求成功
  • 301 - 资源(网页等)被永久转移到其它URL
  • 404 - 请求的资源(网页等)不存在
  • 500 - 内部服务器错误
  • HTTP状态码分类 HTTP状态码由三个十进制数字组成,第一个十进制数字定义了状态码的类型,后两个数字没有分类的作用。HTTP状态码共分为5种类型:

分类

分类描述

1**

信息,服务器收到请求,需要请求者继续执行操作

2**

成功,操作被成功接收并处理

3**

重定向,需要进一步的操作以完成请求

4**

客户端错误,请求包含语法错误或无法完成请求

5**

服务器错误,服务器在处理请求的过程中发生了错误

  • Django中的响应对象HttpResponse:
  • 构造函数格式: HttpResponse(content=响应体, content_type=响应体数据类型, status=状态码)
  • 作用:向客户端浏览器返回响应,同时携带响应体内容
  • 参数:
  • content:表示返回的内容。
  • status_code:返回的HTTP响应状态码(默认为200)。
  • content_type:指定返回数据的的MIME类型(默认为"text/html")。浏览器会根据这个属性,来显示数据。如果是text/html,那么就会解析这个字符串,如果text/plain,那么就会显示一个纯文本。
text/html(默认的,html文件)
text/plain(纯文本)
text/css(css文件)
text/javascript(js文件)
multipart/form-data(文件提交)
application/json(json传输)
application/xml(xml文件)
  • HttpResponse 子类

类型

作用

状态码

HttpResponseRedirect

重定向

302

HttpResponseNotModified

未修改

304

HttpResponseBadRequest

错误请求

400

HttpResponseNotFound

没有对应的资源

404

HttpResponseForbidden

请求被禁止

403

HttpResponseServerError

服务器错误

500

GET方式传参

  • GET请求方式中可以通过查询字符串(Query String)将数据传递给服务器
  • URL 格式: xxx?参数名1=值1&参数名2=值2… http://127.0.0.1:8000/page1?a=100&b=200
  • 服务器端接收参数
  1. 判断 request.method 的值判断请求方式是否是get请求
if request.method == 'GET':
	处理GET请求时的业务逻辑
else:
	处理其它请求的业务逻辑
  1. 获取客户端请求GET请求提交的数据 语法
request.GET['参数名']  # QueryDict
request.GET.get('参数名','默认值')
request.GET.getlist('参数名')
# mypage?a=100&b=200&c=300&b=400
request.GET=QueryDict({'a':['100'], 'b':['200','400'], 'c':['300']})
a = request.GET['a']
b = request.GET['b']  # Error
b = request.GET.getlist['b']  # ['200','400']
  1. 能够产生get请求方式的场合
  1. 地址栏手动输入, 如: http://127.0.0.1:8000/mypage?a=100&b=200
  2. <a href="地址?参数=值&参数=值">
  3. form表单中的method为get
action:form中内容提交的最终地址
<form method='get' action="/user/login">
	姓名:<input type="text" name="uname">
</form>

POST传递参数

  • 客户端通过表单等POST请求将数据传递给服务器端,如:
<form method='post' action="/login">
    姓名:<input type="text" name="username">
    <input type='submit' value='登陆'>
</form>
  • 服务器端接收参数 通过 request.method 来判断是否为POST请求,如:
if request.method == 'POST':
	处理POST请求的数据并响应
else:
	处理非POST 请求的响应
  • 使用post方式接收客户端数据
request.POST['参数名']  # request.POST 绑定QueryDict<QueryDict: {'username': ['xxx']}>
request.POST.get('参数名','')
request.POST.getlist('参数名')
  • 取消 csrf 验证 默认开启django post请求的csrf防御,如果不符合防御要求,post提交会被禁止,返回403 删除 settings.py 中 MIDDLEWARE 中的 CsrfViewsMiddleWare 的中间件
MIDDLEWARE = [
...
# 'django.middleware.csrf.CsrfViewMiddleware',
...
]

form 表单的name属性

  • 在form表单控件提交数据时,会自动搜索本表单控件内部的子标签的name属性及相应的值,再将这些名字和值以键-值对的形式提交给action指定的服务器相关位置
  • 在form内能自动搜集到的name属性的标签的控件有
<input name='xxx'>
<select name='yyy'></select>
<textarea name='zzz'></textarea>
<form action="/page1" method="POST">
    <input name="title" type="text" value="请输入">
    <select name="gender">
	    <option value=1>男</option>
	    <option value=0>女</option>
    </select>
    <textarea name="comment" rows="5" cols="10">附言...</textarea>
    <input type="submit" value="提交">
</form>