Django框架介绍（一）

Django框架的介绍

一个采用Python语言编写的，开源的，重量级的 Python Web框架。

Django 配备了常用的大部分组件：

• 基本配置
• 路由系统
• 原生HTML模板系统
• 视图 view
• Model模型,数据库连接和ORM数据库管理
• 中间件
• Cookie & Seesion
• 分页
• 数据库后台管理系统admin

Django的用途

• 网站后端开发
• 微信公众号、微信小程序等后台开发
• 基于HTTP/HTTPS协议的后台服务器开发
  • 在线语音/图像识别服务器
  • 在线第三方身份验证服务器等

Django的安装

• 查看已安装的版本，python3 交互模式下

>>> import django
>>> print(django.VERSION)
(1, 11, 8, 'final', 0)

• 安装
  • 在线安装
    $ sudo pip3 install django 安装django的最新版本
    $ sudo pip3 install django[==版本] 安装django的指定版本
    如：$ sudo pip3 install django==1.11.8
  • 离线安装
    • 下载安装包:
      wget ...
    • 安装离线包
      $ tar -xvf Django-1.11.8.tar.gz
$ cd Django-1.11.8
$ sudo python3 setup.py install
    • 用wheel离线安装
      • 下载安装包:
        pip3 download -d /home/teenjeen/django_packs django==1.11.8
      • 安装离线包
        $ pip3 install Django-1.11.8.whl

项目搭建

创建项目的指令

• 创建项目
  $ django-admin startproject mysite1 'mysite1’为项目名称
• 启动项目

  $ cd mysite1  #进入项目根目录
  $ python3 manage.py runserver  # 默认8000端口
  # 或
  $ python3 manage.py runserver 5000  # 指定5000端口
  

• 访问项目
  http://127.0.0.1:8000

目录结构

$ django-admin startproject mysite1
$ tree mysite1/
mysite1/
├── manage.py
└── mysite1
    ├── __init__.py
    ├── settings.py
    ├── urls.py
    └── wsgi.py

1 directory, 5 files

• 项目目录结构解析:

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

• settings.py 文件介绍
  https://docs.djangoproject.com/en/1.11/ref/settings/

1. BASE_DIR
   用于绑定当前项目的绝对路径(动态计算出来的), 所有文件都可以依懒此路径
2. DEBUG
   用于配置Django项目的启用模式, 取值:
   True 表示开发环境中使用 调试模式(用于开发中)
   False 表示当前项目运行在生产环境中(不启用调试)
3. ALLOWED_HOSTS
   设置允许访问到本项目的网络地址列表,取值:
   [] 空列表,表示只有127.0.0.1, localhost能访问本项目
   ['*']，表示任何网络地址都能访问到当前项目
   ['192.168.1.3', '192.168.3.3'] 表示只有当前两个主机能访问当前项目
   【注意】
   如果要在局域网其它主机也能访问此主机,启动方式应使用如下模式:
   python3 manage.py runserver 0.0.0.0:5000 指定网络设备所有主机都可以通过5000端口访问(需加ALLOWED_HOSTS = ['*'])
4. INSTALLED_APPS
   指定当前项目中安装的应用列表
5. MIDDLEWARE
   用于注册中间件
6. TEMPLATES
   用于指定模板的配置信息
7. DATABASES
   用于指定数据库的配置信息
8. LANGUAGE_CODE
   用于指定语言配置
   英文 : "en-us"
   中文 : "zh-Hans"
9. TIME_ZONE
   用于指定当前服务器端时区
   世界标准时间: "UTC"
   中国时区 : "Asia/Shanghai"
10. ROOT_URLCONF
    用于配置根级 url 配置
    如:ROOT_URLCONF = 'mysite1.urls'

注: 此模块可以被其他模块通过 from django.conf import settings 导入和使用

视图函数(view)

视图函数是用于接收一个浏览器请求并通过HttpResponse对象返回数据的函数。此函数可以接收浏览器请求并根据业务逻辑返回相应的内容给浏览器

