创建并运行您的第一个 Django 项目

在你开始之前

创建一个新项目

探索项目结构

启动 Django 服务器

创建模型

Django模型定义数据的字段和行为。它们由 Python 类表示，这些类是该类的子类django.db.models.Model。

让我们ToDoItem为我们的待办事项应用程序创建一个模型。为此，请打开todo/models.py并填充以下代码：

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


class ToDoItem(models.Model):
    text = models.CharField(max_length=100)
    due_date = models.DateField(default=timezone.now)

运行迁移

默认情况下，PyCharm 会自动为 Django 项目创建 SQLite 数据库。我们需要在数据库中为todo应用程序和ToDoItem模型创建表。在 Django 中，这是通过使用migrations来完成的。迁移是人类可编辑的文件，其中存储对数据模型的更改。

写一个视图

from django.views.generic import ListView
from .models import ToDoItem


class AllToDos(ListView):
    model = ToDoItem
    template_name = "todo/index.html"

这里我们定义了AllToDos继承自 DjangoListView基本视图类的类。我们将使用此视图来显示所有可用的待办事项。

创建模板

您可以看到todo/index.html在views.py中突出显示为未解析的引用：

PyCharm 建议一个快速修复：如果将鼠标悬停在index.html或按，您可以选择在templates文件夹中创建相应的模板文件：AltEnter

PyCharm 创建并打开todo/index.html。要使用一些基本的 html 代码填充它，请输入html:5以下内容：Tab

让我们将带有 Django 模板语言元素的内容添加到模板中。将以下代码粘贴到body标签之间：

<h1>Things to do:</h1>
<table>
    {% for item in object_list %}
    <tr>
        <td>{{ item.text }}</td>
        <td>{{ item.due_date }}</td>
    </tr>
    {% endfor %}
</table>

有一个h1标题和一个表格。我们使用循环来迭代将从视图传递的for项目。对于每个项目，Django 将在表中呈现一行，其中包含和的值。object_listAllToDostextdue_date

配置网址

AllToDos现在我们需要配置在浏览器中访问视图的方式。

在todo目录中，创建文件 urls.py并填充以下代码：

from django.urls import path
from . import views

urlpatterns = [
    path("", views.AllToDos.as_view(), name="index")
]

接下来，打开文件myDjangoProject/urls.py （PyCharm 已为您创建）并将其配置为包含todo/urls.py中的路径。您最终应该得到以下代码：
```
from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path("todo/", include("todo.urls")),
    path("admin/", admin.site.urls),
]
```
不要忘记导入django.urls.include！
在浏览器中打开页面http://127.0.0.1:8000/todo/ 。您应该看到以下文本：

使用 Django 管理

登录后，将显示管理页面。它具有身份验证和授权（组和用户）部分，但无法添加待办事项。为此，我们必须ToDoItem在管理界面中注册模型。

添加内容

打开文件todo/admin.py，然后输入以下代码：

from django.contrib import admin
from .models import ToDoItem


admin.site.register(ToDoItem)

在浏览器中刷新页面。应出现包含待办事项的TODO部分：
单击“添加”以创建待办事项：
准备好后，单击“保存”。

新创建的待办事项在列表中显示为ToDoItem object (1)。这种命名使内容管理变得复杂，因为您必须打开每个任务才能阅读其描述。

让我们通过__str__()向ToDoItem模型添加一个方法来解决这个问题。打开todo/models.py并添加以下内容：

def __str__(self):
    return f"{self.text}: due {self.due_date}"

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


class ToDoItem(models.Model):
    text = models.CharField(max_length=100)
    due_date = models.DateField(default=timezone.now)

    def __str__(self):
        return f"{self.text}: due {self.due_date}"

提供功能

转到views.pyTodayToDos并使用以下代码添加类：

class TodayToDos(ListView):
    model = ToDoItem
    template_name = "todo/today.html"

    def get_queryset(self):
        return ToDoItem.objects.filter(due_date=date.today())

这个类与非常相似AllToDos，除了它使用另一个模板（我们稍后将创建）并实现get_queryset仅返回今天的ToDoItem对象的方法due_date。

date应用红色波浪线突出显示。将鼠标悬停在其上，单击“导入此名称”，然后选择“datetime.date”以在文件开头添加相应的导入语句。

通过右键单击“项目”工具窗口中的模板并选择“新建”| “myDjangoProject/templates” ，在myDjangoProject/templates 中创建base.html 。上下文菜单中的HTML 文件。

