Python Django REST Framework实战:构建RESTful API

Django REST framework:构建高效RESTful API的终极指南 RESTful API是现代Web开发的核心技术,遵循资源表述状态转移架构风格。Django REST framework(DRF)作为Django生态中的API开发工具包,通过序列化器、视图集和路由等组件,实现了高效的数据交互和业务逻辑封装。其内置的认证系统支持Session、Token和JWT等多种方式,而可浏览API界面则大幅提升了开发体验。在电商平台、内容管理系统等场景中,DRF的ModelSerializer能自动处理Django模型关系,配合ViewSets可快速实现CRUD操作。相比Flask 阅读详情

Python Django REST Framework实战:构建RESTful API

引言

在Python Web开发中,Django REST Framework(DRF)是构建RESTful API的首选框架。作为一名从Rust转向Python的后端开发者,我深刻体会到DRF在快速构建高质量API方面的优势。DRF提供了强大的序列化器、视图和认证系统,使得API开发变得更加高效。

DRF核心概念

什么是Django REST Framework

Django REST Framework是基于Django的RESTful API框架,具有以下特点:

  • 序列化器:将模型数据转换为JSON格式
  • 视图集:提供CRUD操作的统一接口
  • 认证系统:支持多种认证方式
  • 权限控制:细粒度的权限管理
  • 分页支持:内置分页功能

架构设计

┌─────────────────────────────────────────────────────────────┐
│                   DRF 架构层次                             │
│  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐ │
│  │   路由层     │───▶│   视图层     │───▶│   序列化层   │ │
│  │ (URL Router) │    │ (ViewSet)    │    │ (Serializer) │ │
│  └──────────────┘    └──────────────┘    └──────────────┘ │
│                                                  │        │
│                                                  ▼        │
│  ┌──────────────────────────────────────────────────────┐  │
│  │                    数据层 (Model)                    │  │
│  └──────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────┘

环境搭建与基础配置

安装依赖

pip install django djangorestframework

项目配置

# settings.py
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'rest_framework',
    'myapp',
]

REST_FRAMEWORK = {
    'DEFAULT_AUTHENTICATION_CLASSES': [
        'rest_framework.authentication.BasicAuthentication',
        'rest_framework.authentication.SessionAuthentication',
    ],
    'DEFAULT_PERMISSION_CLASSES': [
        'rest_framework.permissions.IsAuthenticated',
    ],
}

序列化器实战

基本序列化器

from rest_framework import serializers
from .models import User

class UserSerializer(serializers.ModelSerializer):
    class Meta:
        model = User
        fields = ['id', 'username', 'email', 'is_active']

class UserCreateSerializer(serializers.ModelSerializer):
    password = serializers.CharField(write_only=True)
    
    class Meta:
        model = User
        fields = ['username', 'email', 'password']
    
    def create(self, validated_data):
        user = User.objects.create_user(
            username=validated_data['username'],
            email=validated_data['email'],
            password=validated_data['password']
        )
        return user

嵌套序列化器

from rest_framework import serializers
from .models import Post, Comment

class CommentSerializer(serializers.ModelSerializer):
    class Meta:
        model = Comment
        fields = ['id', 'content', 'created_at']

class PostSerializer(serializers.ModelSerializer):
    comments = CommentSerializer(many=True, read_only=True)
    author_name = serializers.CharField(source='author.username', read_only=True)
    
    class Meta:
        model = Post
        fields = ['id', 'title', 'content', 'author_name', 'comments', 'created_at']

视图集实战

基本视图集

from rest_framework import viewsets
from .models import User
from .serializers import UserSerializer

class UserViewSet(viewsets.ModelViewSet):
    queryset = User.objects.all()
    serializer_class = UserSerializer
    
    def get_queryset(self):
        queryset = super().get_queryset()
        username = self.request.query_params.get('username')
        if username:
            queryset = queryset.filter(username__icontains=username)
        return queryset

