Add example of using paginator in a view

1 files changed, 21 insertions, 8 deletions

diff --git a/docs/api-guide/pagination.md b/docs/api-guide/pagination.md
index 6211a0ac..8ef7c4cc 100644
--- a/docs/api-guide/pagination.md
+++ b/docs/api-guide/pagination.md
@@ -56,19 +56,32 @@ We can do this using the `object_serializer_class` attribute on the inner `Meta`
         class Meta:
             object_serializer_class = UserSerializer
 
-    queryset = User.objects.all()
-    paginator = Paginator(queryset, 20)
-    page = paginator.page(1)
-    serializer = PaginatedUserSerializer(instance=page)
-    serializer.data
-    # {'count': 1, 'next': None, 'previous': None, 'results': [{'username': u'admin', 'email': u'admin@example.com'}]}
+We could now use our pagination serializer in a view like this.
+
+    @api_view('GET')
+    def user_list(request):
+        queryset = User.objects.all()
+        paginator = Paginator(queryset, 20)
+
+        page = request.QUERY_PARAMS.get('page')
+        try:
+            users = paginator.page(page)
+        except PageNotAnInteger:
+            # If page is not an integer, deliver first page.
+            users = paginator.page(1)
+        except EmptyPage:
+            # If page is out of range (e.g. 9999), deliver last page of results.
+            users = paginator.page(paginator.num_pages)
+
+        serializer_context = {'request': request}
+        serializer = PaginatedUserSerializer(instance=users,
+                                             context=serializer_context)
+        return Response(serializer.data)
 
 ## Pagination in the generic views
 
 The generic class based views `ListAPIView` and `ListCreateAPIView` provide pagination of the returned querysets by default.  You can customise this behaviour by altering the pagination style, by modifying the default number of results, or by turning pagination off completely.
 
-## Setting the default pagination style
-
 The default pagination style may be set globally, using the `PAGINATION_SERIALIZER` and `PAGINATE_BY` settings.  For example.
 
     REST_FRAMEWORK = {