Django系列教程（4）——实例项目使命管理小应用

目录
第一步：创建tasks应用，参加INSTALLED_APPS
第二步：创建Task模型及其关联表单
第三步：编写路由URLConf及视图
第四步：编写模板
第五步：运行项目，查看结果
GitHub源码地点
小结

---

本例中我们只讲述焦点逻辑，不浪费时间在前端样式上。文末有GitHub源码地点，内里同时包含了函数视图和基于类的视图, 详细演示结果如下所示：

第一步：创建tasks应用，参加INSTALLED_APPS

本例假设你已经有了一个mysite的Django项目。我们首先使用 python manage.py startapp tasks 创建一个名为”tasks”的app，并把它计入到settings.py的INSTALLED_APPS中去。

1. # mysite/settings.py
2. INSTALLED_APPS = [
3.      'django.contrib.admin',
4.      'django.contrib.auth',
5.      'django.contrib.contenttypes',
6.      'django.contrib.sessions',
7.      'django.contrib.messages',
8.      'django.contrib.staticfiles',
9.      'tasks',
10. ]

复制代码

然后把app下的urls路径添加到项目文件夹的urls.py里去。

1. from django.contrib import admin
2. from django.urls import path, include
4. urlpatterns = [
5.      path('admin/', admin.site.urls),
6.      path('tasks/', include('tasks.urls'))
7. ]

复制代码

第二步：创建Task模型及其关联表单

我们的Task模型非常简单，仅包含name和status两个字段。我们还使用ModelForm类创建了TaskForm，我们在创建使命或更新使命时必要用到这个表单。

1. # tasks/models.py
2. from django.db import models
4. class Status(models.TextChoices):
5.      UNSTARTED = 'u', "Not started yet"
6.      ONGOING = 'o', "Ongoing"
7.      FINISHED = 'f', "Finished"
10. class Task(models.Model):
11.      name = models.CharField(verbose_name="Task name", max_length=65, unique=True)
12.      status = models.CharField(verbose_name="Task status", max_length=1, choices=Status.choices)
14.      def __str__(self):
15.          return self.name
17. # tasks/forms.py
18. from .models import Task
19. from django import forms
21. class TaskForm(forms.ModelForm):
23.      class Meta:
24.          model = Task
25.          fields = "__all__"

复制代码

第三步：编写路由URLConf及视图

我们必要创建5个urls, 对应5个函数视图。这是由于对于Retrieve利用，我们必要编写两个函数视图，一个用户获取使命列表，一个用于获取使命详情。对于task_detail, task_update和task_delete这个三个视图函数，我们还必要通过urls通报使命id或pk参数，否则它们不知道对哪个对象进行利用。

1. # tasks/urls.py
2. from django.urls import path, re_path
3. from . import views
5. # namespace
6. app_name = 'tasks'
8. urlpatterns = [
9.      # Create a task
10.      path('create/', views.task_create, name='task_create'),
12.      # Retrieve task list
13.      path('', views.task_list, name='task_list'),
15.      # Retrieve single task object
16.      re_path(r'^(?P<pk>\d+)/$', views.task_detail, name='task_detail'),
18.      # Update a task
19.      re_path(r'^(?P<pk>\d+)/update/$', views.task_update, name='task_update'),
21.      # Delete a task
22.      re_path(r'^(?P<pk>\d+)/delete/$', views.task_delete, name='task_delete'),
23. ]

复制代码

下面5个函数视图代码是本应用的焦点代码，请细致阅读并去尝试明白每一行代码。

