Menu
CoddyTech

使用 POST 创建

本课属于 Coddy Django 学习旅程的“JSON API”单元。第 5 课,共 19 课。

程序可以读取你的任务,但不能添加任务。要创建任务,程序会向列表的 URL 发送一个 POST 请求,并将任务作为 JSON 放在请求的 正文 中,也就是随请求一起传输的数据。表单会填充 request.POST,JSON 则不会。读取原始请求正文 request.body,并用 json.loads 将其转换为 Python 数据。

一个 URL 可以根据 request.method 执行两种操作。这个视图只会回显收到的内容:

import json


def echo(request):
    if request.method == "POST":
        data = json.loads(request.body)
        return JsonResponse({"you_sent": data})
    return JsonResponse({"hint": "Send me a POST"})

创建对象的视图会返回 201 已创建 状态和新对象,这样程序就能知道它的 id。

地址栏只会发送 GET 请求,因此你要在 Shell 标签页中尝试发送 POST 请求。Django 的测试 Client 会通过 Python 向你的网站发送请求,而 .json() 会读取响应。Shell 会将它打印为 Python 字典:'done': False,而不是 JSON 中的 false。

challenge icon

挑战

中等

让程序创建一个任务。

  1. 在 tasks/views.py 中,添加 import json。在 task_list 的开头,如果请求方法是 POST,就根据 JSON 请求正文中的 title 和 priority 创建任务(默认值为 normal)。
  2. 使用 task_to_dict 返回新任务,并设置状态码为 201。保留下面的 GET 代码。

在 Shell 选项卡中运行下面这行代码:它会打印优先级为 normal 的 Pay rent。

from django.test import Client; print(Client().post("/api/tasks/", {"title": "Pay rent"}, content_type="application/json").json())

亲手试试

from django.http import JsonResponse
from django.shortcuts import render

from .models import Task


def task_to_dict(task):
    return {
        "id": task.id,
        "title": task.title,
        "done": task.done,
        "priority": task.priority,
    }


def home(request):
    return render(request, "tasks/home.html", {"tasks": Task.objects.all()})


def stats(request):
    data = {
        "total": Task.objects.count(),
        "done": Task.objects.filter(done=True).count(),
    }
    return JsonResponse(data)


def task_list(request):
    tasks = Task.objects.all()
    done = request.GET.get("done")
    if done == "true":
        tasks = tasks.filter(done=True)
    elif done == "false":
        tasks = tasks.filter(done=False)
    return JsonResponse([task_to_dict(task) for task in tasks], safe=False)


def task_detail(request, pk):
    task = Task.objects.filter(pk=pk).first()
    if task is None:
        return JsonResponse({"error": "Task not found"}, status=404)
    return JsonResponse(task_to_dict(task))
quiz icon自我测试

这节课包含一个小测验。开始学习即可作答,并记录你的进度。

JSON API中的所有课

自己练习: Django 在线编辑器