编写你的第一个 Django 应用半成品

Posted pu369com

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了编写你的第一个 Django 应用半成品相关的知识,希望对你有一定的参考价值。

英语不好,幸好Django官方3.0版教程有中文版,对照官方教程将初学者部分过一下

win10   python 3.7.7  

第1 部分  

1 安装 

python -m pip install Django

创建项目-打开命令行,cd 到一个你想放置你代码的目录(如:www),然后运行以下命令:

 django-admin startproject mysite

2 测试

在www/mysite目录中打开命令行

python manage.py runserver 8000

3 创建投票应用

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

请确定你现在处于 manage.py 所在的目录下,然后运行这行命令来创建一个应用:

python manage.py startapp polls

 这将会创建一个 polls 目录,这个目录结构包括了投票应用的全部内容。

4 编写第一个视图

打开 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 文件,代码:

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 admin
from django.urls import include, path

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

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

可能要重新python manage.py runserver 8000

现在,用你的浏览器访问 http://localhost:8000/polls/,你应该能够看见 "Hello, world. You\'re at the polls index."

第 2 部分

1 数据库配置

现在,打开 mysite/settings.py 。这是个包含了 Django 项目设置的 Python 模块。可看到默认使用了SQLite

编辑 mysite/settings.py 文件,先设置 TIME_ZONE 为你自己时区,如:TIME_ZONE = \'Asia/Shanghai\'      USE_TZ = False  

设置中文:LANGUAGE_CODE = \'zh-hans\'

此外,关注一下文件头部的 INSTALLED_APPS 设置项。这里包括了会在你项目中启用的所有 Django 应用。

这些应用被默认启用是为了给常规项目提供方便。如:django.contrib.admin -- 管理员站点

默认开启的某些应用需要至少一个数据表,所以,在使用他们之前需要在数据库中创建一些表。请执行以下命令:

python manage.py migrate

写给极简主义者:你可以在运行 migrate 前毫无顾虑地从 INSTALLED_APPS 里注释或者删除掉它们。 migrate 命令只会为在 INSTALLED_APPS 里声明了的应用进行数据库迁移。

2 创建模型

在这个投票应用中,需要创建两个模型:问题 Question 和选项 Choice。 Question 模型包括问题描述和发布时间。Choice 模型有两个字段,选项描述和当前得票数。每个选项属于一个问题。这些概念可以通过一个 Python 类来描述。按照下面的例子来编辑 polls/models.py 文件:

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)

3 激活模型

但是首先得把 polls 应用安装到我们的项目里。(设计哲学:Django 应用是“可插拔”的。)

我们需要在配置类 INSTALLED_APPS 中添加设置。因为 PollsConfig 类写在文件 polls/apps.py 中,所以它的点式路径是 \'polls.apps.PollsConfig\'。在文件 mysite/settings.pyINSTALLED_APPS 子项添加点式路径后,它看起来像这样:

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 应用。接着运行下面的命令:

python manage.py makemigrations polls

通过运行 makemigrations 命令,Django 会检测你对模型文件的修改

现在,再次运行 migrate 命令,在数据库里创建新定义的模型的数据表:

python manage.py migrate

现在,你只需要记住,改变模型需要这三步:

4 初试 API

编辑 Question 模型的代码(位于 polls/models.py 中),给 QuestionChoice 增加 __str__() 方法。

from django.db import models

class Question(models.Model):
    # ...
    def __str__(self):
        return self.question_text

class Choice(models.Model):
    # ...
    def __str__(self):
        return self.choice_text

给模型增加 __str__() 方法是很重要的,这不仅仅能给你在命令行里使用带来方便,Django 自动生成的 admin 里也使用这个方法来表示对象。

让我们再为此模型添加一个自定义方法:

import datetime

from django.db import models
from django.utils import timezone


class Question(models.Model):
    # ...
    def was_published_recently(self):
        return self.pub_date >= timezone.now() - datetime.timedelta(days=1)

新加入的 import datetimefrom django.utils import timezone 分别导入了 Python 的标准 datetime 模块和 Django 中和时区相关的 django.utils.timezone 工具模块。如果你不太熟悉 Python 中的时区处理,看看 时区支持文档 吧。

保存文件然后通过 python manage.py shell 命令再次打开 Python 交互式命令行:

from polls.models import Choice, Question,datetime
q = Question(question_text="What\'s new?", pub_date=datetime.datetime.now())
q.save()
q.id Question.objects.all()

阅读 访问关系对象 文档可以获取关于数据库关系的更多内容。想知道关于双下划线的更多用法,参见 查找字段 文档。数据库 API 的所有细节可以在 数据库 API 参考 文档中找到。

5  介绍 Django 管理页面

5.1 创建一个管理员账号

python manage.py createsuperuser

输入admin 及邮箱,设置密码如:1234

如果开发服务器未启动,用以下命令启动它:python manage.py runserver

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

5.2进入管理站点页面

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

(因为 翻译 功能默认是开着的,所以登录界面可能会使用你的语言,取决于你浏览器的设置和 Django 是否拥有你语言的翻译。)

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

 5.3 向管理页面中加入投票应用

但是我们的投票应用在哪呢?它没在索引页面里显示。

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

from django.contrib import admin

from .models import Question

admin.site.register(Question)

5.4体验便捷的管理功能

