使用rest_framework.decorators在Python中定义API返回格式

在Python中，我们可以使用rest_framework.decorators模块来定义API的返回格式。这个模块提供了一系列的装饰器，可以用于定义API视图函数的返回格式。以下是一些常用的装饰器及其使用示例：

1. @api_view(['METHOD']): 用于指定API视图函数支持的HTTP方法。METHOD可以是列表包含多个方法（如['GET', 'POST']），或者是一个单独的方法（如'PUT'）。下面是一个使用@api_view装饰器的例子：

from rest_framework.decorators import api_view
from rest_framework.response import Response

@api_view(['GET'])
def hello_world(request):
    return Response({"message": "Hello, World!"})

2. @permission_classes([PERMISSION]): 用于指定API视图函数的权限类。PERMISSION可以是一个或多个权限类的列表。下面是一个使用@permission_classes装饰器的例子：

from rest_framework.decorators import api_view, permission_classes
from rest_framework.permissions import IsAuthenticated

@api_view(['GET'])
@permission_classes([IsAuthenticated])
def protected_view(request):
    return Response({"message": "You are authenticated."})

3. @renderer_classes([RENDERER]): 用于指定API视图函数的渲染器类。RENDERER可以是一个或多个渲染器类的列表。下面是一个使用@renderer_classes装饰器的例子：

from rest_framework.decorators import api_view, renderer_classes
from rest_framework.renderers import JSONRenderer

@api_view(['GET'])
@renderer_classes([JSONRenderer])
def json_view(request):
    data = {"message": "This is a JSON response."}
    return Response(data)

4. @throttle_classes([THROTTLE]): 用于指定API视图函数的节流器类。THROTTLE可以是一个或多个节流器类的列表。下面是一个使用@throttle_classes装饰器的例子：

from rest_framework.decorators import api_view, throttle_classes
from rest_framework.throttling import UserRateThrottle

@api_view(['POST'])
@throttle_classes([UserRateThrottle])
def create_view(request):
    # 处理创建对象的逻辑
    return Response({"message": "Object created."})

5. @parser_classes([PARSER]): 用于指定API视图函数的解析器类。PARSER可以是一个或多个解析器类的列表。下面是一个使用@parser_classes装饰器的例子：

from rest_framework.decorators import api_view, parser_classes
from rest_framework.parsers import JSONParser

@api_view(['POST'])
@parser_classes([JSONParser])
def create_view(request):
    # 处理创建对象的逻辑
    return Response({"message": "Object created."})

以上是一些常用的装饰器及其使用示例，通过在API视图函数上应用这些装饰器，我们可以灵活地定义API的返回格式。