码迷,mamicode.com
首页 > Windows程序 > 详细

API(五)之Relationships & Hyperlinked APIs

时间:2017-05-27 10:25:35      阅读:296      评论:0      收藏:0      [点我收藏+]

标签:elf   添加   mod   poi   generics   返回   选择   lang   rom   

目前,我们的API中的关系用主键表示。在本教程的这一部分中,我们将改进API的内聚力和可发现性,而不是使用关联的超链接。

为我们的API的根创建一个端点

现在我们有‘snippets‘和‘users‘的端点,但是我们的API没有一个入口点。为了创建一个入口点,我们将使用一个常规的基于函数的视图和我们之前介绍的装饰器@api_view在你的snippets/views.py添加:

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

@api_view([‘GET‘])
def api_root(request, format=None):
    return Response({
        ‘users‘: reverse(‘user-list‘, request=request, format=format),
        ‘snippets‘: reverse(‘snippet-list‘, request=request, format=format)
    })

这里应该注意两件事。首先,我们使用REST框架的reverse函数来返回完全限定的URLs; 第二,URL模式是通过方便的名字来标识的,我们稍后会在snippets/urls.py中声明。

 highlighted snippets创建端点

我们的pastebin API中仍然缺少的另一个明显的事情是 the code highlighting endpoints。

与所有其他API端点不同,我们不想使用JSON,而只是呈现HTML表现层。REST框架提供了两种HTML渲染器样式,一种是使用模板来解决HTML渲染,另一种使用预渲染的HTML。第二个渲染器是我们要用于此端点的渲染器。

在创建代码高亮视图时,我们需要考虑的另一件事是,没有现成的具体通用视图让我们使用。我们不返回一个对象实例,而是返回一个对象实例的属性。

我们不是使用具体的通用视图,而是使用基类来表示实例,并创建我们自己的.get()方法。在你的snippets/views.py加:

from rest_framework import renderers
from rest_framework.response import Response

class SnippetHighlight(generics.GenericAPIView):
    queryset = Snippet.objects.all()
    renderer_classes = (renderers.StaticHTMLRenderer,)

    def get(self, request, *args, **kwargs):
        snippet = self.get_object()
        return Response(snippet.highlighted)

像往常一样,我们需要在URLconf中添加新视图。我们将在snippets/urls.py中为我们的新API根添加一个url模式:

url(r‘^$‘, views.api_root),

然后为 snippet highlights添加一个url模式:

url(r‘^snippets/(?P<pk>[0-9]+)/highlight/$‘, views.SnippetHighlight.as_view()),

Hyperlinking our API

处理entities之间的关系是Web API设计中更具挑战性的方面之一。我们可以选择一些不同的方式来代表一种关系:

  • 使用主键。
  • 在实体之间使用超链接。
  • 在相关实体上使用唯一的标识字段。
  • 使用相关实体的默认字符串表示形式。
  • 将相关实体嵌套在父表示内。
  • 一些其他自定义表示。

REST框架支持所有这些样式,并且可以将它们应用于正向或反向关系,也可以在诸如通用外键之类的自定义管理器上应用。

在这种情况下,我们希望在实体之间使用超链接样式。为了这样做,我们将修改我们的序列化程序来扩展HyperlinkedModelSerializer而不是现有的ModelSerializer

HyperlinkedModelSerializerModelSerializer有以下区别:

  • 默认情况下不包括id字段。
  • 它包括一个使用HyperlinkedIdentityField的url字段
  • 关系使用HyperlinkedRelatedField,而不是PrimaryKeyRelatedField

我们可以使用超链接轻松地重写我们现有的序列化程序。在你的snippets/serializers.py添加:

class SnippetSerializer(serializers.HyperlinkedModelSerializer):
    owner = serializers.ReadOnlyField(source=‘owner.username‘)
    highlight = serializers.HyperlinkedIdentityField(view_name=‘snippet-highlight‘, format=‘html‘)

    class Meta:
        model = Snippet
        fields = (‘url‘, ‘id‘, ‘highlight‘, ‘owner‘,
                  ‘title‘, ‘code‘, ‘linenos‘, ‘language‘, ‘style‘)


class UserSerializer(serializers.HyperlinkedModelSerializer):
    snippets = serializers.HyperlinkedRelatedField(many=True, view_name=‘snippet-detail‘, read_only=True)

    class Meta:
        model = User
        fields = (‘url‘, ‘id‘, ‘username‘, ‘snippets‘)

请注意,我们还添加了一个新的‘highlight‘字段。该字段与url字段具有相同的类型,除了它指向‘snippet-highlight‘url模式,而不是‘snippet-detail‘url模式。

因为我们包括格式后缀的URL ‘.json‘,所以我们还需要在highlight字段上指出,返回的任何格式后缀的超链接都应该使用‘.html‘后缀。

Making sure our URL patterns are named

如果我们要使用超链接类型的API,那么我们需要命名URL模式。我们来看看我们需要命名的URL模式。

  • 我们的API的根源是指‘user-list‘‘snippet-list‘
  • 我们的片段serializer包括一个引用‘snippet-highlight‘的字段。
  • 我们的用户serializer包括一个引用‘snippet-detail‘的字段。
  • 我们的片段和用户序列化程序包括默认情况下将引用‘{model_name}-detail‘‘url‘字段,在这种情况下将是‘snippet-detail‘‘user-detail‘

将所有这些名字添加到我们的URLconf中后,最终snippets/urls.py文件应该如下所示:

from django.conf.urls import url, include
from rest_framework.urlpatterns import format_suffix_patterns
from snippets import views

# API endpoints
urlpatterns = format_suffix_patterns([
    url(r‘^$‘, views.api_root),
    url(r‘^snippets/$‘,
        views.SnippetList.as_view(),
        name=‘snippet-list‘),
    url(r‘^snippets/(?P<pk>[0-9]+)/$‘,
        views.SnippetDetail.as_view(),
        name=‘snippet-detail‘),
    url(r‘^snippets/(?P<pk>[0-9]+)/highlight/$‘,
        views.SnippetHighlight.as_view(),
        name=‘snippet-highlight‘),
    url(r‘^users/$‘,
        views.UserList.as_view(),
        name=‘user-list‘),
    url(r‘^users/(?P<pk>[0-9]+)/$‘,
        views.UserDetail.as_view(),
        name=‘user-detail‘)
])

# Login and logout views for the browsable API
urlpatterns += [
    url(r‘^api-auth/‘, include(‘rest_framework.urls‘,
                               namespace=‘rest_framework‘)),
]

添加分页

用户和代码段的列表视图可能会返回相当多的实例,因此我们希望确保分页结果,并允许API客户端逐步浏览每个单独的页面。

我们可以通过稍微修改我们的tutorial/settings.py文件来更改默认列表样式来使用分页。添加以下设置:

REST_FRAMEWORK = {
    ‘PAGE_SIZE‘: 10
}

请注意,REST框架中的设置都命名为单个字典设置,名为“REST_FRAMEWORK”,这有助于保持与其他项目设置的良好分离。

我们也可以自定义分页风格,如果我们需要,但在这种情况下,我们将坚持默认。

API(五)之Relationships & Hyperlinked APIs

标签:elf   添加   mod   poi   generics   返回   选择   lang   rom   

原文地址:http://www.cnblogs.com/yangxiaoling/p/6911132.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!