现在我们向管理页面注册了问题 Question 类。Django 知道它应该被显示在索引页里(刷新浏览器可以看到效果)  

第 3 部分 

编写更多视图

现在让我们向 polls/views.py 里添加更多视图。这些视图有一些不同,因为他们接收参数:

def detail(request, question_id):
    return HttpResponse("You\'re looking at question %s." % question_id)

def results(request, question_id):
    response = "You\'re looking at the results of question %s."
    return HttpResponse(response % question_id)

def vote(request, question_id):
    return HttpResponse("You\'re voting on question %s." % question_id)

把这些新视图添加进 polls.urls 模块里,只要添加几个 url() 函数调用就行:

polls/urls.py:

from django.urls import path

from . import views

urlpatterns = [
    # ex: /polls/
    path(\'\', views.index, name=\'index\'),
    # ex: /polls/5/
    path(\'<int:question_id>/\', views.detail, name=\'detail\'),
    # ex: /polls/5/results/
    path(\'<int:question_id>/results/\', views.results, name=\'results\'),
    # ex: /polls/5/vote/
    path(\'<int:question_id>/vote/\', views.vote, name=\'vote\'),
]

然后看看你的浏览器,如果你转到 "/polls/34/" ,Django 将会运行 detail() 方法并且展示你在 URL 里提供的问题 ID。再试试 "/polls/34/vote/" 和 "/polls/34/vote/" ——你将会看到暂时用于占位的结果和投票页。

写一个真正有用的视图

每个视图必须要做的只有两件事:返回一个包含被请求页面内容的 HttpResponse 对象,或者抛出一个异常,比如 Http404 。至于你还想干些什么,随便你。Django 只要求返回的是一个 HttpResponse ,或者抛出一个异常。

让我们使用 Django 的模板系统,只要创建一个视图,就可以将页面的设计从代码中分离出来。

首先,在你的 polls 目录里创建一个 templates 目录。Django 将会在这个目录里查找模板文件。(默认的设置文件设置了 DjangoTemplates 后端,并将 APP_DIRS 设置成了 True。这一选项将会让 DjangoTemplates 在每个 INSTALLED_APPS 文件夹中寻找 "templates" 子目录。)

在你刚刚创建的 templates 目录里,再创建一个目录 polls,然后在其中新建一个文件 index.html 。换句话说,你的模板文件的路径应该是 polls/templates/polls/index.html

将下面的代码输入到刚刚创建的模板文件index.html中:

<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8">
    <title>My test page</title>
  </head>
  <body>
  {% if latest_question_list %}
    <ul>
    {% for question in latest_question_list %}
        <li><a href="/polls/{{ question.id }}/">{{ question.question_text }}</a></li>
    {% endfor %}
    </ul>
{% else %}
    <p>No polls are available.</p>
{% endif %}
  </body>
</html>

然后,让我们更新一下 polls/views.py 里的 index 视图来使用模板:

from django.http import HttpResponse
from django.template import loader

from .models import Question


def index(request):
    latest_question_list = Question.objects.order_by(\'-pub_date\')[:5]
    template = loader.get_template(\'polls/index.html\')
    context = {
        \'latest_question_list\': latest_question_list,
    }
    return HttpResponse(template.render(context, request))

用你的浏览器访问 "/polls/" ,你将会看见一个无序列表

一个快捷函数: render()

「载入模板,填充上下文,再返回由它生成的 HttpResponse 对象」是一个非常常用的操作流程。于是 Django 提供了一个快捷函数,我们用它来重写 index() 视图:polls/views.py:

from django.shortcuts import render

from .models import Question


def index(request):
    latest_question_list = Question.objects.order_by(\'-pub_date\')[:5]
    context = {\'latest_question_list\': latest_question_list}
    return render(request, \'polls/index.html\', context)

注意到,我们不再需要导入 loaderHttpResponse 。不过如果你还有其他函数(比如说 detail, results, 和 vote )需要用到它的话,就需要保持 HttpResponse 的导入。

 一个快捷函数: get_object_or_404()

尝试用 get() 函数获取一个对象,如果不存在就抛出 Http404 错误也是一个普遍的流程。Django 也提供了一个快捷函数,下面是修改后的详情 detail() 视图代码polls/views.py:

from django.shortcuts import get_object_or_404, render

from .models import Question
# ...
def detail(request, question_id):
    question = get_object_or_404(Question, pk=question_id)
    return render(request, \'polls/detail.html\', {\'question\': question})

 我们稍后再讨论你需要在 polls/detail.html 里输入什么,但是如果你想试试上面这段代码是否正常工作的话,你可以暂时把下面这段输进去:

<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8">
    <title>My test page</title>
  </head>
  <body>
{{ question }}
  </body>
</html>

 

本教程就到这里吧,还是看官方原版吧。 

 

 

参考:https://www.cnblogs.com/it-tsz/p/10099756.html

https://docs.djangoproject.com/zh-hans/3.0/

https://blog.csdn.net/MrNoboday/article/details/91805040

以上是关于编写你的第一个 Django 应用半成品的主要内容,如果未能解决你的问题,请参考以下文章

编写你的第一个Django应用程序,第四部分

Django L1 编写你的第一个Django应用,第1部分

Django L2 编写你的第一个Django应用,第2部分¶

编写你的第一个Django应用程序

编写你的第一个 Django 应用程序,第8部分

编写你的第一个 Django 应用程序,第6部分