Django实例教程之创建一个简单的投票系统（一）

心已赠人 2022-01-26 10:09 400阅读 0赞

### **前言** ###

本文将基于django官方案例（投票系统）进行一个简单的学习和讲解

开发环境：windows 7

开发工具：pycharm

python版本：3.7

django版本：2.2

### **简介** ###

通过本案例教程，我们最终将完成一个简单的投票系统的创建，该系统包含两部分：

*  大家都可以参与投票和查看票数的公共网站
 *  用于添加，修改，删除投票的管理后台

首先确保django已经安装，可用如下命令查看是否已经安装了django，打开cmd命令行输入：

python -m django --version

执行完此命令后，如果已经安装了django会输出django的版本，如果没有安装则会提示“没有django模块”

### **创建一个django项目** ###

同样我们将用命令行去创建一个django项目，首先打开cmd命令窗口，切换到任意一个你想用来存放项目代码的目录（如：D:\\Project），执行如下命令：

django-admin startproject myproject

执行完成后将会在该目录下看到一个新的目录myproject

**注意：**

1.  如果提示django-admin不是内部命令，则需要检查一下django的环境变量是否配置或配置是否正确（Path中添加django的安装路径）
2.  在命名项目的时候，不要把一些python或django的关键字作为项目名称，如python，django，test等，否则会与python或django内置的包冲突

项目创建成功后目录结构如下：

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

下面对每个文件做个简单介绍：

*  最外层的根目录myproject：仅仅是一个项目的目录，这个目录的名字可以随便命名为任何你想要的名字，可以不用考虑django或python的内置模块
 *  manage.py：一个可以以多种方式与django项目进行交互的命令行工具，也可理解为用于管理项目的命令行工具集
 *  里面一层目录myproject，我们可以看到在它的下面还有个空的\_\_init\_\_.py文件，其实它就是一个纯python包，它的名字就是一个python包名，所以当你需要导入它里面的任何模块时，你可以用如下代码myproject.urls
 *  myproject/\_\_init\_\_.py：上面已经提到，它是一个空的文件，用来告诉python它所在的目录是一个python包
 *  myproject/settings.py：django项目的配置文件，一些项目的相关配置工作都在这个文件中进行
 *  myproject/urls.py：用于定义django项目的URL
 *  myproject/wsgi.py：作为项目运行的wsgi兼容web服务器的入口点

### 开发服务器 ###

经过以上步骤，一个简单的django web项目就已经搭建完成了。那么我们知道不管是用什么语言开发的web网站，都需要部署到服务器上才能供大家访问，主流的有IIS和Apache等，django也一样需要部署到服务器，那么在开发环境中我们不需要手动部署到IIS或是apache服务器上，因为django自带了一个轻量级的开发服务器，就是便于开发者在开发过程中调试使用。接下来我们通过如下命令来启动服务器，同样还是打开cmd命令行并切换到你的项目中manage.py所在的目录下，然后执行：py manage.py runserver，运行后会输出一堆英文，其中有一句：Starting development server at http://127.0.0.1:8000/，访问这个路径，你将会看到一个“Congratulations！”的页面，还有一个起飞的小火箭，这就说明服务启动成功。

默认情况该服务运行在8000端口上，如果想使用其他端口，则在上面的命令后加上你想用的端口号即可，如：py manage.py runserver 8088，这样服务将运行在本机的8088端口上。

### 创建polls应用 ###

到目前为止我们已经创建了一个简单的项目，接下来就是在该项目上做一些其他事情，如创建应用。

按惯例每一个用django写的应用程序都应该由一个python包组成，那么django自带的工具将会为应用自动生成一个基本的目录结构，所以我们可以只专注于写代码，而不用太去关心该如何去创建目录。在本实例中我们将在manage.py的同级目录下创建polls应用，以便它可以作为顶级模块被引用而不是myproject的子模块

下面来创建投票应用，首先确保已经切换到manage.py所在的目录下，然后运行如下命令：

py manage.py startapp polls

运行完上面的命令后，我们会发现在manage.py 的同级目录下又多了个polls目录，现在整个项目的最新目录结构如下：

myproject/
        manage.py
        myproject/
            __init__.py
            settings.py
            urls.py
            wsgi.py
        polls/
            __init__.py
            admin.py
            apps.py
            migrations/
                __init__.py
            models.py
            tests.py
            views.py