自定义视图集

from rest_framework import viewsets, status
from rest_framework.response import Response
from .models import Post
from .serializers import PostSerializer

class PostViewSet(viewsets.ViewSet):
    def list(self, request):
        posts = Post.objects.all()
        serializer = PostSerializer(posts, many=True)
        return Response(serializer.data)
    
    def retrieve(self, request, pk=None):
        post = Post.objects.get(pk=pk)
        serializer = PostSerializer(post)
        return Response(serializer.data)
    
    def create(self, request):
        serializer = PostSerializer(data=request.data)
        if serializer.is_valid():
            serializer.save(author=request.user)
            return Response(serializer.data, status=status.HTTP_201_CREATED)
        return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)

路由配置

from django.urls import path, include
from rest_framework.routers import DefaultRouter
from .views import UserViewSet, PostViewSet

router = DefaultRouter()
router.register(r'users', UserViewSet)
router.register(r'posts', PostViewSet)

urlpatterns = [
    path('api/', include(router.urls)),
]

认证与权限

Token认证

# settings.py
REST_FRAMEWORK = {
    'DEFAULT_AUTHENTICATION_CLASSES': [
        'rest_framework.authentication.TokenAuthentication',
    ],
}

# urls.py
from rest_framework.authtoken.views import obtain_auth_token

urlpatterns = [
    path('api-token-auth/', obtain_auth_token),
]

自定义权限

from rest_framework import permissions

class IsOwnerOrReadOnly(permissions.BasePermission):
    def has_object_permission(self, request, view, obj):
        if request.method in permissions.SAFE_METHODS:
            return True
        return obj.author == request.user

实际业务场景

场景一:博客API

from rest_framework import viewsets, permissions
from .models import Post, Comment
from .serializers import PostSerializer, CommentSerializer

class PostViewSet(viewsets.ModelViewSet):
    queryset = Post.objects.all()
    serializer_class = PostSerializer
    permission_classes = [permissions.IsAuthenticatedOrReadOnly, IsOwnerOrReadOnly]
    
    def perform_create(self, serializer):
        serializer.save(author=self.request.user)

class CommentViewSet(viewsets.ModelViewSet):
    queryset = Comment.objects.all()
    serializer_class = CommentSerializer
    
    def get_queryset(self):
        post_id = self.request.query_params.get('post_id')
        if post_id:
            return self.queryset.filter(post_id=post_id)
        return self.queryset

场景二:分页配置

from rest_framework.pagination import PageNumberPagination

class CustomPagination(PageNumberPagination):
    page_size = 10
    page_size_query_param = 'page_size'
    max_page_size = 100

class UserViewSet(viewsets.ModelViewSet):
    queryset = User.objects.all()
    serializer_class = UserSerializer
    pagination_class = CustomPagination

性能优化

查询优化

class PostViewSet(viewsets.ModelViewSet):
    queryset = Post.objects.select_related('author').prefetch_related('comments').all()
    serializer_class = PostSerializer

缓存

from django.core.cache import cache
from rest_framework.decorators import api_view
from rest_framework.response import Response

@api_view(['GET'])
def get_stats(request):
    cache_key = 'api_stats'
    stats = cache.get(cache_key)
    
    if not stats:
        stats = calculate_stats()
        cache.set(cache_key, stats, 60 * 5)
    
    return Response(stats)

总结

Django REST Framework为Python后端开发者提供了强大的API开发能力。通过序列化器、视图集和认证系统,可以快速构建高质量的RESTful API。从Rust开发者的角度来看,DRF的声明式API设计与Rust的类型安全理念有相似之处。

在实际项目中,建议合理使用视图集和序列化器来提高开发效率,并注意查询优化和缓存来提升性能。

