Django DRF自定义端点开发咨询：非数据库交互型接口实现方法

嘿，刚上手Django/DRF就能想到自定义端点的需求，很棒！其实Django和DRF提供了非常灵活的方式来编写自己的业务逻辑，完全不用局限于序列化模型数据。我先从你最想要的那个"Hello World"日志端点开始讲，再拓展到生成JSON报告的场景，保证你一看就懂。

一、快速实现"Hello World"日志端点 #

这个需求的核心就是在视图里执行打印日志的逻辑，然后返回空白响应。

1. 编写视图函数 #

在你的Django应用的views.py里，添加下面的代码：

import logging
from django.http import HttpResponse

# 获取默认的日志记录器
logger = logging.getLogger(__name__)

def hello_world_log(request):
    # 打印Hello World到日志
    logger.info('Hello World')
    # 返回空白页面，状态码200表示成功
    return HttpResponse('', status=200)

如果你想用DRF的风格返回空JSON响应，也可以这么写：

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

logger = logging.getLogger(__name__)

@api_view(['GET'])  # 指定允许的请求方法，比如GET
def hello_world_log(request):
    logger.info('Hello World')
    # 返回空的JSON响应
    return Response({}, status=200)

@api_view是DRF提供的装饰器，能帮你处理请求解析、响应格式化等DRF特有的逻辑，用起来更贴合API开发场景。

2. 配置URL路由 #

接下来要把这个视图映射到一个URL上，在应用的urls.py里添加：

from django.urls import path
from . import views

urlpatterns = [
    # 其他已有的路由...
    path('hello-log/', views.hello_world_log, name='hello-world-log'),
]

然后确保项目根目录的urls.py已经包含了这个应用的路由，比如：

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('api/', include('your_app_name.urls')),  # 替换成你的实际应用名
]

现在启动服务，访问http://localhost:8000/api/hello-log/，就能在控制台或日志文件里看到"Hello World"，同时浏览器返回空白页面啦！

二、实现自定义JSON报告端点 #

对于从数据库取数后生成JSON报告的场景，你完全可以自己处理数据，不需要依赖序列化器。

举个例子，假设你有一个Order模型，想要统计不同状态的订单数量并返回JSON报告：

import logging
from django.utils import timezone
from rest_framework.response import Response
from rest_framework.decorators import api_view
from .models import Order  # 导入你的模型

logger = logging.getLogger(__name__)

@api_view(['GET'])
def order_status_report(request):
    # 从数据库查询原始数据
    total_orders = Order.objects.count()
    pending_orders = Order.objects.filter(status='pending').count()
    completed_orders = Order.objects.filter(status='completed').count()
    canceled_orders = Order.objects.filter(status='canceled').count()

    # 构造自定义的JSON报告结构
    report_data = {
        'total_orders': total_orders,
        'status_breakdown': {
            'pending': pending_orders,
            'completed': completed_orders,
            'canceled': canceled_orders
        },
        'generated_at': timezone.now().isoformat()
    }

    # 可选：打印日志记录报告生成事件
    logger.info(f"Generated order status report: {report_data}")

    # 返回自定义JSON响应
    return Response(report_data, status=200)

同样在urls.py里添加路由：

path('order-report/', views.order_status_report, name='order-status-report'),

访问这个URL就能看到你自定义的JSON报告了，整个逻辑完全由你掌控！

一些实用小提示 #

• 日志配置：如果看不到日志输出，记得检查Djangosettings.py里的日志配置，确保INFO级别的日志被正确输出到控制台或文件。
• 类视图选项：如果你习惯用类视图，DRF的APIView也支持自定义逻辑，比如：

from rest_framework.views import APIView
from rest_framework.response import Response

class HelloWorldLogView(APIView):
    def get(self, request):
        logger.info('Hello World')
        return Response({}, status=200)

路由配置只需改成path('hello-log/', views.HelloWorldLogView.as_view(), name='hello-world-log')即可。

• 请求方法限制：不管是函数视图还是类视图，都可以指定允许的请求方法（比如GET、POST），避免处理不必要的请求类型。

内容的提问来源于stack exchange，提问作者thompsbp