Django REST framework【学习内容】

Django REST framework【学习内容】

​​快速入门​​

我们将创建一个简单的允许管理员用户查看和编辑系统中的用户和组的API。

​​项目设置​​

创建一个名为 ​​tutorial​​​ 的新django项目，然后启动一个名为 ​​quickstart​​ 的新app。

# 创建项目目录mkdir tutorialcd tutorial# 创建一个virtualenv来隔离我们本地的包依赖关系virtualenv envsource env/bin/activate # 在Windows下使用 `env\Scripts\activate`# 在创建的虚拟环境中安装 Django 和 Django REST frameworkpip install djangopip install djangorestframework# 创建一个新项目和一个单个应用django-admin.py startproject tutorial . # 注意结尾的'.'符号cd tutorialdjango-admin.py startapp quickstartcd ..

现在第一次同步你的数据库：

python manage.py migrate

我们还要创建一个名为 ​​admin​​​ 的初始用户，密码为 ​​password123​​。我们稍后将在该示例中验证该用户。

python manage.py createsuperuser

等你建立好一个数据库和初始用户，并准备好开始。打开应用程序的目录，我们就要开始编码了...

​​Serializers​​

首先我们要定义一些序列化程序。我们创建一个名为 ​​tutorial/quickstart/serializers.py​​的文件，来用作我们的数据表示。

from django.contrib.auth.models import User, Groupfrom rest_framework import serializersclass UserSerializer(serializers.HyperlinkedModelSerializer): class Meta: model = User fields = ('url', 'username', 'email', 'groups')class GroupSerializer(serializers.HyperlinkedModelSerializer): class Meta: model = Group fields = ('url', 'name')

请注意，在这个例子中我们用到了超链接关系，使用 ​​HyperlinkedModelSerializer​​。你还可以使用主键和各种其他关系，但超链接是好的RESTful设计。

​​Views​​

好了，我们接下来再写一些视图。打开 ​​tutorial/quickstart/views.py​​ 文件开始写代码了。

from django.contrib.auth.models import User, Groupfrom rest_framework import viewsetsfrom tutorial.quickstart.serializers import UserSerializer, GroupSerializerclass UserViewSet(viewsets.ModelViewSet): """ 允许用户查看或编辑的API路径。 """ queryset = User.objects.all().order_by('-date_joined') serializer_class = UserSerializerclass GroupViewSet(viewsets.ModelViewSet): """ 允许组查看或编辑的API路径。 """ queryset = Group.objects.all() serializer_class = GroupSerializer

不再写多个视图，我们将所有常见行为分组写到叫 ​​ViewSets​​ 的类中。

如果我们需要，我们可以轻松地将这些细节分解为单个视图，但是使用viewsets可以使视图逻辑组织良好，并且非常简洁。

​​URLs​​

好的，现在我们在​​tutorial/urls.py​​中开始写连接API的URLs。

from django.conf.urls import url, includefrom rest_framework import routersfrom tutorial.quickstart import viewsrouter = routers.DefaultRouter()router.register(r'users', views.UserViewSet)router.register(r'groups', views.GroupViewSet)# 使用自动URL路由连接我们的API。# 另外，我们还包括支持浏览器浏览API的登录URL。urlpatterns = [ url(r'^', include(router.urls)), url(r'^api-auth/', include('rest_framework.urls', namespace='rest_framework'))]

因为我们使用的是viewsets而不是views，所以我们可以通过简单地使用路由器类注册视图来自动生成API的URL conf。

再次，如果我们需要对API URL进行更多的控制，我们可以简单地将其拉出来使用常规基于类的视图，并明确地编写URL conf。

最后，我们将包括用于支持浏览器浏览的API的默认登录和注销视图。这是可选的，但如果您的API需要身份验证，并且你想要使用支持浏览器浏览的API，那么它们很有用。

​​Settings​​

我们也想设置一些全局设置。我们想打开分页，我们希望我们的API只能由管理员使用。设置模块都在 ​​tutorial/settings.py​​中。

INSTALLED_APPS = ( ... 'rest_framework',)REST_FRAMEWORK = { 'DEFAULT_PERMISSION_CLASSES': [ 'rest_framework.permissions.IsAdminUser', ], 'PAGE_SIZE': 10}

好了，我们完成了。

​​测试我们的API​​

我们现在可以测试我们构建的API。我们从命令行启动服务器。

python manage.py runserver

我们现在可以从命令行访问我们的API，使用诸如 ​​curl​​ ...

bash: curl -H 'Accept: application/json; indent=4' -u admin:password123 "count": 2, "next": null, "previous": null, "results": [ { "email": "admin@example.com", "groups": [], "url": " "username": "admin" }, { "email": "tom@example.com", "groups": [ ], "url": " "username": "tom" } ]}

或者使用 ​​-a admin:password123 200 OK...{ "count": 2, "next": null, "previous": null, "results": [ { "email": "admin@example.com", "groups": [], "url": " "username": "paul" }, { "email": "tom@example.com", "groups": [ ], "url": " "username": "tom" } ]}

或直接通过浏览器，转到URL ​​http://127.0.0.1:8000/users/​​...

如果您正在使用浏览器，请确保使用右上角进行登录。

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。