使用rest_framework.decorators在Python中定义API文档化

使用rest_framework.decorators可以很方便地进行API文档化，以下是一个使用例子：

假设我们有一个Django项目，其中有一个名为"books"的应用程序，该应用程序有一个"Book"模型，我们希望为该模型创建一个API，并对其进行文档化。

首先，我们需要安装Django REST Framework（DRF），可以使用以下命令进行安装：

pip install djangorestframework

接下来，在settings.py文件中，在"INSTALLED_APPS"中添加'django.contrib.contenttypes'和'rest_framework'：

INSTALLED_APPS = [
    ...
    'django.contrib.contenttypes',
    'rest_framework',
    ...
]

然后，在项目的urls.py文件中，添加以下代码来定义我们的API：

from django.urls import path
from rest_framework.decorators import api_view
from rest_framework.response import Response

@api_view(['GET'])
def book_list(request):
    """
    获取所有书籍的列表
    """
    books = Book.objects.all()
    serializer = BookSerializer(books, many=True)
    return Response(serializer.data)

@api_view(['POST'])
def book_create(request):
    """
    创建一本新书
    """
    serializer = BookSerializer(data=request.data)
    if serializer.is_valid():
        serializer.save()
        return Response(serializer.data, status=201)
    return Response(serializer.errors, status=400)

@api_view(['GET'])
def book_detail(request, pk):
    """
    获取指定ID的书籍详情
    """
    try:
        book = Book.objects.get(pk=pk)
    except Book.DoesNotExist:
        return Response(status=404)

    serializer = BookSerializer(book)
    return Response(serializer.data)

@api_view(['PUT'])
def book_update(request, pk):
    """
    更新指定ID的书籍详情
    """
    try:
        book = Book.objects.get(pk=pk)
    except Book.DoesNotExist:
        return Response(status=404)

    serializer = BookSerializer(book, data=request.data)
    if serializer.is_valid():
        serializer.save()
        return Response(serializer.data)
    return Response(serializer.errors, status=400)

@api_view(['DELETE'])
def book_delete(request, pk):
    """
    删除指定ID的书籍
    """
    try:
        book = Book.objects.get(pk=pk)
    except Book.DoesNotExist:
        return Response(status=404)

    book.delete()
    return Response(status=204)

urlpatterns = [
    path('books/', book_list, name='book-list'),
    path('books/create/', book_create, name='book-create'),
    path('books/<int:pk>/', book_detail, name='book-detail'),
    path('books/<int:pk>/update/', book_update, name='book-update'),
    path('books/<int:pk>/delete/', book_delete, name='book-delete'),
]

在上述示例中，我们使用@api_view装饰器来指定每个视图函数的请求方法和文档注释。对于GET请求，我们的装饰器标记为@api_view(['GET'])，对于POST请求，我们的装饰器标记为@api_view(['POST'])，以此类推。

在每个视图函数中，我们使用Response类来返回结果。我们还使用Django REST Framework的序列化器来序列化和反序列化我们的模型对象。

最后，在每个视图函数的文档字符串中，我们使用三重引号来编写API的文档注释，以便自动生成API文档。

当我们运行项目并访问定义的API时，Django REST Framework将使用这些文档注释来生成一个可浏览的API文档。我们可以在浏览器中访问http://localhost:8000/docs/来查看API文档。