这里可能有人会有点一头雾水了，又是myproject又是polls到底都是干嘛的。这里简单说明一下，首先最外层的myproject就是整个项目的根目录，第二个myproject目录则是整个项目级的配置目录，就是整个项目级的配置信息一般都会放在该目录的文件中，而polls则是我们刚刚新创建的投票应用，每个应用都会包含上面所列出的文件，而且每个引用都会有一个单独的目录，现在我们看到的只有一个polls应用，后面我们还可以再添加更多的应用，其目录结构也都是如此。

下面再说一下项目和应用的关系：

首先应用是一个专门做某件事的web应用程序，如博客，投票系统等，项目则是包含了若干个应用和一些配置信息集合。一个项目可以包含多个应用，一个应用又可以被多个项目引用。

### 编写第一个试图 ###

框架已经搭建好，下面就是填充内容了，首先打开polls下面views.py文件，该文件的中文意思就是视图的意思，其作用是主要用于处理一些数据和业务逻辑然后将数据渲染到页面所用。在该文件中加入如下代码：

#polls/views.py
    
    from django.http import HttpResponse
    
    def index(request):
        return HttpResponse("Hello, World. You are at the polls index page")

这应该是django里最简单的例子了，为了能够访问和呈现该试图，我们还需要对它做个url映射，因此还需要一个url配置文件。在polls目录下创建一个名为urls.py的文件并加入如下代码：

#polls/urls.py
    
    from django.urls import path
    
    from . import views #导入视图模块
    
    urlpatterns = [
        path('',views.index,name='index')
    ]
    
    # views.index 就是我们刚刚在views.py中写的index函数

到此为止我们还不能访问我们的视图，接下来我们还需要将该url指向到项目的根url配置中，在myproject/urls.py中导入django.urls.include 并且用include()方法将polls/urls.py 包含到项目的根url配置中，代码如下：

#myproject/urls.py
    
    from django.contrib import admin
    from django.urls import include ,path
    
    #该url映射用于包含各个app中的urls文件
    urlpatterns = [
        path('polls/',include('polls.urls')),
        path('admin/',admin.stie.urls)
    ]

include()函数运行引用其他的url配置，当django遇到include函数时，它首先会截掉匹配的url部分并将剩余的字符串包含到url配置中等待进一步处理

include()函数的设计初衷是让url配置更加容易即插拔式即插即用。因为每个应用都有它自己的url配置（polls/urls.py）并且它可以被放在任何路径下，如/polls/或/fun\_polls/或/content/polls/等，那么应用仍能正常工作。

那么该什么时候使用include()函数呢，其实只要涉及到需要包含其他url配置时，都需要用include()函数来包含，admin.site.urls是唯一的一个特例。

到此一个最最简单的投票系统首页已经完成了，让我们启动服务看一下我们的成果。依然是执行如下命令：

python manage.py runserver

然后浏览器中输入：http://localhost:8000/polls,即可看到我们刚刚在views的index函数中定义的文本：“Hello,  World. You are at the polls index page”这句话将呈现在页面上了。

### path()函数 ###

path函数定义了4个参数，其中route和view是2个必选参数，另外两个是可选参数，kwargs和name。下面对这4个参数进行简单介绍

**path()参数：route（路由）**

route（路由）是一个包含url模式的字符串（类似正则表达式），当django处理一个请求时，首先从urlpatterns中的第一个pattern开始，按顺序依次匹配，直到找到匹配的项。

这些准则在匹配时不会去匹配请求的参数或域名，例如：

https://www.example.com/myapp/和https://www.example.com/myapp/?page=3这种情况匹配出来的都是myapp，而不会去关心前面的域名和后面的参数

**path()参数：view（视图）**

当django匹配到一个url pattern时，它会调用指定的视图函数，并把HttpRequest对象作为一个参数，其它从路由中捕获到的值作为关键字参数传入。后面会根据例子进行讲解。

**path()参数：kwargs**

任意一个关键字参数会作为一个字典传递给视图。

**path()参数：name**

给url取个名字，可以理解为别名，这样就可以在django的任意地方引用它，尤其是在后面将要介绍的模板里，这个强有力的功能会让你在只修改一个文件的url pattern的情况下，就能全局的修改某个url pattern，也就是说我们在html模板中使用的都是url的别名，而不是url本身，这样当我们的url需要修改的时候，我们仅仅需要修改urls.py中的实际url即可，而HTML模板中所有用到该url的地方都不用修改。

本节内容就介绍到这里，如果有什么不明白或是错误的地方请在下方留言。