Django项目实战——用户投票系统(二)

Django项目实战——用户投票系统(二)

承接上文

在第一部分,我们成功的完成了Django项目的创建。对每一个文件夹/文档的功能及操作有了基础的认识,在第二部分,我们将利用Django自带的轻量级服务器来创建一个基础的index界面以及数据库处理等等一个初级网站的搭建。(依旧是安装Django的官方文档加上我的切身实践来完成这个项目)

​ 下面就让我们继续这趟Django的认识之旅。

数据库配置

打开 mysite/settings.py 。这是个包含了 Django 项目设置的 Python 模块

  • 注:

    这个配置文件使用 SQLite 作为默认数据库。如果你不熟悉数据库,或者只是想尝试下 Django,这是最简单的选择。Python 内置 SQLite,所以你无需安装额外东西来使用它

  • 如果在进行一个真正项目时,光有一个SQLite是远远不够的,在使用MySql等专业数据库时,需要安装合适的 database bindings ,然后改变设置文件中 DATABASES 'default' 项目中的一些键值

    • ENGINE – 可选值有 django.db.backends.sqlite3
      django.db.backends.postgresql
      django.db.backends.mysql,或 django.db.backends.oracle。其它 可用后端
    • NAME – 数据库的名称。如果你使用 SQLite,数据库将是你电脑上的一个文件,在这种情况下,NAME 应该是此文件完整的绝对路径,包括文件名。默认值 BASE_DIR / 'db.sqlite3' 将把数据库文件储存在项目的根目录

    image-20220402102057079

    • SQLite 以外的其它数据库(这个暂时还没有尝试)

      如果你使用了 SQLite 以外的数据库,请确认在使用前已经创建了数据库。你可以通过在你的数据库交互式命令行中使用 “CREATE DATABASE database_name;” 命令来完成这件事。

      另外,还要确保该数据库用户中提供 mysite/settings.py 具有 “create database” 权限。这使得自动创建的 test database 能被以后的教程使用。

      如果你使用 SQLite,那么你不需要在使用前做任何事——数据库会在需要的时候自动创建。

  • 在编辑 mysite/settings.py 文件前,先设置 TIME_ZONE 为你自己时区。

    例如我在哈尔滨,时区为ZH

    还有设置LANGUAGE_CODE = 'zh-hans'这样可以使得最后的网站为中文显示。

  • 关注一下文件头部的 INSTALLED_APPS 设置项。这里包括了会在你项目中启用的所有 Django 应用。应用能在多个项目中使用,你也可以打包并且发布应用,让别人使用它们。

    通常, INSTALLED_APPS 默认包括了以下 Django 的自带应用:

    这些应用被默认启用是为了给常规项目提供方便。

    默认开启的某些应用需要至少一个数据表,所以,在使用他们之前需要在数据库中创建一些表

  • 创建数据库表

    在命令行中跳转到mysite文件夹处,执行以下命令——

    ...\> py manage.py migrate
    

    这个 migrate 命令查看 INSTALLED_APPS 配置,并根据 mysite/settings.py 文件中的数据库配置和随应用提供的数据库迁移文件(我们将在后面介绍这些),创建任何必要的数据库表。

    你会看到它应用的每一个迁移都有一个消息。

    如果你有兴趣,运行你的数据库的命令行客户端,输入 \dt (PostgreSQL), SHOW TABLES; (MariaDB,MySQL), .tables (SQLite)或 SELECT TABLE_NAME FROM USER_TABLES; (Oracle)来显示 Django 创建的表。

    显示效果:

创建模型

在 Django 里写一个数据库驱动的 Web 应用的第一步是定义模型 - 也就是数据库结构设计和附加的其它元数据。

设计理论:

一个模型就是单个定义你的数据的信息源。模型中包含了不可缺少的数据区域和你存储数据的行为。Django 遵循 DRY 原则。目的就是定义你的数据模型要在一位置上,而且自动从该位置推导一些事情。

来介绍一下迁移 - 举个例子,不像 Ruby On Rails,Django 的迁移代码是由你的模型文件自动生成的,它本质上是个历史记录,Django 可以用它来进行数据库的滚动更新,通过这种方式使其能够和当前的模型匹配。

我们将要做一个投票应用,因此需要创建两个模型——“Question”、“Choice”

