Step2: 实现博客首页文章列表 API

Author: zmrenwu

.idea/HelloDjango-rest-framework-tutorial.iml

@@ -190,6 +190,7 @@ $ git clone https://github.com/HelloGitHub-Team/HelloDjango-REST-framework-tutor
 1. [开篇](https://www.zmrenwu.com/courses/django-rest-framework-tutorial/)
 2. [django-rest-framework 是什么鬼？](https://www.zmrenwu.com/courses/django-rest-framework-tutorial/materials/91/)
 3. [初始化 RESTful API 风格的博客系统](https://www.zmrenwu.com/courses/django-rest-framework-tutorial/materials/92/)
+4. [实现博客首页文章列表 API](https://www.zmrenwu.com/courses/django-rest-framework-tutorial/materials/92/)
 
 ## 公众号
 <p align="center">

.idea/misc.xml

@@ -0,0 +1,39 @@
+from django.contrib.auth.models import User
+from rest_framework import serializers
+
+from .models import Category, Post
+
+
+class CategorySerializer(serializers.ModelSerializer):
+    class Meta:
+        model = Category
+        fields = [
+            "id",
+            "name",
+        ]
+
+
+class UserSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = User
+        fields = [
+            "id",
+            "username",
+        ]
+
+
+class PostListSerializer(serializers.ModelSerializer):
+    category = CategorySerializer()
+    author = UserSerializer()
+
+    class Meta:
+        model = Post
+        fields = [
+            "id",
+            "title",
+            "created_time",
+            "excerpt",
+            "category",
+            "author",
+            "views",
+        ]

README.md

@@ -2,12 +2,14 @@
 
 from . import views
 
-app_name = 'blog'
+app_name = "blog"
 urlpatterns = [
-    path('', views.IndexView.as_view(), name='index'),
-    path('posts/<int:pk>/', views.PostDetailView.as_view(), name='detail'),
-    path('archives/<int:year>/<int:month>/', views.ArchiveView.as_view(), name='archive'),
-    path('categories/<int:pk>/', views.CategoryView.as_view(), name='category'),
-    path('tags/<int:pk>/', views.TagView.as_view(), name='tag'),
-    # path('search/', views.search, name='search'),
+    path("", views.IndexView.as_view(), name="index"),
+    path("posts/<int:pk>/", views.PostDetailView.as_view(), name="detail"),
+    path(
+        "archives/<int:year>/<int:month>/", views.ArchiveView.as_view(), name="archive"
+    ),
+    path("categories/<int:pk>/", views.CategoryView.as_view(), name="category"),
+    path("tags/<int:pk>/", views.TagView.as_view(), name="tag"),
+    path("api/index/", views.index),
 ]

blog/serializers.py

@@ -2,10 +2,14 @@
 from django.db.models import Q
 from django.shortcuts import get_object_or_404, redirect, render
 from django.views.generic import DetailView, ListView
+from rest_framework import status
+from rest_framework.decorators import api_view
+from rest_framework.response import Response
 
 from pure_pagination.mixins import PaginationMixin
 
 from .models import Category, Post, Tag
+from .serializers import PostListSerializer
 
 
 class IndexView(PaginationMixin, ListView):
@@ -58,3 +62,10 @@ def get(self, request, *args, **kwargs):
 
         # 视图必须返回一个 HttpResponse 对象
         return response
+
+
+@api_view(http_method_names=["GET"])
+def index(request):
+    post_list = Post.objects.all().order_by("-created_time")
+    serializer = PostListSerializer(post_list, many=True)
+    return Response(serializer.data, status=status.HTTP_200_OK)