3小时快速上手Django REST Framework:构建RESTful API实战指南 在现代Web开发中,前后端分离架构已成为主流范式,API接口作为前后端通信的核心枢纽,其设计与实现至关重要。RESTful API遵循统一的架构风格,通过HTTP方法对资源进行操作,实现了客户端与服务器的解耦。Django REST Framework(DRF)作为Django生态中构建Web API的强大工具包,通过序列化器、视图集和路由器等高度封装的组件,极大地简化了API开发流程。其技术价值在于能够以极少的代码快速生成功能完备、符合REST规范的接口,显著提升开发效率。在快速原型验证、前后端分离项目以 阅读详情

相关推荐

Python RESTful API 构建专家指南:Flask 与 Django REST framework 实战

本文深入探讨了使用 Python Flask 和 Django REST framework 构建 RESTful API 的方法。我们从 RESTful API 的基本概念出发,分别介绍了使用 Flask 和 DRF 构建 API 的实战代码,并对比了两个框架的优缺点,最后总结了 RESTful API 设计的最佳实践。选择 Flask 还是 Django REST framework 取决于您的项目需求和团队技术栈。Flask 简洁灵活,适合小型 API 和微服务;

铭渊老黄 139

Python利用Django 构建Rest Api: 快速入门教程

点击上方“测试开发技术”,选择设为“设为星标”优质文章,第一时间送达!近期荐文:年底特辑:新一代测试平台开源实战项目Python 3+Django 3 结合Vue.js框架构建前后端分离...

python爬虫人工智能大数据 848

第六十二篇:Django REST framework:构建RESTful API最佳实践

本文探讨了API设计能力作为高级Python工程师核心竞争力的重要性,重点分析了Django REST Framework(DRF)在构建RESTful API中的应用。文章首先强调了RESTful架构的约束性原则及其优势,包括资源导向、统一接口、无状态等核心理念。随后深入解析了DRF的设计精髓,如序列化器核心、模块化认证机制和视图层次化抽象。在实践层面,详细介绍了项目初始化配置、序列化器设计等关键环节,展示了如何通过DRF构建健壮、安全、可扩展的API系统。

厚积薄发的博客 1097

Django REST Framework实战指南:从零构建企业级RESTful API

Python-100-Days项目为开发者提供了从基础到高级的RESTful接口开发完整指南。本文将深入探讨如何使用Django REST Framework(DRF)构建规范、高效、安全的API服务,涵盖架构设计、序列化、认证授权、性能优化等关键环节,帮助中高级开发者快速掌握企业级API开发的核心技能。 ## 核心关键词与长尾关键词 **核心关键词**:Django REST Framewo

gitblog_00297的博客 1110

Django REST Framework: 构建RESTful API的完整指南

Django REST Framework(DRF)是一个强大而灵活的工具,用于构建Web API。它构建在Django框架之上,继承了Django的许多特性,如ORM、模板系统和认证系统,同时增强了构建RESTful Web服务的能力。序列化是将数据结构或对象状态转换为可以存储或传输的形式的过程,反序列化则是从存储或传输的形式恢复数据结构或对象状态的过程。在Web开发中,序列化通常用于将服务器端的数据(如数据库查询结果)转换为便于客户端处理的格式,通常为JSON或XML。

weixin_31591833的博客 1320

使用STARTER V5.6软件将项目文件下载到S120驱动器控制单元CF卡中的具体方法演示

使用STARTER V5.6软件将项目文件下载到S120驱动器控制单元CF卡中的具体方法演示

Robot_PLC_HMI_Automation 1919

Django REST Framework教程(1): 为什么要学习DRF, 什么是序列化和RESTful的API

小编曾经承诺的Django REST Framework原创系列教程终于赶上了2020年那年夏天的尾巴,姗姗而来。我们将用不少于10篇的原创文章系统性地介绍如何使用这个框架开发符合RES...

大江狗 4288

45、概率与模糊性:粗糙事件与模糊事件概率的探索

