### Django `api_view` 装饰器的功能和使用方法 #### 功能概述 `api_view` 是 Django REST Framework (DRF) 提供的一个装饰器，用于将普通的函数视图转换为基于 DRF 的 API 视图[^1]。通过这个装饰器，可以轻松实现 HTTP 请求的方法限制、异常处理以及渲染器的支持等功能。 #### 使用方法 以下是 `api_view` 的基本用法： 1. **指定允许的 HTTP 方法** 需要在装饰器中传入一个列表参数，表示该视图支持哪些 HTTP 方法（如 GET、POST 等）。如果未提供此参数，默认只支持 GET 请求。 2. **集成 DRF 特性** 应用了 `api_view` 的视图会自动获得 DRF 提供的一些特性，比如请求对象 (`request`) 支持 JSON 数据解析、响应对象 (`Response`) 自动序列化数据等。 3. **示例代码** ```python from rest_framework.decorators import api_view from rest_framework.response import Response from rest_framework import status @api_view(['GET', 'POST']) # 指定支持的HTTP方法 def example_api_view(request): if request.method == 'GET': data = {'message': 'This is a GET response'} return Response(data) elif request.method == 'POST': try: some_data = request.data.get('key') # 获取 POST 数据 return Response({'received': some_data}, status=status.HTTP_201_CREATED) except Exception as e: return Response({'error': str(e)}, status=status.HTTP_400_BAD_REQUEST) ``` 上述代码展示了如何利用 `api_view` 创建一个简单的 API 接口，分别处理 GET 和 POST 请求，并返回相应的响应数据。 #### 权限控制 对于权限管理，在 `api_view` 中可以通过设置全局配置或者局部应用特定的权限类来实现访问控制。例如： ```python from rest_framework.permissions import IsAuthenticated from rest_framework.decorators import api_view, permission_classes @api_view(['GET']) @permission_classes([IsAuthenticated]) # 设置仅认证用户可访问 def restricted_view(request): return Response({"detail": "You are authenticated."}) ``` 这里引入了 `permission_classes` 装饰器配合 `api_view` 实现细粒度的权限验证逻辑[^1]。 --- ###