1. Request 와 Response

Request objects

DRF에서는 HttpRequest 를 확장한 Request 객체를 제공한다. Request 객체는 더욱 유연한 request parsing 기능을 제공한다.

쓰임새는 request.POST와 비슷하나 request.POST는 POST메소드로 들어온 요청에 한해서만 쓰일 수 있지만 request.data는 POST, PUT, PATCH까지 사용할 수 있다.

Response objects

Response 객체는 TemplateResponse 의 타입으로서 렌더링 되지 않은 content를 불러와 콘텐츠협상(negotiation content)의 과정을 거쳐 클라이언트에게 리턴할 올바른 content type으로 변환한다.

여기서 잠깐 콘텐트 협상이란?

2. Status Code

일반 Django에서는 Response할 상태코드를 숫자만 보내는데, DRF에서는 status module의 HTTP_400_BAD_REQUEST 처럼 보다 명확한 상태코드를 보낸다.

3. Wrapping API Views

DRF에서는 2개의 Wrapper를 제공하는데, 하나는 함수기반뷰(FBV)에 사용되는 @api_view 와 클래스기반뷰(CBV)에 사용되는 APIView 이다.

2개의 wrapper 모두 Request 객체를 수신 하는지 확인하고, content negotiation을 할 수 있도록Response 객체에 context를 추구하는 기능등을 가지고 있다.

Functional Based View

기본 Django View

# views.py
@csrf_exempt
def snippet_list(request):
    """
    List all code snippets, or create a new snippet.
    """
    if request.method == 'GET':
        snippets = Snippet.objects.all()
        serializer = SnippetSerializer(snippets, many=True)
        return JsonResponse(serializer.data, safe=False)

    elif request.method == 'POST':
        data = JSONParser().parse(request)
        serializer = SnippetSerializer(data=data)
        if serializer.is_valid():
            serializer.save()
            return JsonResponse(serializer.data, status=201)
        return JsonResponse(serializer.errors, status=400)

@csrf_exempt
def snippet_detail(request, pk):
    """
    Retrieve, update or delete a code snippet.
    """
    try:
        snippet = Snippet.objects.get(pk=pk)
    except Snippet.DoesNotExist:
        return HttpResponse(status=404)

    if request.method == 'GET':
        serializer = SnippetSerializer(snippet)
        return JsonResponse(serializer.data)

    elif request.method == 'PUT':
        data = JSONParser().parse(request)
        serializer = SnippetSerializer(snippet, data=data)
        if serializer.is_valid():
            serializer.save()
            return JsonResponse(serializer.data)
        return JsonResponse(serializer.errors, status=400)

    elif request.method == 'DELETE':
        snippet.delete()
        return HttpResponse(status=204)

FBV의 @api_view 데코레이터를 이용한 View

# views.py

from rest_framework import status
from rest_framework.decorators import api_view
from rest_framework.response import Response
from snippets.models import Snippet
from snippets.serializers import SnippetSerializer


@api_view(['GET', 'POST'])
def snippet_list(request):
    """
    List all code snippets, or create a new snippet.
    """
    if request.method == 'GET':
        snippets = Snippet.objects.all()
        serializer = SnippetSerializer(snippets, many=True)
        return Response(serializer.data)

    elif request.method == 'POST':
        serializer = SnippetSerializer(data=request.data)
        if serializer.is_valid():
            serializer.save()
            return Response(serializer.data, status=status.HTTP_201_CREATED)
        return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)

@api_view(['GET', 'PUT', 'DELETE'])
def snippet_detail(request, pk):
    """
    Retrieve, update or delete a code snippet.
    """
    try:
        snippet = Snippet.objects.get(pk=pk)
    except Snippet.DoesNotExist:
        return Response(status=status.HTTP_404_NOT_FOUND)

    if request.method == 'GET':
        serializer = SnippetSerializer(snippet)
        return Response(serializer.data)

    elif request.method == 'PUT':
        serializer = SnippetSerializer(snippet, data=request.data)
        if serializer.is_valid():
            serializer.save()
            return Response(serializer.data)
        return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)

    elif request.method == 'DELETE':
        snippet.delete()
        return Response(status=status.HTTP_204_NO_CONTENT)

• Request에 담겨져있는 데이터를 따로 parsing하지 않고 request.data를 이용하여 json data로 처리할 수 있어다.
• status 객체를 이용하여 보다 명확한 상태코드를 처리할 수 있다.

4. Adding optional format suffixes to our URLs

View 함수에 키워드 아규먼트를 추가함으로써 Client가 원하는 Content Type으로 제공할 수 있다.

방법

• 위의 view 함수에 format 매개변수를 추가하면된다.

# views.py
@api_view(['GET', 'POST'])
def snippet_list(request, format=None):
    ...

@api_view(['GET', 'PUT', 'DELETE'])
def snippet_detail(request, pk, format=None):
    ...

# urls.py
from django.urls                import path
# 콘텐츠 타입의 데이터를 제공하기위한 모듈 임포트
from rest_framework.urlpatterns import format_suffix_patterns
from Snippets                   import views

urlpatterns = [
    path('snippets/', views.SnippetList.as_view()),
    path('snippets/<int:pk>/', views.SnippetDetail.as_view()),
]

# urlpatterns이 `format_suffix_patterns` 모듈을 참조하여 사용자에게 보여질 content type을 결정
urlpatterns = format_suffix_patterns(urlpatterns)

• json 또는 탐색가능한 api

>>> http http://127.0.0.1:8000/snippets/3.json
>>> http http://127.0.0.1:8000/snippets/3.api