1. # tasks/views.py
3. from django.shortcuts import render, redirect, get_object_or_404
4. from django.urls import reverse
5. from .models import Task
6. from .forms import TaskForm
8. # Create a task
9. def task_create(request):
10.      # 如果用户通过POST提交，通过request.POST获取提交数据
11.      if request.method == "POST":
12.          # 将用户提交数据与TaskForm表单绑定
13.          form = TaskForm(request.POST)
14.          # 表单验证，如果表单有效，将数据存入数据库
15.          if form.is_valid():
16.              form.save()
17.              # 跳转到任务清单
18.              return redirect(reverse("tasks:task_list"))
19.      else:
20.          # 否则空表单
21.          form = TaskForm()
22.      return render(request, "tasks/task_form.html", { "form": form, })
24. # Retrieve task list
25. def task_list(request):
26.      # 从数据库获取任务清单
27.      tasks = Task.objects.all()
28.      # 指定渲染模板并传递数据
29.      return render(request, "tasks/task_list.html", { "tasks": tasks,})
31. # Retrieve a single task
32. def task_detail(request, pk):
33.      # 从url里获取单个任务的pk值，然后查询数据库获得单个对象
34.      task = get_object_or_404(Task, pk=pk)
35.      return render(request, "tasks/task_detail.html", { "task": task, })
37. # Update a single task
38. def task_update(request, pk):
39.      # 从url里获取单个任务的pk值，然后查询数据库获得单个对象实例
40.      task_obj = get_object_or_404(Task, pk=pk)
41.      if request.method == 'POST':
42.          form = TaskForm(instance=task_obj, data=request.POST)
43.          if form.is_valid():
44.              form.save()
45.              return redirect(reverse("tasks:task_detail", args=[pk,]))
46.      else:
47.          form = TaskForm(instance=task_obj)
48.      return render(request, "tasks/task_form.html", { "form": form, "object": task_obj})
51. # Delete a single task
52. def task_delete(request, pk):
53.      # 从url里获取单个任务的pk值，然后查询数据库获得单个对象
54.      task_obj = get_object_or_404(Task, pk=pk)
55.      task_obj.delete() # 删除然后跳转
56.      return redirect(reverse("tasks:task_list"))

复制代码

第四步：编写模板

虽然我们有5个urls，但我们只必要创建3个模板:task_list.html, task_detail.html 和task_form.html。 最后一个模板由task_create 和task_update 视图函数共享。我们在模板中对实例对象进行判定，如果对象已存在则模板对于更新使命，否则是创建使命。task_delete视图不必要模板。

2. # tasks/templates/tasks/task_list.html
3. <!DOCTYPE html>
4. <html lang="en">
5. <head>
6.      <meta charset="UTF-8">
7.      <title>Task List</title>
8. </head>
9. <body>
10. <h3>Task List</h3>
11. {% for task in tasks %}
12.      <p>{{ forloop.counter }}. {{ task.name }} - {{ task.get_status_display }}
13.          (<a href="{% url 'tasks:task_update' task.id %}">Update</a> |
14.          <a href="{% url 'tasks:task_delete' task.id %}">Delete</a>)
15.      </p>
16. {% endfor %}
17. <p> <a href="{% url 'tasks:task_create' %}"> + Add A New Task</a></p>
18. </body>
19. </html>
22. # tasks/templates/tasks/task_detail.html
23. <!DOCTYPE html>
24. <html lang="en">
25. <head>
26.      <meta charset="UTF-8">
27.      <title>Task Detail</title>
28. </head>
29. <body>
30. <p> Task Name: {{ task.name }} | <a href="{% url 'tasks:task_update' task.id %}">Update</a> |
31.      <a href="{% url 'tasks:task_delete' task.id %}">Delete</a>
32. </p>
33. <p> Task Status: {{ task.get_status_display }} </p>
34. <p> <a href="{% url 'tasks:task_list' %}">View All Tasks</a> |
35.      <a href="{% url 'tasks:task_create'%}">New Task</a>
36. </p>
37. </body>
38. </html>
41. # tasks/templates/tasks/task_form.html
42. <!DOCTYPE html>
43. <html lang="en">
44. <head>
45.      <meta charset="UTF-8">
46.      <title>{% if object %}Edit Task {% else %} Create New Task {% endif %}</title>
47. </head>
48. <body>
49. <h3>{% if object %}Edit Task {% else %} Create New Task {% endif %}</h3>
50.      <form action="" method="post" enctype="multipart/form-data">
51.          {% csrf_token %}
52.          {{ form.as_p }}
53.          <p><input type="submit" class="btn btn-success" value="Submit"></p>
54.      </form>
55. </body>
56. </html>

复制代码

第五步：运行项目，查看结果

运行如下下令，访问http://127.0.0.1:8000/tasks/就应该看到文初结果了。

1. python manage.py makemigrations
2. python manage.py migrate
3. python manage.py runserver

复制代码

GitHub源码地点

本项目源码地点，内里同时包含了函数视图和基于类的视图。
小结

本例中我们使用了函数视图(functional-based views, FBV)编写了一个使命管理的CRUD小应用，后面我们将使用基于类的视图(class-based views, CBV)重写本例演示代码。
接下来几章我们将详细先容模型、视图、URL的设置以及模板的根本知识，接待关注。


免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。