Django基础

Django的安装

• 查看已安装的版本

>>> import django
>>> print(django.VERSION)
(2, 2, 12, 'final', 0)

• 安装
  $ sudo pip3 install django 安装Django的最新版本
  $ sudo pip3 install django[==版本] 安装Django的指定版本
• Django的卸载
  $ pip3 uninstall django

创建Django项目

  **$ django-admin startproject 项目名称**
  运行
  ```
  $ cd mysite1
  $ python3 manage.py runserver
  # 或
  $ python3 manage.py runserver 5000  # 指定只能本机使用127.0.0.1的5000端口访问本机
  ```
  * 项目目录结构解析
        manage.py
              此文件是项目管理的主程序,在开发阶段用于管理整个项目的开发运行的调试
        项目名称 项目文件夹
              项目包的主文件夹(默认与项目名称一致)
              1. `__init__.py`
                    包初始化文件,当此项目包被导入(import)时此文件会自动运行
              2. `wsgi.py`
                    WSGI 即 Web Server Gateway Interface
                    WEB服务网关接口的配置文件,仅部署项目时使用
              3. `urls.py`
                    项目的主路由配置文件,所有的动态路径必须先走该文件进行匹配
              4. `settings.py`
                    Django项目的配置文件, 此配置文件中的一些全局变量将为Django框架的运行传递一些参数
                    setting.py 配置文件,启动服务时自动调用 
                    此配置文件中也可以定义一些自定义的变量用于作用全局作用域的数据传递

settings.py 文件介绍

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

1. BASE_DIR

   • 用于绑定当前项目的绝对路径(动态计算出来的), 所有文件都可以依懒此路径

2. DEBUG

   • 用于配置Django项目的启动模式, 取值:
     1. True 表示开发环境中使用 调试模式(用于开发中)
     2. False 表示当前项目运行在生产环境中(不启用调试)

