Part 1:请求与响应

阅读: 94353


一、 新建项目

进入你期望的项目保存目录,运行下面的命令:

$ django-admin startproject mysite

这将在目录下生成一个mysite目录,也就是你的这个Django项目的根目录。它包含了一系列自动生成的目录和文件,具备各自专有的用途。

注意:在给项目命名的时候必须避开Django和Python的保留关键字,比如“django”,“test”等,否则会引起冲突和莫名的错误。对于mysite的放置位置,不建议放在传统的/var/wwww目录下,它会具有一定的数据暴露危险,因此Django建议你将项目文件放在例如/home/mycode类似的位置。

一个新建立的项目结构大概如下:

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

各文件和目录解释:

  • 外层的mysite/目录与Django无关,只是你项目的容器,可以任意重命名。
  • manage.py:一个命令行工具,用于与Django进行不同方式的交互脚本,非常重要!
  • 内层的mysite/目录是真正的项目文件包裹目录,它的名字是你引用内部文件的包名,例如:mysite.urls
  • mysite/__init__.py:一个定义包的空文件。
  • mysite/settings.py:项目的主配置文件,非常重要!
  • mysite/urls.py:路由文件,所有的任务都是从这里开始分配,相当于Django驱动站点的内容表格,非常重要!
  • mysite/wsgi.py:一个基于WSGI的web服务器进入点,提供底层的网络通信功能,通常不用关心。

PS:这一部分,我们可以在Pycharm环境下进行,参考上节内容。

二、 启动开发服务器

进入mystie项目的根目录,输入下面的命令:

$ python manage.py runserver

你会看到下面的提示,这表明Django的开发服务器已经启动,开始提供Web服务了:

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.