将代码从index.html复制到base.html，然后<body>用以下内容替换标签之间的所有内容：

{% block content %}{% endblock %}

myDjangoProject /templates /base.html应该是这样的：

<!doctype html>
<html lang="en">
    <head>
        <meta charset="UTF-8">
        <meta name="viewport"
              content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
        <meta http-equiv="X-UA-Compatible" content="ie=edge">
        <title>Document</title>
    </head>
    <body>
        {% block content %}{% endblock %}
    </body>
</html>

转到index.html<h1> ，删除除和标记内容之外的所有内容<table>，然后将它们包含在 Django 模板语言元素中，如下所示：

{% extends "base.html" %}
{% block content %}
    <h1>Things to do:</h1>
    <table>
        {% for item in object_list %}
        <tr>
            <td>{{ item.text }}</td>
            <td>{{ item.due_date }}</td>
        </tr>
        {% endfor %}
    </table>
{% endblock %}

创建myDjangoProject /templates /todo /today.html并用以下代码填充它：

{% extends "base.html" %}
{% block content %}
    <h1>Things to do today:</h1>
    <table>
        {% for item in object_list %}
        <tr>
            <td>{{ item.text }}</td>
        </tr>
        {% endfor %}
    </table>
{% endblock %}

请注意，我们在这里不需要截止日期，因为此页面仅显示截止日期为今天的待办事项。

我们还需要配置在浏览器中访问今天任务的方式。转到myDjangoProject /todo /urls.py并添加path("today/", views.TodayToDos.as_view(), name="today")以urlpatterns获取以下内容：

from django.urls import path
from . import views

urlpatterns = [
    path("", views.AllToDos.as_view(), name="index"),
    path("today/", views.TodayToDos.as_view(), name="today")
]

改善体验

改善 html 页面外观的最简单方法是实施 CSS。例如，我们可以使用简单的 CSS。打开base.html并将以下行放在<head>标签之间的任意位置：

<link rel="stylesheet" href="https://cdn.simplecss.org/simple.min.css">

现在让我们添加一些导航元素以避免在浏览器地址栏中输入地址。在base.html中，将以下代码粘贴到开始<body>标记后：

<div>
    <a class="button" href='{% url "index" %}'>All tasks</a>
    <a class="button" href='{% url "today" %}'>Today</a>
</div>

测试应用程序

from datetime import date, timedelta

from django.test import TestCase
from django.urls import reverse
from .models import ToDoItem


def create_todo(todo_text, days):
    return ToDoItem.objects.create(text=todo_text, due_date=date.today() + timedelta(days=days))


class AllToDosViewTest(TestCase):

    def test_today(self):
        todo = create_todo("To be done today", 0)
        response = self.client.get(reverse("index"))
        self.assertQuerySetEqual(
            response.context["todoitem_list"],
            [todo]
        )

    def test_last_week(self):
        todo = create_todo("This task is past due", -7)
        response = self.client.get(reverse("index"))
        self.assertQuerySetEqual(
            response.context["todoitem_list"],
            []
        )

    def test_next_week(self):
        todo = create_todo("Still have some time", 7)
        response = self.client.get(reverse("index"))
        self.assertQuerySetEqual(
            response.context["todoitem_list"],
            [todo]
        )

这里，create_todo是一个创建待办事项的快捷函数，AllToDosViewTest是一个具有 3 个方法的测试类：test_today, test_last_week, test_next_week。每个方法都会创建一个具有相应截止日期的任务，然后检查该任务是否呈现在应用程序的主页上。不应显示截止日期为当前日期前 7 天的任务。

您可以看到test_last_week失败了，因为创建的待办事项已添加到将显示在主页上的项目列表中，尽管已过期。

让我们通过将get_queryset方法添加到AllToDos类来修复它：

def get_queryset(self):
    return ToDoItem.objects.filter(due_date__gte=date.today())

该方法将过滤对象，以便视图仅返回那些截止日期大于或等于今天日期（这就是代表的日期__gte）的任务。

专业的创建并运行您的第一个 Django 项目﻿

在你开始之前﻿

创建一个新项目﻿

探索项目结构﻿

启动 Django 服务器﻿

创建模型﻿

运行迁移﻿

写一个视图﻿

创建模板﻿

配置网址﻿

使用 Django 管理﻿

设置管理站点﻿

添加内容﻿

提供功能﻿

改善体验﻿

测试应用程序﻿

概括﻿

专业的
创建并运行您的第一个 Django 项目