added support for absolute/relative url switch

docs/api-guide/settings.md

@@ -150,4 +150,8 @@ Default: `'accept'`
 
 Default: `'format'`
 
+## USE_ABSOLUTE_URLS
+
+Default: `'True'`
+
 [cite]: http://www.python.org/dev/peps/pep-0020/

docs/topics/release-notes.md

@@ -4,6 +4,10 @@
 >
 > — Eric S. Raymond, [The Cathedral and the Bazaar][cite].
 
+## Master
+
+* Add support and settings option `USE_ABSOLUTE_URLS`
+
 ## 2.1.1
 
 **Date**: 7th Nov 2012

rest_framework/pagination.py

@@ -1,4 +1,6 @@
 from rest_framework import serializers
+from rest_framework.settings import api_settings
+from rest_framework.templatetags.rest_framework import replace_query_param
 
 # TODO: Support URLconf kwarg-style paging
 
@@ -7,30 +9,42 @@ class NextPageField(serializers.Field):
     """
     Field that returns a link to the next page in paginated results.
     """
+    page_field = 'page'
+
     def to_native(self, value):
         if not value.has_next():
             return None
         page = value.next_page_number()
         request = self.context.get('request')
-        relative_url = '?page=%d' % page
+        url = ''
         if request:
-            return request.build_absolute_uri(relative_url)
-        return relative_url
+            if api_settings.USE_ABSOLUTE_URLS:
+                url = request.build_absolute_uri()
+            else:
+                url = request.get_full_path()
+
+        return replace_query_param(url, self.page_field, page)
 
 
 class PreviousPageField(serializers.Field):
     """
     Field that returns a link to the previous page in paginated results.
     """
+    page_field = 'page'
+
     def to_native(self, value):
         if not value.has_previous():
             return None
         page = value.previous_page_number()
         request = self.context.get('request')
-        relative_url = '?page=%d' % page
+        url = ''
         if request:
-            return request.build_absolute_uri('?page=%d' % page)
-        return relative_url
+            if api_settings.USE_ABSOLUTE_URLS:
+                url = request.build_absolute_uri()
+            else:
+                url = request.get_full_path()
+
+        return replace_query_param(url, self.page_field, page)
 
 
 class PaginationSerializerOptions(serializers.SerializerOptions):

rest_framework/reverse.py

@@ -1,6 +1,7 @@
 """
 Provide reverse functions that return fully qualified URLs
 """
+from rest_framework.settings import api_settings
 from django.core.urlresolvers import reverse as django_reverse
 from django.utils.functional import lazy
 
@@ -14,7 +15,7 @@ def reverse(viewname, args=None, kwargs=None, request=None, format=None, **extra
         kwargs = kwargs or {}
         kwargs['format'] = format
     url = django_reverse(viewname, args=args, kwargs=kwargs, **extra)
-    if request:
+    if request and api_settings.USE_ABSOLUTE_URLS:
         return request.build_absolute_uri(url)
     return url
 

rest_framework/settings.py

@@ -65,7 +65,9 @@ DEFAULTS = {
     'URL_ACCEPT_OVERRIDE': 'accept',
     'URL_FORMAT_OVERRIDE': 'format',
 
-    'FORMAT_SUFFIX_KWARG': 'format'
+    'FORMAT_SUFFIX_KWARG': 'format',
+
+    'USE_ABSOLUTE_URLS': True
 }