本文探讨了概率理论与模糊性理论在处理现实世界不确定性中的应用,重点分析了模糊事件和粗糙事件的概率定义、性质及其条件概率。同时,介绍了近似贝叶斯网络分类器在信息系统中的应用,以及如何通过概率决策约简提高分类效率。这些方法为处理不确定信息提供了灵活的工具,并在决策和数据分析中具有重要价值。

ik67890123的博客 135

python rest framework_详解Django rest_framework实现RESTful API

一、什么是REST面向资源是REST最明显的特征,资源是一种看待服务器的方式,将服务器看作是由很多离散的资源组成。每个资源是服务器上一个可命名的抽象概念。因为资源是一个抽象的概念,所以它不仅仅能代表服务器文件系统中的一个文件、数据库中的一张表等等具体的东西,可以将资源设计的要多抽象有多抽象,只要想象力允许而且客户端应用开发者能够理解。与面向对象设计类似,资源是以名词为核心来组织的,首先关注的是名词...

weixin_33622032的博客 1113

财务惊呼“不可能”!Python 自动识别 PDF 发票,数据秒级录入系统

电子发票(原生 PDF):这种最爽,文字是可以选中的。我们用 PyPDF2 直接提取文本,速度快,准确率 100%。 纸质扫描/拍照发票:这种是图片。必须上 OCR(光学字符识别)。我们要用百度开源的 PaddleOCR,这是目前中文识别效果最好的开源库之一,吊打早已过气的 Tesseract。

BUG猿的博客 1026

【DaVinci Developer专题】-23-IDT高阶应用:结构体类型的数组

共8页 目录 1 创建一个Record IDT 2 创建一个Array IDT 3 创建一个S/R Port Interface 4 创建一个Constant 5 导入CFG生成代码的总结 6 结尾 <--返回「实战篇」博文-总目录--> <--返回「Autosar从入门到精通-实战篇」专栏主页--> 关键字: 缩略语/术语 含义 DEV DaVinci Developer .

「汽车电子助手」的博客 1670

使用 Django REST Framework 构建强大的 API

本文介绍了使用Django REST Framework构建RESTful API的完整流程。首先讲解了DRF的安装配置,然后通过博客应用实例演示了模型设计、序列化器创建、视图集编写和URL路由配置等核心步骤。文章还涵盖了认证权限设置,包括全局认证配置和自定义权限实现。教程从基础到进阶,帮助开发者快速掌握使用DRF构建API的关键技术要点,为进一步探索分页、过滤等高级特性打下基础。

这里是 「Py玩家的栈与星辰」,专注分享Python开发、DevOps实践、云原生技术与系统安全领域的深度干货。 1672

《QGIS快速入门与应用基础》230:添加图例工具

本文系统讲解QGIS图例制作的核心方法与优化技巧。首先强调图例与地图框的绑定逻辑,提出三种绑定状态及适用场景。详细拆解三种图例添加方法:布局工具栏一键添加法(新手首选)、菜单栏添加法和右键快捷创建法,并给出单地图框和多地图框两种典型场景的规范技巧。重点解决新手常见的图例杂乱、样式不规范、内容脱节等问题,帮助用户从基础图例制作进阶到符合行业标准的专业图例设计。通过分步操作图示和实用技巧,使读者能够快速掌握图例创建的核心流程与优化方法。

LuckyHanMo的博客 556

Django REST Framework深度解析:构建企业级API的架构设计与实战指南

在当今前后端分离的Web开发架构中,RESTful API已成为连接前后端的关键桥梁。Python-100-Days项目通过其Day46-60章节,系统性地展示了如何使用Django REST Framework(DRF)构建规范、高效、安全的API服务。本文将从架构设计、核心概念、实现原理到最佳实践,深度解析DRF在企业级应用中的完整解决方案。 ## 技术背景与架构演进挑战 随着微服务架构和

gitblog_00785的博客 1781

HRNet训练自己的分类数据

