前面了解了Django的一些基本概念和安装步骤。
这一张开始就要学习Django应用的实现了,这里本来是想跟着Bobby老师的
强力Django+杀手级xadmin开发在线教育网站
采用 Python3.7全新开发
但是苦于囊中羞涩,就只好先加入购物车了。挺想学学的、只能后面再说了。
在这里要感谢刘江老师,刘江老师的免费图文 Django 教程正好救了我。
这部分就开始跟着刘江老师开始学习,在这里记录下一些笔记和一些心得。
应用类型为 一个Web投票应用。
考虑到需求主要涉及两个方面:
- 用户要进行投票以及投票结果的查看
- 需要有一个后台管理界面,最少支持增删改查
新建的项目结构如下:
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服务器进入点,提供底层的网络通信功能,通常不用关心。
一、 新建项目
因为我主要是使用windows+pycharm
我就在pycharm中开始新建一个项目,这里注意一下,如果用pycharm去直接创建django项目,是会默认安装最新的django的,像我的直接建好就是3.0版本的,因为刘江老师的教程是基于2.2版本的,所以这里我要重新安装一下django为2.2版本。
1、按照正常步骤创建Django项目。
2、在pycharm中打开项目的类库,可以看到是3.0版本的。
3、在pycharm中打开这个项目的虚拟环境目录。
4、利用pip进行合适版本Django的安装,这里会根据你已有的版本自动进行升级或者降级,所以可以不卸载原有的3.0版本。
二、 启动开发服务器
这里记录两种方式,记录命令行模式以及pycharm方式。
命令行模式
在命令行里进入mystie项目的根目录,内置的开发服务器就启动了
$ python manage.py runserver
Django提供了一个用于开发的web服务器,使你无需配置一个类似Ngnix的生产服务器,就能让站点运行起来。这是一个由Python编写的轻量级服务器,简易并且不安全,因此不要将它用于生产环境。
打开浏览器,访问http://127.0.0.1:8000/
,你将看到Django的欢迎界面。
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的开发服务器具有自动重载功能,当你的代码有修改,每隔一段时间服务器将自动更新。但是,有一些例如增加文件的动作,不会触发服务器重载,这时就需要你自己手动重启。
pycharm方式
创建完成项目后,在pycharm中启动即可。
如果想要修改服务器的ip或者端口,可以在运行/调试配置中进行设置。
三、 创建投票应用(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
pycharm中在Terminal中端中输入:
可以看到刚创建的app的 结构:
四、编写第一个视图
Django框架采用的是MVT结构,其中视图主要承载的是业务逻辑部分。
首先来编写业务逻辑部分。
1、在views.py中编写以下代码:
from django.http import HttpResponse
def index(request):
return HttpResponse("欢迎进入投票程序!")
2、为了调用该视图,我们还需要编写urlconf,也就是路由路径。现在,在polls目录中新建一个文件,名字为urls.py
,在其中输入代码如下:
from django.urls import path
from . import views
urlpatterns = [
path('', views.index, name='index'),
]
接下来,在项目的主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/
。
一切正常的话,你将看到“欢迎进入投票程序!”
path()方法:
路由系统中最重要的path()方法可以接收4个参数,其中2个是必须的:route
和view
,以及2个可选的参数:kwargs
和name
。
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匹配地址写死。