本书适合哪些读者:
本书适用于想要使用Python 3.6或更高版本开发RESTful Web服务(也称为RESTful Web API),并希望学习如何使用最流行的Python Web框架-Dango来完成它的Python开发人员.
这本书包含了那些内容:
第1章,安装所需的软件和工具,展示了如何使用Python及其最流行的Web框架Django创建RESTful Web服务。我们将使用Django和Django REST框架来创,安装和配置RESTful Web服务所需的环境,软件和工具。我们将学习在Linux,macOS和Windows中配置的必要步骤。我们将使用Django创建我们的第一个应用程序,然后我们将查看Django自动创建文件夹,文件和配置,然后我们将进行必要的更改以激活Django REST框架。此外,我们还将介绍安装命令行和GUI工具,我们将使用这些工具与RESTful Web服务进行交互,我们将在后面的章节中对其进行设计,编码和测试。
第2章,使用模型,迁移,序列化和反序列化,介绍如何设计RESTful Web服务以与简单的SQLite数据库交互并使用‘toy’模型执行CRUD操作。我们将定义Web服务的需求,并且我们将了解每个HTTP方法和在不同范围执行的任务。我们将创建一个模型来表示和持久化toy实例并在Django中执行迁移,以便在数据库中创建所需的表。我们将分析表并学习如何使用Django REST框架序列化和反序列化‘toy’实例.
第3章,创建API视图,是关于与SQLite数据库交互的简单Django RESTful Web服务的第一个版本。我们将编写API视图来处理'toy'集合和特定toy上的各种HTTP请求。我们将使用以下HTTP方法:GET,POST和PUT。我们将配置URL patterns 列表以便URL能够路由到视图。我们将启动Django开发服务器,然后使用命令行工具(curl和HTTPie)来向我们的RESTful Web服务发送各种HTTP请求进行测试。我们将学习如何在Django中用我们的代码处理HTTP请求。此外,我们将使用Postman(一种GUI工具)来编写和发送其他HTTP请求到我们的RESTful Web服务。
第4章,使用APIView类中的通用方法,展现了用不同的方法来改进我们的简单的Django RESTful Web服务。我们将利用Django REST框架中包含的许多功能来删除重复的代码并为Web服务添加许多功能。我们将使用模型序列化器,来了解accepted和returned的内容类型的不同,以及提供对HTTP OPTIONS请求的准确响应的重要性。我们将对现有代码进行必要的更改,以启用各种解析器和渲染器。我们将了解Django REST框架中的工作原理。我们将使用不同的内容类型,并注意RESTful Web Service与以前的版本相比是如何改进的。
第5章,了解和自定义可浏览API功能,解释了如何使用Django REST框架为RESTful Web服务添加的其他功能之一 -- 可浏览的API。我们将使用Web浏览器来处理我们利用Django构建的第一个Web服务。我们将学习使用可浏览的API进行HTTP GET,POST,PUT,OPTIONS和DELETE请求。我们将能够使用Web浏览器轻松测试CRUD操作。可浏览的API将允许我们轻松地与RESTful Web服务进行交互。
第6章,使用高级关系和序列化,演示了如何定义复杂RESTful Web服务的需求,我们需要在其中使用drone categories, drones, pilots, and competitions。我们将使用Django创建一个新的应用程序并配置新的Web服务。我们将在模型之间定义多对一关系,我们将配置Django以使用PostgreSQL数据库。我们将执行迁移以生成具有它们之间关系的表。我们还将分析生成的数据库并为模型配置序列化和反序列化。我们将定义超链接并使用基于类的视图。然后,我们将利用generic class 和generic views来概括和混合预定义的行为。我们将使用路由和端点,并准备我们的RESTful Web服务以使用可浏览的API一起工作。我们将创建许多不同的HTTP请求来创建和检索它们之间具有关系的资源。
第7章,使用 Constraints, Filtering, Searching, Ordering, and Pagination,描述了可浏览API功能的使用,以使用资源和关系在API中导航。我们将添加唯一约束以提高RESTful Web Service中模型的一致性。我们将了解分页结果的重要性,并使用Django REST框架配置和测试全局限制/偏移分页方案。然后,我们将创建自定义分页类,以确保单个请求不能请求大量元素。我们将配置过滤后端类并将代码合并到模型中,以便为基于类的视图添加过滤,搜索和排序功能。我们将创建一个自定义过滤器,是request能够实现过滤,搜索和排序结果的功能。最后,我们将使用可浏览的API来测试分页,过滤和排序。
第8章“使用身份验证和权限保护API”介绍了Django,Django REST框架和RESTful Web服务中的身份验证和权限之间的差异。我们将分析开箱即用的Django REST框架中包含的身份验证类。我们将遵循向模型提供与安全性和权限相关的数据所需的步骤。我们将通过自定义权限类处理对象级权限,并保存有关发出请求的用户的信息。我们将配置权限策略并撰写和发送经过身份验证的请求,以了解权限策略的工作方式。我们将使用命令行工具和GUI工具来编写和发送经过身份验证的请求。我们将使用可浏览的API功能浏览安全的RESTful Web服务,并使用Django REST框架提供的基于令牌的简单身份验证来了解另一种验证请求的方法。
第9章,应用限制规则和版本管理,重点关注限制规则的重要性,以及如何将它们与Django,Django REST框架和RESTful Web服务中的身份验证和权限相结合。我们将分析开箱即用的Django REST框架中包含的限制类。我们将按照必要的步骤在Django REST框架中配置许多限制策略。我们将使用全局和范围相关的设置。然后,我们将使用命令行工具组合并发送许多请求来测试限制规则的工作方式。我们将了解版本控制类,我们将配置URL路径版本控制方案,以允许我们使用两个版本的RESTful Web服务。我们将使用命令行工具和Browsable API来理解两个版本之间的差异。
第10章,自动化测试,展示了如何自动化使用Django和Django REST框架开发的RESTful Web服务的测试。我们将使用不同的包,工具和配置来执行测试。我们将为RESTful Web服务编写第一轮单元测试,运行它们并测量测试代码覆盖率。然后,我们将分析测试代码覆盖率报告并编写新的单元测试以改进测试代码覆盖率。我们将了解新的测试代码覆盖率报告,并了解良好的测试代码覆盖率的好处。
附录,答案,每章的“测试您的知识”部分的正确答案都包含在附录中。