django 3.0教程系列(一)请求与响应

2021年09月15日 阅读数:5
这篇文章主要向大家介绍django 3.0教程系列(一)请求与响应,主要内容包括基础应用、实用技巧、原理机制等方面,希望对大家有所帮助。

本教程是针对 Django 3.0 编写的,该版本支持 Python 3.6 和更高版本javascript


建立项目css

若是这是你第一次使用 Django 的话,你须要一些初始化设置。也就是说,你须要用一些自动生成的代码配置一个 Django project —— 即一个 Django 项目实例须要的设置项集合,包括数据库配置、Django 配置和应用程序配置。java


打开命令行,cd 到一个你想放置你代码的目录,而后运行如下命令:python

django-admin startproject mysite

让咱们看看 startproject 建立了些什么:web

mysite/    manage.py    mysite/        __init__.py        settings.py        urls.py        asgi.py        wsgi.py

这些目录和文件的用处是:正则表达式


外部的 mysite/ 根目录是项目的容器。它的名字对Django来讲并不重要;您能够将其重命名为任何您喜欢的名称。typescript


manage.py: 一个让你用各类方式管理 Django 项目的命令行工具。数据库


里面一层的 mysite/ 目录包含你的项目,它是一个纯 Python 包。它的名字就是当你引用它内部任何东西时须要用到的 Python 包名。(好比 mysite.urls).django


mysite/__init__.py:一个空文件,告诉 Python 这个目录应该被认为是一个 Python 包。若是你是 Python 初学者,阅读官方文档中的 更多关于包的知识。浏览器


mysite/settings.py:Django 项目的配置文件。若是你想知道这个文件是如何工做的,请查看 Django 配置 了解细节。


mysite/urls.py:Django 项目的 URL 声明,就像你网站的“目录”。


mysite/asgi.py: asgi兼容的web服务器的入口点,以服务于您的项目。


mysite/wsgi.py:做为你的项目的运行在 WSGI 兼容的Web服务器上的入口。


开发的简易服务器

让咱们来确认一下你的 Django 项目是否真的建立成功了。若是你的当前目录不是外层的 mysite 目录的话,请切换到此目录,而后运行下面的命令:

python manage.py runserver

你应该会看到以下输出:

Performing system checks...
System check identified no issues (0 silenced).
You have unapplied migrations; your app may not work properly until they are applied.Run 'python manage.py migrate' to apply them.
Django version 3.0, using settings 'mysite.settings'Starting development server at http://127.0.0.1:8000/Quit the server with CONTROL-C.


你刚刚启动的是 Django 自带的用于开发的简易服务器,它是一个用纯 Python 写的轻量级的 Web 服务器。咱们将这个服务器内置在 Django 中是为了让你能快速的开发出想要的东西,由于你不须要进行配置生产级别的服务器(好比 Apache)方面的工做,除非你已经准备好投入生产环境了。


如今是个提醒你的好时机:千万不要 将这个服务器用于和生产环境相关的任何地方。这个服务器只是为了开发而设计的。(咱们在 Web 框架方面是专家,在 Web 服务器方面并非。)


如今,服务器正在运行,浏览器访问 https://127.0.0.1:8000/。你将会看到一个“祝贺”页面,随着一只火箭发射,服务器已经运行了。


默认状况下,runserver 命令会将服务器设置为监听本机内部 IP 的 8000 端口。


注意

若是你想更换服务器的监听端口,请使用命令行参数。举个例子,下面的命令会使服务器监听 8080 端口:

python manage.py runserver 8080

若是你想要修改服务器监听的IP,在端口以前输入新的。好比,为了监听全部服务器的公开IP(这你运行 Vagrant 或想要向网络上的其它电脑展现你的成果时颇有用),0 是 0.0.0.0 的简写,使用:

python manage.py runserver 0:8000


会自动从新加载的服务器 runserver

用于开发的服务器在须要的状况下会对每一次的访问请求从新载入一遍 Python 代码。因此你不须要为了让修改的代码生效而频繁的从新启动服务器。然而,一些动做,好比添加新文件,将不会触发自动从新加载,这时你得本身手动重启服务器。


建立投票应用