3. ALLOWED_HOSTS

   • 设置允许访问到本项目的host请求头的值,取值:

     1. [] 空列表,表示只有host请求头为127.0.0.1, localhost能访问本项目 - DEBUG = True时生效
     2. ['*']，表示任何请求头的host都能访问到当前项目
     3. ['192.168.1.3', '127.0.0.1'] 表示只有当前两个host头的值能访问当前项目
     • 注意:
       • 如果要在局域网其它主机也能访问此主机,启动方式应使用如下模式:

   • python3 manage.py runserver 0.0.0.0:5000 # 指定网络设备如果内网环境下其他主机想正常访问该站点，需加`ALLOWED_HOSTS = ['内网ip']

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 配置 'mysite1.urls'
    • 如:
      • `ROOT_URLCONF = 'mysite1.urls'

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

URL定义

• URL 即统一资源定位符 Uniform Resource Locator

• 作用:

  • 用来表示互联网上某个资源的地址。

• 说明:

  • 互联网上的每个文件都有一个唯一的URL，它包含的信息指出文件的位置以及浏览器应该怎么处理它。

• URL的一般语法格式为：

  protocol :// hostname[:port] / path [?query][#fragment]
  

• 如:

  http://tts.tmooc.cn/video/showVideo?menuId=657421&version=AID201908#subject
  

• 说明:

  • protocol（协议）

    • http 通过 HTTP 访问该资源。 格式 HTTP://
    • https 通过安全的 HTTPS 访问该资源。 格式 HTTPS://
    • file 资源是本地计算机上的文件。格式: file:///
    • ...

  • hostname（主机名）

    • 是指存放资源的服务器的域名系统(DNS) 主机名、域名 或 IP 地址。

  • port（端口号）

    • 整数，可选，省略时使用方案的默认端口；
    • 各种传输协议都有默认的端口号，如http的默认端口为80。

  • path（路由地址）

    • 由零或多个“/”符号隔开的字符串，一般用来表示主机上的一个目录或文件地址。路由地址决定了服务器端如何处理这个请求

  • query(查询)

    • 可选，用于给动态网页传递参数，可有多个参数，用“&”符号隔开，每个参数的名和值用“=”符号隔开。

  • fragment（信息片断）

    • 字符串，用于指定网络资源中的片断。例如一个网页中有多个名词解释，可使用fragment直接定位到某一名词解释。

  • 注: [] 代表其中的内容可省略

Django如何处理一个URL对应的请求

浏览器  http://127.0.0.1:8000/page/2003/

1,Django 从配置文件中 根据 ROOT_URLCONF 找到 主路由文件；默认情况下，该文件在 项目同名目录下的urls; 例如 mysite1/mysite1/urls.py
2,Django 加载 主路由文件中的 urlpatterns 变量(列表)
3,依次匹配 urlpatterns 中的 URL， 匹配到第一个合适的中断后续匹配
4,匹配成功 - 调用对应的视图函数处理请求，返回响应
5,匹配失败 - 返回404响应

主路由-urls.py样例
from django.urls import path
from . import views
urlpatterns = [
    path('admin/', admin.site.urls)
    path('page/2003/', views.page_2003),
    path('page/2004/', views.page_2004),
]

视图函数(view)

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

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

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

• 参数:

  • request用于绑定HttpRequest对象，通过此对象可以获取浏览器的参数和数据

• 返回值

  ​ HttpResponse的对象；Django会提供一系列的response对象；

• 示例:

  • 视图处理函数 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 = [
    path('admin/', admin.site.urls),
    ...  # 此处配置主路由
]

path()函数

• 用于描述路由与视图函数的对应关系
• 模块
  * from django.urls import path
• 语法:
  * path(route, views, name=None)
  * 参数:
  1. route:字符串类型,匹配的请求路径
  2. views:指定路径所对应的视图处理函数的名称
  3. name:为地址起别名,在模板中地址反向解析时使用

path转换器

语法: <转换器类型:自定义名>
作用: 若转换器类型匹配到对应类型的数据,则将数据按照关键字传参的方式传递给视图函数

转换器	效果	案例
str	匹配除了 '/' 之外的非空字符串	"v1/users/<str:username>"匹配 /v1/users/guoxiaonao
int	匹配0或任何正整数。返回一个 int	"page/<int:page>" 匹配 /page/100
slug	匹配任意由 ASCII 字母或数字以及连字符和下划线组成的短标签	"detail/<slug:sl>" 匹配 /detail/this-is-django
path	匹配非空字段，包括路径分隔符 '/'	"v1/users/<path:ph>"匹配 /v1/goods/a/b/c

re_path()函数

• 在url 的匹配过程中可以使用正则表达式进行精确匹配

• 语法:

  • re_path(reg, view, name=xxx)
  • 正则表达式为命名分组模式(?P<name>pattern) ；匹配提取参数后用关键字传参方式传递给视图函数

• 示例:

  • 路由配置文件

    # file : <项目同名文件夹>/urls.py
    # 以下示例匹配
    # 可匹配 http://127.0.0.1:8000/20/mul/40
    # 不可匹配 http://127.0.0.1:8000/200/mul/400
    urlpatterns = [
    path('admin/', admin.site.urls),
    re_path(r'^(?P<x>d{1,2})/(?P<op>w+)/(?P<y>d{1,2})$',views.cal_view),
    ]
    

HTTP1.1请求详述

序号	方法	描述
1	GET	请求指定的页面信息，并返回实体主体。
2	HEAD	类似于get请求，只不过返回的响应中没有具体的内容，用于获取报头
3	POST	向指定资源提交数据进行处理请求（例如提交表单或者上传文件）。数据被包含在请求体中。POST请求可能会导致新的资源的建立和/或已有资源的修改。
4	PUT	从客户端向服务器传送的数据取代指定的文档的内容。
5	DELETE	请求服务器删除指定的页面。
6	CONNECT	HTTP/1.1协议中预留给能够将连接改为管道方式的代理服务器。
7	OPTIONS	允许客户端查看服务器的性能。
8	TRACE	回显服务器收到的请求，主要用于测试或诊断。

HttpRequest对象

• 视图函数的第一个参数是HttpRequest对象

• 服务器接收到http协议的请求后，会根据请求数据报文创建HttpRequest对象

• HttpRequest属性

  • path_info: URL字符串
  • method：字符串，表示HTTP请求方法，常用值：'GET'、'POST'
  • GET：QueryDict查询字典的对象，包含查询字符串的所有数据
  • POST：QueryDict查询字典的对象，包含post表单提交方式的所有数据
  • FILES：类似于字典的对象，包含所有的上传文件信息
  • COOKIES：Python字典，包含所有的cookie，键和值都为字符串
  • session：似于字典的对象，表示当前的会话
  • body: 字符串，请求体的内容(POST或PUT)
  • scheme : 请求协议('http'/'https')
  • request.get_full_path() : 请求的完整路径
  • request.get_host() : 请求的主机
  • request.META : 请求中的元数据(消息头)
  • request.META['REMOTE_ADDR'] : 客户端IP地址
    Django中的响应对象HttpResponse:

• 构造函数格式:

  • HttpResponse(content=响应体, content_type=响应体数据类型, status=状态码)

• 作用:

  • 向客户端浏览器返回响应，同时携带响应体内容

• 参数:

  • content：表示返回的内容。
  • status_code：返回的HTTP响应状态码(默认为200)。
  • content_type：指定返回数据的的MIME类型(默认为"text/html")。浏览器会根据这个属性，来显示数据。如果是text/html，那么就会解析这个字符串，如果text/plain，那么就会显示一个纯文本。
    • 常用的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)是指多用途互联网邮件扩展类型。

• HttpResponse 子类

类型	作用	状态码
HttpResponseRedirect	重定向	302
HttpResponseNotModified	未修改	304
HttpResponseBadRequest	错误请求	400
HttpResponseNotFound	没有对应的资源	404
HttpResponseForbidden	请求被禁止	403
HttpResponseServerError	服务器错误	500