• 视图处理的函数的语法格式:

  def xxx_view(request[, 其它参数...]):
      return HttpResponse对象
  

• 参数:
  • request用于绑定HttpRequest对象，通过此对象可以获取浏览器的参数和数据
• 示例:
  视图处理函数需要定义在 views.py 文件中

  # file : <项目名>/views.py
  from django.http import HttpResponse
  def page1_view(request):
    html = "<h1>这是第1个页面</h1>"
    return HttpResponse(html)
  

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: 为地址起别名，在模板中地址反向解析时使用

      每个正则表达式前面的r表示'\'不转义的原始字符串

带有命名分组的路由和视图函数

在url 的正则表达式中可以使用命名分组(捕获分组)

• 说明:
  在视图函数内，可以用正则表达式分组 (?P<name>pattern) 提取参数后用函数关键字传参传递给视图函数
• 示例:

  # file : <项目名>/urls.py
  # 以下示例匹配
  # http://127.0.0.1:8000/person/xiaoming/20
  # http://127.0.0.1:8000/person/xiaohong/29
  # http://127.0.0.1:8000/person/xiaolan/9
  urlpatterns = [
      url(r'^admin/', admin.site.urls),
      url(r'^person/(?P<name>\w+)/(?P<age>\d{1,2})',views.person_view),
  ]
  

HTTP协议的请求和响应

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

HTTP 请求

• HttpRequest对象
  • 视图函数的第一个参数是HttpRequest对象
    服务器接收到http协议的请求后，会根据请求数据报文创建HttpRequest对象
  • HttpRequest属性
    • path：字符串，表示请求的路由信息
    • path_info: URL字符串
    • method：字符串，表示HTTP请求方法，常用值：‘GET’、‘POST’
    • encoding：字符串，表示提交的数据的编码方式
      如果为None则表示使用浏览器的默认设置，一般为utf-8
      这个属性是可写的，可以通过修改它来修改访问表单数据使用的编码，接下来对属性的任何访问将使用新的encoding值
    • GET：QueryDict查询字典的对象，包含get请求方式的所有数据
    • POST：QueryDict查询字典的对象，包含post请求方式的所有数据
    • FILES：类似于字典的对象，包含所有的上传文件信息
    • COOKIES：Python字典，包含所有的cookie，键和值都为字符串
    • session：似于字典的对象，表示当前的会话，
    • body: 字符串，请求体的内容(POST或PUT)
    • environ: 字符串,客户端运行的环境变量信息
    • scheme : 请求协议(‘http’/‘https’)
    • get_full_path() : 请求的完整路径
    • get_host() : 请求的主机
    • 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")。
    • 常用的Content-Type如下：
      'text/html'（默认的，html文件）
      'text/plain'（纯文本）
      'text/css'（css文件）
      'text/javascript'（js文件）
      'multipart/form-data'（文件提交）
      'application/json'（json传输）
      'application/xml'（xml文件）

      注： 关键字MIME(Multipurpose Internet Mail Extensions)是指多用途互联网邮件扩展类型。浏览器会根据不同MIME的值做出不同的响应内容

• 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
• 服务器端接收参数
  • 判断 request.method 的值判断请求方式是否是get请求

    if request.method == 'GET':
        处理GET请求时的业务逻辑
    else:
        处理其它请求的业务逻辑
    

  • 获取客户端请求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
      

  • 能够产生get请求方式的场合
    • 地址栏手动输入, 如: http://127.0.0.1:8000/mypage?a=100&b=200
    • 超链接：<a href="地址?参数=值&参数=值">
    • form表单中的method为get

      <form method='get' action="/user/login">
          姓名:<input type="text" name="uname">
      </form>
      

    一般查询字符串的大小会受到浏览器的的限制(不建议超过2048字节)

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
request.POST.get('参数名','')
request.POST.getlist('参数名')

• 取消csrf验证,否则Django将会拒绝客户端发来的POST请求
  删除 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="提交">