如今你的开发环境——这个“项目” ——已经配置好了,你能够开始干活了。

在 Django 中,每个应用都是一个 Python 包,而且遵循着相同的约定。Django 自带一个工具,能够帮你生成应用的基础目录结构,这样你就能专心写代码,而不是建立目录了。


你的应用能够存放在任何 Python path 中定义的路径。在这个教程中,咱们将在你的 manage.py 同一级目录下建立投票应用。这样它就能够做为顶级模块导入,而不是 mysite 的子模块。

请肯定你如今处于 manage.py 所在的目录下,而后运行这行命令来建立一个应用:

python manage.py startapp polls


这将会建立一个 polls 目录,它的目录结构大体以下:

polls/    __init__.py    admin.py    apps.py    migrations/        __init__.py    models.py    tests.py    views.py

这个目录结构包括了投票应用的所有内容。


编写第一个视图

让咱们开始编写第一个视图吧。打开 polls/views.py,把下面这些 Python 代码输入进去:

from django.http import HttpResponse
def index(request): return HttpResponse("Hello, world. You're at the polls index.")


这是 Django 中最简单的视图。若是想看见效果,咱们须要将一个 URL 映射到它——这就是咱们须要 URLconf 的缘由了。


为了建立 URLconf,请在 polls 目录里新建一个 urls.py 文件。你的应用目录如今看起来应该是这样:

polls/    __init__.py    admin.py    apps.py    migrations/        __init__.py    models.py    tests.py    urls.py    views.py

在 polls/urls.py 中,输入以下代码:

from django.urls import path
from . import views
urlpatterns = [ path('', views.index, name='index'),]

下一步是要在根 URLconf 文件中指定咱们建立的 polls.urls 模块。在 mysite/urls.py 文件的 urlpatterns 列表里插入一个 include(), 以下:

from django.contrib import adminfrom django.urls import include, path
urlpatterns = [ path('polls/', include('polls.urls')), path('admin/', admin.site.urls),]


函数 include() 容许引用其它 URLconfs。每当 Django 遇到 include() 时,它会截断与此项匹配的 URL 的部分,并将剩余的字符串发送到 URLconf 以供进一步处理。


咱们设计 include() 的理念是使其能够即插即用。由于投票应用有它本身的 URLconf( polls/urls.py ),他们可以被放在 "/polls/" , "/fun_polls/" ,"/content/polls/",或者其余任何路径下,这个应用都可以正常工做。


你如今把 index 视图添加进了 URLconf。经过如下命令验证是否正常工做:

python manage.py runserver


用你的浏览器访问 http://localhost:8000/polls/,你应该可以看见 "Hello, world. You're at the polls index." ,这是你在 index 视图中定义的。


函数 path() 具备四个参数,两个必须参数:route 和 view,两个可选参数:kwargs 和 name。如今,是时候来研究这些参数的含义了。


path() 参数:route¶

route 是一个匹配 URL 的准则(相似正则表达式)。当 Django 响应一个请求时,它会从 urlpatterns 的第一项开始,按顺序依次匹配列表中的项,直到找到匹配的项。


这些准则不会匹配 GET 和 POST 参数或域名。例如,URLconf 在处理请求 https://www.example.com/myapp/ 时,它会尝试匹配 myapp/ 。处理请求 https://www.example.com/myapp/?page=3 时,也只会尝试匹配 myapp/。


path() 参数:view¶

当 Django 找到了一个匹配的准则,就会调用这个特定的视图函数,并传入一个 HttpRequest 对象做为第一个参数,被“捕获”的参数以关键字参数的形式传入。稍后,咱们会给出一个例子。


path() 参数:kwargs¶

任意个关键字参数能够做为一个字典传递给目标视图函数。本教程中不会使用这一特性。


path() 参数:name¶

为你的 URL 取名能使你在 Django 的任意地方惟一地引用它,尤为是在模板中。这个有用的特性容许你只改一个文件就能全局地修改某个 URL 模式。


本文分享自微信公众号 - pythonista的平常(gh_fc70d5d98d3f)。
若有侵权,请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”,欢迎正在阅读的你也加入,一块儿分享。