1.搭建环境 为了防止和服务器上的环境冲突,这里利用conda搭建环境。 Install PyTorch=0.4.1 following theofficial instructions git clonehttps://github.com/HRNet/HRNet-Image-Classification Install dependencies: pip install -r requirements.txt ...

C/C++、嵌入式开发、深度学习算法、模型部署与推理优化 5850

第三节:Vben Admin 最新 v5.0 (vben5) + Python Flask 快速入门 - 对接后端登录接口(上)

这里是Vben Admin V5版本实战体验,上一节我们前端已正常运行,但是没有实现登录。本节的重点是对接后端接口。上一节地址:第一节:Vben Admin 最新 v5.0初体验第二节:Vben Admin 登录逻辑梳理和对接后端准备后端我们采用Python的Flask项目,Flask-SQLAlchemy管理数据库模型,Flask-Migrate进行模型迁移。参考版本如下:Flask3.0.23.1.1到这里,登录接口完成,下一步要实现获取用户信息和权限的接口功能。

cuiwin的专栏 1864

Django REST Framework(DRF)速成:构建你的第一个API

本文介绍了如何使用Django REST Framework(DRF)快速构建RESTful API。文章首先概述了DRF的核心优势,包括可浏览API、序列化系统、认证机制等,并解释了RESTful设计原则。接着详细演示了环境搭建步骤,从创建虚拟环境到安装依赖包,再到初始化Django项目和应用程序。最后提供了DRF的基本配置指南,包括认证、权限和分页等关键设置。这篇教程适合想要快速入门DRF开发的后端工程师,通过清晰的代码示例和项目结构说明,帮助开发者理解如何将Django数据模型转化为功能完善的Web

闲人编程的博客 1503

医疗数据采集:Python爬虫爬取医学文献与药品信息(2026合规与伦理版)

医疗数据采集不同于爬取新闻或房价,它直接关系到人的生命健康和法律底线。技术层面:优先使用官方 API (PubMed E-utilities, BioThings),避免解析复杂HTML。法律层面:严守“不碰隐私、不破付费、不传谣言”三条红线。伦理层面:保持对生命的敬畏,确保数据的准确性和用途的正当性。在2026年,一个优秀的医疗数据工程师,不是那个能爬取最多数据的人,而是那个能在合规框架下,利用公开数据解决真实医疗问题的人。请务必珍视您的职业生涯和法律责任,切勿以身试法。

专注于Python爬虫开发,分享爬虫技巧、项目实战与反爬经验,使用Scrapy、BeautifulSoup等工具,解决数据抓取难题。 287

python django restful_详解Django rest_framework实现RESTful API

一、什么是REST面向资源是REST最明显的特征,资源是一种看待服务器的方式,将服务器看作是由很多离散的资源组成。每个资源是服务器上一个可命名的抽象概念。因为资源是一个抽象的概念,所以它不仅仅能代表服务器文件系统中的一个文件、数据库中的一张表等等具体的东西,可以将资源设计的要多抽象有多抽象,只要想象力允许而且客户端应用开发者能够理解。与面向对象设计类似,资源是以名词为核心来组织的,首先关注的是名词...

weixin_39561577的博客 361

最新的sdio 4.0 spec 协议标准 带书签 高清完整PDF版

Part-E1-SDIO-Specification-Ver4.00-Final-120220.pdf:最新的sdio 4.0 spec 协议标准 带书签 高清完整PDF版,包括SDIO 接口的外设,SDIO 接口官方协议等。

android 蓝牙通讯demo

android 下蓝牙通讯demo,实现了发现蓝牙,使能蓝牙,通过蓝牙发送消息。

Python Django REST Framework 深度解析