Question 模型包括问题描述和发布时间。Choice 模型有两个字段,选项描述和当前得票数。每个选项属于一个问题。

  • 通过Python类来表述,下面编辑polls/models.py 文件:

    (tips)我会在可以修改自定义的地方加上注释

    from django.db import models
    
    
    class Question(models.Model):
        question_text = models.CharField(max_length=200)
        pub_date = models.DateTimeField('date published')
    
    
    class Choice(models.Model):
        question = models.ForeignKey(Question, on_delete=models.CASCADE)
        choice_text = models.CharField(max_length=200)
        votes = models.IntegerField(default=0)
    

    代码解释(设计Python语法):

    • 每个模型被表示为 django.db.models.Model 类的子类。每个模型有许多类变量,它们都表示模型里的一个数据库字段
    • 每个 Field 类实例变量的名字(例如 question_textpub_date )也是字段名,所以最好使用对机器友好的格式。你将会在 Python 代码里使用它们,而数据库会将它们作为列名。
    • 你可以使用可选的选项来为 Field 定义一个人类可读的名字。这个功能在很多 Django 内部组成部分中都被使用了,而且作为文档的一部分。如果某个字段没有提供此名称,Django 将会使用对机器友好的名称,也就是变量名。在上面的例子中,我们只为 Question.pub_date 定义了对人类友好的名字。对于模型内的其它字段,它们的机器友好名也会被作为人类友好名使用(注:所谓人类友好名即为下划线法的代码命名方法
    • 定义某些 Field 类实例需要参数。例如 CharField 需要一个 max_length 参数。这个参数的用处不止于用来定义数据库结构,也用于验证数据
    • Field 也能够接收多个可选参数;在上面的例子中:我们将 votesdefault 也就是默认值,设为0。
    • 我们使用 ForeignKey 定义了一个关系。这将告诉 Django,每个 Choice 对象都关联到一个 Question 对象。Django 支持所有常用的数据库关系:多对一、多对多和一对一。

激活模型

在上述模型构造中,我们已经在Django中:

  • 为这个应用创建数据库 schema(生成 CREATE TABLE 语句)。

  • 创建可以与 QuestionChoice 对象进行交互的 Python 数据库 API

    (Tips:相信初学者在这里会对API不甚了解:

    Web API是网站的一部分,用于与使用非常具体的URL请求特定信息的程序交互。这种请求称为API调用。

    请求的数据将以易于处理的格式(如JSON或CSV)返回。依赖于外部数据源的大多数应用程序都依赖于API调用)

  1. 所以现在我们需要将polls应用安装到项目中

​ 我们需要在配置类 INSTALLED_APPS 中添加设置。因为 PollsConfig 类写在文件 polls/apps.py 中,所以它的点式路径是 'polls.apps.PollsConfig'

在文件 mysite/settings.pyINSTALLED_APPS 子项添加点式路径后修改如下代码

mysite/settings.py

INSTALLED_APPS = [
    'polls.apps.PollsConfig',
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
]

现在你的 Django 项目会包含 polls 应用。接着运行下面的命令:

...\> py manage.py makemigrations polls

会出现上述窗口

  1. 通过运行 makemigrations 命令,Django 会检测你对模型文件的修改(在这种情况下,你已经取得了新的),并且把修改的部分储存为一次 迁移

迁移是 Django 对于模型定义(也就是你的数据库结构)的变化的储存形式 - 它们其实也只是一些你磁盘上的文件。如果你想的话,你可以阅读一下你模型的迁移数据,它被储存在 polls/migrations/0001_initial.py 里。别担心,你不需要每次都阅读迁移文件,但是它们被设计成人类可读的形式,这是为了便于你手动调整 Django 的修改方式。

Django 有一个自动执行数据库迁移并同步管理你的数据库结构的命令 - 这个命令是 migrate,我们马上就会接触它 - 但是首先,让我们看看迁移命令会执行哪些 SQL 语句。sqlmigrate 命令接收一个迁移的名称,然后返回对应的 SQL

输入以下代码:

...\> py manage.py sqlmigrate polls 0001

输出以下形式:

注:

  • 输出的内容和你使用的数据库有关,上面的输出示例使用的是 PostgreSQL。
  • 数据库的表名是由应用名(polls)和模型名的小写形式( questionchoice)连接而来。(如果需要,你可以自定义此行为。)
  • 主键(IDs)会被自动创建。(当然,你也可以自定义。)
  • 默认的,Django 会在外键字段名后追加字符串 "_id" 。(同样,这也可以自定义。)
  • 外键关系由 FOREIGN KEY 生成。你不用关心 DEFERRABLE 部分,它只是告诉 PostgreSQL,请在事务全都执行完之后再创建外键关系。
  • 生成的 SQL 语句是为你所用的数据库定制的,所以那些和数据库有关的字段类型,比如 auto_increment (MySQL)、 serial (PostgreSQL)和 integer primary key autoincrement (SQLite),Django 会帮你自动处理。那些和引号相关的事情 - 例如,是使用单引号还是双引号 - 也一样会被自动处理。
  • 这个 sqlmigrate 命令并没有真正在你的数据库中的执行迁移 - 相反,它只是把命令输出到屏幕上,让你看看 Django 认为需要执行哪些 SQL 语句。这在你想看看 Django 到底准备做什么,或者当你是数据库管理员,需要写脚本来批量处理数据库时会很有用。
  1. 现在,再次运行 migrate 命令,在数据库里创建新定义的模型的数据表:

    ...\> py manage.py migrate
    (输出效果)    Operations to perform:
          Apply all migrations: admin, auth, contenttypes, polls, sessions
        Running migrations:
          Rendering model states... DONE
          Applying polls.0001_initial... OK
    

小总结

改变模型需要这三步:

数据库迁移被分解成生成和应用两个命令是为了让你能够在代码控制系统上提交迁移数据并使其能在多个应用里使用;这不仅仅会让开发更加简单,也给别的开发者和生产环境中的使用带来方便。

初试API

  1. 进入交互式Python命令行,即进入shell界面

    通过以下命令打开 Python 命令行:

    ...\> py manage.py shell
    

  2. shell命令行展示

    (这里一步步展示即可,不必多说)

  3. 可以修改的地方

    1. q.question_text = "What's up?"
      >>> q.save()
      

      亦可以在网站创建后继续更改

    2. 在Choice处,与(1)相同

介绍Django管理页面

设计哲学(引用)

为你的员工或客户生成一个用户添加,修改和删除内容的后台是一项缺乏创造性和乏味的工作。因此,Django 全自动地根据模型创建后台界面。

Django 产生于一个公众页面和内容发布者页面完全分离的新闻类站点的开发过程中。站点管理人员使用管理系统来添加新闻、事件和体育时讯等,这些添加的内容被显示在公众页面上。Django 通过为站点管理人员创建统一的内容编辑界面解决了这个问题。

管理界面不是为了网站的访问者,而是为管理者准备的

创建管理员账号

创建一个登录管理的界面

...\> py manage.py createsuperuser

键入你想要使用的用户名,然后按下回车键:

Username: admin

然后提示你输入想要使用的邮件地址:

Email address: admin@example.com

最后一步是输入密码。你会被要求输入两次密码,第二次的目的是为了确认第一次输入的确实是你想要的密码。

Password: **********(tips:这里的密码是不会显示的,相当于盲打)
Password (again): *********(上同)
Superuser created successfully.

启动开发服务器

如果开发服务器未启动,用以下命令启动它:

...\> py manage.py runserver

现在,打开浏览器,转到你本地域名的 “/admin/” 目录, – 比如 http://127.0.0.1:8000/admin/ 。你应该会看见管理员登录界面:image-20220402111021930

进入管理站点

试着使用你在上一步中创建的超级用户来登录。然后你将会看到 Django 管理页面的索引页:

如下几种可编辑的内容:组和用户。它们是由 django.contrib.auth 提供的,这是 Django 开发的认证框架。

image-20220402111152152

加入投票系统

我们得告诉管理,问题 Question 对象需要一个后台接口。打开 polls/admin.py 文件,把它编辑成下面这样:

polls/admin.py

from django.contrib import admin

from .models import Question

admin.site.register(Question)

管理界面

image-20220402111339478

在这里可以任意进行更改question,操作组员,用户等等。

注意事项:

  • 这个表单是从问题 Question 模型中自动生成的
  • 不同的字段类型(日期时间字段 DateTimeField 、字符字段 CharField)会生成对应的 HTML 输入控件。每个类型的字段都知道它们该如何在管理页面里显示自己。
  • 每个日期时间字段 DateTimeField 都有 JavaScript 写的快捷按钮。日期有转到今天(Today)的快捷按钮和一个弹出式日历界面。时间有设为现在(Now)的快捷按钮和一个列出常用时间的方便的弹出式列表。

页面的底部提供了几个选项:

  • 保存(Save) - 保存改变,然后返回对象列表。
  • 保存并继续编辑(Save and continue editing) - 保存改变,然后重新载入当前对象的修改界面。
  • 保存并新增(Save and add another) - 保存改变,然后添加一个新的空对象并载入修改界面。
  • 删除(Delete) - 显示一个确认删除页面。

总结

当我们在全部创建好之后,在后续使用时的步骤如下

  1. 在cmd命令行打开至与manage.py同级别的目录mysite下,

  2. 然后输入

    py manage.py runserver
    

    image-20220402111637141

  3. 这样就打开了该网站。例如这个站点管理 | Django 站点管理员

后续更新

现在基础的站点已经建好,但如何继续美化,该网站的投票可视化,投票等等还没有出现,因此继续加入index等可视化操作

除(Delete) - 显示一个确认删除页面。

总结

当我们在全部创建好之后,在后续使用时的步骤如下

  1. 在cmd命令行打开至与manage.py同级别的目录mysite下,

  2. 然后输入

    py manage.py runserver
    

    [外链图片转存中…(img-MQdubnUe-1648870107058)]

  3. 这样就打开了该网站。例如这个站点管理 | Django 站点管理员

后续更新

现在基础的站点已经建好,但如何继续美化,该网站的投票可视化,投票等等还没有出现,因此继续加入index等可视化操作

在Django项目实战——用户投票系统(三)中尽详展出,敬请期待……

  • 4
    点赞
  • 17
    收藏
    觉得还不错? 一键收藏
  • 2
    评论
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值