Django REST framework 简介

需求

REST framework需要如下：

Python (2.7, 3.2, 3.3, 3.4, 3.5, 3.6)
Django (1.10, 1.11, 2.0)

下面的文件包可以选择性安装

coreapi (1.32.0+) - Schema generation support.
Markdown (2.1.0+) - Markdown support for the browsable API.
django-filter (1.0.1+) - Filtering support.
django-crispy-forms - Improved HTML display for filtering.
django-guardian (1.1.1+) - Object level permissions support.

安装

pip安装：

pip install djangorestframework
pip install markdown       # Markdown 为可浏览的API提供服务
pip install django-filter  # 支持分类

...or clone the project from github.

git clone git@github.com:encode/django-rest-framework.git

把'rest_framework'加入到settings里面的INSTALLED_APPS：

INSTALLED_APPS = [
    ....
    'app01.apps.App01Config',
    'rest_framework',
]

如果你想要使用可浏览的API，就需要添加REST framework的登陆和推出视图。然后把下面的路由加入到根目录下的urls.py文件内

urlpatterns = [
    path('admin/', admin.site.urls),
    path('api/', include('rest_framework.urls')),
]

当然啦，url的路径名称可以随便命名。

简单实例

一起通过一个快速简单的实例，使用REST framework建立简单的模型-后端API

这个实例将会创建一个可读可写的API，访问刚刚创建的项目里面用户权限信息服务。

任何关于REST framework API全局的设置，都被存放在一个单独的配置字典中（REST_FRAMEWORK），添加下面的设置到项目的settings.py文件中。

REST_FRAMEWORK = {
    # 使用Django标准的django.contrib.auth权限或者允许未认证用户有只读权限
    'DEFAULT_PERMISSION_CLASSES': [
        'rest_framework.permissions.DjangoModelPermissionsOrAnonReadOnly'
    ]
}

不要忘记你已经添加rest_framework到settings文件的INSTALLED_APPS.

快速开始

首次创建一个Django project，再创建一个app

同步一下数据库在terminal里面输入

shuais-MBP:TestApp dandyzhang$ python3 manage.py migrate

创建一个初始用户admin，密码password.1在下面的过程中需要用这个账户做验证。

python manage.py createsuperuser

上面的都配置好了，就可以正式开始撰写代码了。

Serializers

首先，需要定义一些serializers，创建一个新的py文件在新建的app内部'serializers.py'，用来做数据表示。

from django.contrib.auth.models import User, Group
from rest_framework import serializers


class UserSerializer(serializers.HyperlinkedModelSerializer):
    class Meta:
        model = User
        fields = ('url', 'username', 'email', 'groups')


class GroupSerializer(serializers.HyperlinkedModelSerializer):
    class Meta:
        model = Group
        fields = ('url', 'name')

注意在这个案例里，我们使用了超链接关系HyperlinkedModelSerializer，你也可以使用主键和各种其他的关系，但是超链接hyperlinking是很好的RESTful设计。

Views

现在，需要写一些视图了。打开新建的app内的view.py文件开始撰写

from django.contrib.auth.models import User, Group
from rest_framework import viewsets
from app01.serializers import UserSerializer, GroupSerializer

# Create your views here.


class UserViewSet(viewsets.ModelViewSet):
    """
    API终端允许用户被查看或者编辑
    """
    queryset = User.objects.all().order_by('-date_joined')
    serializer_class = UserSerializer


class GroupViewSet(viewsets.ModelViewSet):
    """
    API终端允许群组被查看或者
    """
    queryset = Group.objects.all()
    serializer_class = GroupSerializer

相比于撰写多个视图，我们更推荐把所有的共同行为组合到类称做视图集ViewSets的类中

如果需要的话，可以很轻易的把这些分解成单独的视图，但是使用视图集ViewSets让视图的逻辑保持的更好更整洁。

URLS

现在在Django项目的主urls文件中写入API URLs.

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


from rest_framework import routers
from app01 import views

router = routers.DefaultRouter()
router.register(r'users', views.UserViewSet)
router.register(r'groups', views.GroupViewSet)

# API 使用自动的URL路线
# 另外，添加了可浏览的API，包括登陆urls
urlpatterns = [
    path('admin/', admin.site.urls),
    path('api/', include('rest_framework.urls', namespace='rest_framework')),
    path('', include(router.urls)),
]