Django REST Framework是一个开源的Web框架,专门用于构建RESTful API。它通过提供一系列的类和方法来简化API的创建过程,并且支持多种认证方式、序列化器以及分页机制等高级特性。通过以上介绍可以看出,Django REST Framework极大地降低了开发RESTful API的工作量。无论是从代码结构还是功能实现上都表现出了极高的专业性和易用性。对于任何希望构建高效稳定API服务的企业和个人来说,它都是一个非常值得学习和使用的工具。```

2501_91165189的博客 918

Probability and Statistics - 4th edition

Probability and Statistics - 4th edition

Django Cheat Sheet终极指南:如何快速构建RESTful API与Django REST Framework集成

Django Cheat Sheet是一个为Django框架开发者准备的速查手册,专门帮助开发者快速创建Web应用程序。本指南将重点介绍如何使用Django Cheat Sheet中的技巧快速构建RESTful API,并与强大的Django REST Framework(DRF)进行无缝集成。无论你是Django新手还是有一定经验的开发者,这份完整的教程都能帮助你掌握现代Web API开发的核心

gitblog_01138的博客 493

Data-Structures-and-Algorithm-Analysis-in-Java.pdf

作者: Weiss, Mark A. 出版社: Addison Wesley Data Structures and Algorithm Analysis in Java is an “advanced algorithms” book that fits between traditional CS2 and Algorithms Analysis courses. In the old ACM Curriculum Guidelines, this course was known as CS7. This text is for readers who want to learn good programming and algorithm analysis skills simultaneously so that they can develop such programs with the maximum amo...

使用 Django REST Framework 构建 REST API:从零搭建 Event Finder 后端全指南

Django REST Framework(DRF)是目前 Python 生态中最常用的 REST API 开发框架之一。本指南以构建一个 "Event Finder(活动发现)" 应用为实战主线,完整走通 REST 概念理解、Django 环境搭建、DRF 安装配置,以及 Model、Serializer、ViewSet、URL 路由的 API 全流程实现,并在最后结合 refine 的 Sim

gitblog_00563的博客 398

详解Django rest_framework实现RESTful API

这篇文章主要介绍了详解Django rest_framework实现RESTful API,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧 一、什么是REST 面向资源是REST最明显的特征,资源是一种看待服务器的方式,将服务器看作是由很多离散的资源组成。每个资源是服务器上一个可命名的抽象概念。因为资源是一个抽象的概念,所以它不仅仅能代表服务器文件系统...

weixin_30247159的博客 268

利用 Django REST framework 编写 RESTful API

自动生成符合 RESTful 规范的 API 支持 OPTION、HEAD、POST、GET、PATCH、PUT、DELETE 根据Content-Type来动态的返回数据类型(如 text、json) 生成 browserable 的交互页面(自动为 API 生成非常友好的浏览器页面) 非常细粒度的权限管理(可以细粒度到 field 级...

dingfei8574的博客 289

Django REST framework实战:快速构建高效API

RESTful API是现代Web开发的核心技术,通过标准化接口实现前后端分离。Django REST framework作为Python生态中最成熟的API框架,基于Django ORM提供了强大的序列化能力和声明式开发模式。其核心组件如Serializer和ViewSet将常见功能模块化,开发者只需关注业务逻辑实现。该框架内置认证授权、分页过滤等企业级功能,特别适合快速开发数据驱动的Web服务。通过模型序列化器和视图集的组合,可以轻松实现课程管理系统等典型应用场景,大幅提升开发效率。

weixin_34128839的博客 424

组网第63课:安全域划分——Trust/Untrust/DMZ、区域模型、与 VLAN 的关系

一组接口 + 一组策略 + 一条默认拒绝。一组接口:这个域包含哪些物理口、VLAN、子接口;一组策略:这个域到别的域放行什么、拒绝什么;一条默认拒绝:没写进策略的,一律不通。第三条最关键。没有默认拒绝,前面划的域全是装饰。

qq_36765170的博客 572
上一篇: Rust序列化实战:Serde深度解析
下一篇: Rust日志框架实战:Tracing深度解析
第一程序员
博客等级 码龄1年 1万+粉丝 1827原创
评论 5
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值