四月 17, 2019 - 15:50:53
Django version 2.2, using settings 'mysite.settings'
Starting development server at [http://127.0.0.1:8000/](http://127.0.0.1:8000/)
Quit the server with CONTROL-C.</pre>

Django提供了一个用于开发的web服务器,使你无需配置一个类似Ngnix的生产服务器,就能让站点运行起来。这是一个由Python编写的轻量级服务器,简易并且不安全,因此不要将它用于生产环境。

打开浏览器,访问http://127.0.0.1:8000/,你将看到Django的火箭欢迎界面,一切OK!

Django的开发服务器(以后简称服务器)默认运行在内部的8000端口,如果你想指定端口,请在命令中显示给出:

$ python manage.py runserver 8080

如果想修改服务器的ip地址,请按下面的方式运行命令,比如:

$ python manage.py runserver 0:8000

0 是 0.0.0.0 的简写,Django将运行在0.0.0.0:8000上,整个局域网内都将可以访问站点,而不只是是本机。

注意: Django的开发服务器具有自动重载功能,当你的代码有修改,每隔一段时间服务器将自动更新。但是,有一些例如增加文件的动作,不会触发服务器重载,这时就需要你自己手动重启。

PS: 这一步操作在Pycharm里只需要简单地按下绿色三角:

image

三、 创建投票应用(app)

在 Django 中,每一个应用(app)都是一个 Python 包,并且遵循着相同的约定。Django 自带一个工具,可以帮你生成应用的基础目录结构。

app应用与project项目的区别:

  • 一个app实现某个功能,比如博客、公共档案数据库或者简单的投票系统;
  • 一个project是配置文件和多个app的集合,这些app组合成整个站点;
  • 一个project可以包含多个app;
  • 一个app可以属于多个project!

app的存放位置可以是任何地点,但是通常都将它们放在与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

在Pycharm中,没有可以创建app的图形化按钮,需要在下方的Terminal终端中输入命令:

python manage.py startapp polls

这样也能创建polls应用。

image

通过前面在Pycharm中创建工程的方式有个方便之处,点击Terminal后,会自动进入虚拟环境。

四、编写第一个视图

polls/views.py文件中,编写代码:

from django.http import HttpResponse

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

为了调用该视图,我们还需要编写urlconf,也就是路由路径。现在,在polls目录中新建一个文件,名字为urls.py,在其中输入代码如下:

from django.urls import path

from . import views

urlpatterns = [
    path('', views.index, name='index'),
]

此时,目录的文件结构是这样的:

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

我们先不用深究urls.py中代码的具体含义。

接下来,在项目的主urls.py文件中添加urlpattern条目,指向我们刚才建立的polls这个app独有的urls文件,这里需要导入include模块。打开mysite/urls.py文件,代码如下:

from django.contrib import admin
from django.urls import include, path

urlpatterns = [
    path('polls/', include('polls.urls')),
    path('admin/', admin.site.urls),
]

include语法相当于多级路由,它把接收到的url地址去除与此项匹配的部分,将剩下的字符串传递给下一级路由urlconf进行判断。在路由的章节,有更加详细的用法指导。

include的背后是一种即插即用的思想。项目根路由不关心具体app的路由策略,只管往指定的二级路由转发,实现了应用解耦。app所属的二级路由可以根据自己的需要随意编写,不会和其它的app路由发生冲突。app目录可以放置在任何位置,而不用修改路由。这是软件设计里很常见的一种模式。

建议:除了admin路由外,尽量给每个app设计自己独立的二级路由。

好了,路由设置成功后,启动服务器,然后在浏览器中访问地址http://localhost:8000/polls/。一切正常的话,你将看到“Hello, world. You’re at the polls index.”


path()方法:

路由系统中最重要的path()方法可以接收4个参数,其中2个是必须的:routeview,以及2个可选的参数:kwargsname

route:

route 是一个匹配 URL 的准则(类似正则表达式)。当 Django 响应一个请求时,它会从 urlpatterns 的第一项开始,按顺序依次匹配列表中的项,直到找到匹配的项,然后执行该条目映射的视图函数或下级路由,其后的条目将不再继续匹配。因此,url路由的编写顺序非常重要!

需要注意的是,route不会匹配 GET 和 POST 参数或域名。例如,URLconf 在处理请求 https://www.example.com/myapp/时,它会尝试匹配 myapp/。处理请求 https://www.example.com/myapp/?page=3 时,也只会尝试匹配 myapp/

view:

view指的是处理当前url请求的视图函数。当Django匹配到某个路由条目时,自动将封装的HttpRequest对象作为第一个参数,被“捕获”的参数以关键字参数的形式,传递给该条目指定的视图view。

kwargs:

任意数量的关键字参数可以作为一个字典传递给目标视图。

name:

对你的URL进行命名,让你能够在Django的任意处,尤其是模板内显式地引用它。这是一个非常强大的功能,相当于给URL取了个全局变量名,不会将url匹配地址写死。

path()方法的四个参数,每个都非常有讲究,这里先做基本的介绍,在后面有详细的论述。



评论总数: 38



user_image

为啥http://127.0.0.1:8000/我的老是显示连接失败 ,我检查了一遍,也没有错误呀



user_image

`localhost:8000` 不好吗?



user_image

老师:django 可以完成测试平台的开发 吗?



user_image

django本质上是开发基于http的bs服务,一切以此为基础的应用都是可以开发的。



user_image

不错的django教程,继续学习



user_image

我就纳闷了,为什么在polls 的urls。py中 from . import views 总是提示找不到该模块



user_image

函数后面没写:



user_image

我也是一直找不到view模块,请问您是在最后加了一个“:”解决的么?



user_image

不是view模块,是views模块



user_image

作者加油



user_image

刘老师你好,问题已解决,应该是用http://127.0.0.1:8000/polls访问而不是http://127.0.0.1:8000



user_image

用127.0.0.1:8000报下面的错误: Page not found (404) Request Method: GET Request URL: http://127.0.0.1:8000/ Using the URLconf defined in vote.urls, Django tried these URL patterns, in this order: ^polls/ ^admin/ The empty path didn't match any of these. You're seeing this error because you have DEBUG = True in your Django settings file. Change that to False, and Django will display a standard 404 page.



user_image

刘老师你好,我用您写的http://localhost:8000/polls/可以运行, 但是用http://127.0.0.1:8000/总显示404应该是哪里的原因



user_image

应该是类型吧



user_image

题主您好,首先非常感谢你的分享,收获颇丰。 在实现您的项目过程中,我发现有以下地方可以做补充和纠正: 1.在新建一个polls的项目包之后,建view,并添加好index函数之后,需要返回mysite的项目包中的setting.py文件中的INSTALLED_APPS = [‘。。。]模块中添加‘polls'(也就是我新建app项目的名称)。 2.另外在mysite/urls.py中,我直接加入了: from django.urls import path from django.conf.urls import include,url urlpatterns = [ path('polls/', include('polls.urls')), ] 就成功了。和您给出的项目略显不同。



user_image

这是一个连续的教程,一步一步从浅到深,不要轻易下结论。



user_image

是不是少了点什么?我每次路径映射都是404NOT FOUND。



user_image

将你的代码和文字中的代码进行详细的对比。 没有人可以在不知道你的代码的情况下,准确的判断出问题所在。



user_image

你这样把大家的微博ID都暴露了。。。。



user_image

url(r'^polls/', include('polls.urls')), include报错显示unresolved inference django版本号:1.1.6 python 2.7



user_image

from django.conf.urls import url from . import views



user_image

没有



user_image

python manage.py runserver的时候提示这个 Model class django.contrib.contenttypes.models.ContentType doesn't declare an explicit app_label and isn't in an application in INSTALLED_APPS. 而且我已经把app的名字添加进入了。



user_image

是通过django-admin startproject 命令创建的项目吗?



user_image

是的啊



user_image

1.11



user_image

解决了,刘老师 from django.conf.urls import url 没有导入url。。擦



user_image

url(r'^polls/', include('polls.urls')),改成path('',include('polls.urls')) django 2.0



user_image

感谢博主的教程!



user_image

感谢分享,写的很好。 对‘在Pycharm中,没有可以创建app的图形化按钮' 这句有点补充, new project->Django(more settings) 下面可以加入Application name:那一栏可以填入app的名字,点击create后Pycharm会自动创建



user_image

在新建工程的时候,可以指定第一个app,但是往后,就不行了。



user_image

pycharm的命令行可以创建吧



user_image

清晰易懂,楼主给力!!!!



user_image

向博主看齐 以后也学习博主这样 感觉风格有点相似于廖大大O(∩_∩)O哈哈~ 是才搭建没多久的站吗?



user_image

新站稚嫩,多帮忙宣传宣传,拜谢!



user_image

少了一步 把应用添加到setting app 里



user_image

可以看得出刘江对Django的很多细节上的苛刻追求很严谨,看了几个教程,没有一个是讲的这么细的,细到一个重要的函数的参数都详细的讲解一遍,收获颇丰,十分感谢!



user_image

谢谢夸奖!^-^ 肯定还有不足之处!