Django Rest Framework

Django REST framework

Quickstart

Quickstart เป็นหัวข้อสำหรับคนที่เริ่มทำเว็บ API และ REST framework โดยจะเป็นการสร้าง API อย่างง่าย เพื่อให้ผู้ดูแลระบบสามารถ เพิ่ม ลบ แก้ไข ผู้ใช้งานได้

ขั้นตอนการตั้งค่า

• ตั้งค่าโปรเจคใหม่ด้วยการสร้าง Directory ชื่อว่า tutorial และ สร้างแอปพลิเคชั่นใหม่ชื่อ quickstart โดยมีกระบวนการดังต่อไปนี้

มีข้อผิดพลาดในการสร้างรูปย่อ: ไฟล์สูญหาย

1. คำสั่งที่ใช้งาน สร้าง Folder

1. สร้าง Folder ชื่อ tutorial 
mkdir tutorial
cd tutorial

มีข้อผิดพลาดในการสร้างรูปย่อ: ไฟล์สูญหาย

2. คำสั่งที่ใช้งาน (virtualenv)

2. สร้าง Virtual environment (virtualenv)
virtualenv env
source env/bin/activate

มีข้อผิดพลาดในการสร้างรูปย่อ: ไฟล์สูญหาย

3. ติดตั้ง Django REST framework

3. ติดตั้ง Django REST framework ลงใน virtualenv
pip install django
pip install djangorestframework

มีข้อผิดพลาดในการสร้างรูปย่อ: ไฟล์สูญหาย

4. ตั้งค่าโปรเจค

4. ตั้งค่าโปรเจคและแอปพลิเคชั่นใน Django 
django-admin.py startproject tutorial .  
cd tutorial
django-admin.py startapp quickstart
cd ..

ในการเรียกใช้ คำสั่ง python นั้นจะขึ้นอยู่กับเวอร์ชั่นของ python ที่ลง หากใช้ เวอร์ชั่น 3.5 ให้เรียกคำสั่ง python ว่า python3.5

• ในขั้นตอนต่อไปนี้เป็นการเชื่อมต่อฐานข้อมูลให้กับโปรเจคโดยการ migrate

มีข้อผิดพลาดในการสร้างรูปย่อ: ไฟล์สูญหาย

5. Migrate ให้โปรเจคเข้ากับ Database

python manage.py migrate

• ต่อมาเป็นการสร้าง user โดยมี username : admin และ password : password123 เพื่อเอาไว้เข้าใช้ระบบ

มีข้อผิดพลาดในการสร้างรูปย่อ: ไฟล์สูญหาย

6. สร้าง User ให้กับโปรเจค

python manage.py createsuperuser

Serializers

• ก่อนอื่นเราจะต้องกำหนด serializers. และ สร้างโมดูลใหม่ โดยสร้างไฟล์ชื่อ serializers.py ใน path tutorial/quickstart/serializers.py

มีข้อผิดพลาดในการสร้างรูปย่อ: ไฟล์สูญหาย

7. เพิ่มไฟล์ 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')

Views

• ต่อมาจะเป็นการเข้าไปตั้งค่าไฟล์ tutorial/quickstart/views.py ให้เป็น

มีข้อผิดพลาดในการสร้างรูปย่อ: ไฟล์สูญหาย

8. แก้ไขไฟล์ views.py

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


class UserViewSet(viewsets.ModelViewSet):
    queryset = User.objects.all().order_by('-date_joined')
    serializer_class = UserSerializer


class GroupViewSet(viewsets.ModelViewSet):
    queryset = Group.objects.all()
    serializer_class = GroupSerializer

URL

• ต่อมาจะเป็นการเข้าไปตั้งค่าไฟล์ tutorial/urls.py เพื่อตั้งค่า URL ให้กับ โปรเจค

มีข้อผิดพลาดในการสร้างรูปย่อ: ไฟล์สูญหาย

9. แก้ไขไฟล์ urls.py

from django.conf.urls import url, include
from rest_framework import routers
from tutorial.quickstart import views

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

urlpatterns = [
    url(r'^', include(router.urls)),
    url(r'^api-auth/', include('rest_framework.urls', namespace='rest_framework'))
]

Settings

• เพิ่มชื่อ แอปพลิเคชั่น ลงใน Module ชือ INSTALLED_APPS ในไฟล์ tutorial/settings.py โดยเพิ่ม 'rest_framework', ต่อท้ายดังตัวอย่าง

มีข้อผิดพลาดในการสร้างรูปย่อ: ไฟล์สูญหาย

10. แก้ไขไฟล์ settings.py

INSTALLED_APPS = (
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'rest_framework',
)

REST_FRAMEWORK = {
    'DEFAULT_PERMISSION_CLASSES': ('rest_framework.permissions.IsAdminUser',),
    'PAGE_SIZE': 10
}

เป็นการสำเร็จ ต่อไปจะเป็นการเริ่มทดสอบ API โดยการ Run Server

มีข้อผิดพลาดในการสร้างรูปย่อ: ไฟล์สูญหาย

11. Run Server!!

python ./manage.py runserver
python manage.py runserver
หรือ
python3.x manage.py runserver

ทดลองเข้าใช้เว็บผ่าน URL : http://localhost:8000

มีข้อผิดพลาดในการสร้างรูปย่อ: ไฟล์สูญหาย

'12. Browse our API !!

อ้างอิง

[1] : Django-rest-framework.org

Tutorial เพิ่มเติม

1 - Serialization : [2]

2 - Requests & Responses : [3]

3 - Class based views : [4]

4 - Authentication & permissions : [5]

5 - Relationships & hyperlinked APIs : [6]

6 - Viewsets & routers : [7]