Django 是 Python API 開發中最流行的框架之一,在這個教學中,我們來學習如何使用它。
Django 所有 Web 框架中最全面的,也是最受歡迎的一個。自 2005 年以來,其流行度大幅上升。
Django 是由 Django 軟體基金會維護,並且獲得了社群的大力支援,在全球擁有超過 11,600 名成員。在 Stack Overflow 上,約有 191,000 個帶 Django 標籤的問題。Spotify、YouTube 和 Instagram 等都使用 Django 來構建應用程式和資料管理。
本文演示了一個簡單的 API,通過它可以使用 HTTP 協定的 GET 方法來從伺服器獲取資料。
首先,為你的 Django 應用程式建立一個目錄結構,你可以在系統的任何位置建立:
$ mkdir myproject$ cd myproject
然後,在專案目錄中建立一個虛擬環境來隔離本地包依賴關係:
$ python3 -m venv env$ source env/bin/activate
在 Windows 上,使用命令 env\Scripts\activate
來啟用虛擬環境。
然後,安裝 Django 和 Django REST 模組:
$ pip3 install django$ pip3 install djangorestframework
現在你的應用程式已經有了一個工作環境,你必須範例化一個新的 Django 專案。與 Flask 這樣微框架不同的是,Django 有專門的命令來建立(注意第一條命令後的 .
字元)。
$ django-admin startproject tutorial .$ cd tutorial$ django-admin startapp quickstart
Django 使用資料庫來管理後端,所以你應該在開始開發之前同步資料庫,資料庫可以通過 manage.py
指令碼管理,它是在你執行 django-admin
命令時建立的。因為你現在在 tutorial
目錄,所以使用 ../
符號來執行指令碼,它位於上一層目錄:
$ python3 ../manage.py makemigrationsNo changes detected$ python3 ../manage.py migrateOperations to perform: Apply all migrations: admin, auth, contenttypes, sessionsRunning migrations: Applying contenttypes.0001_initial... OK Applying auth.0001_initial... OK Applying admin.0001_initial... OK Applying admin.0002_logentry_remove_auto_add... OK Applying admin.0003_logentry_add_action_flag_choices... OK Applying contenttypes.0002_remove_content_type_name... OK Applying auth.0002_alter_permission_name_max_length... OK Applying auth.0003_alter_user_email_max_length... OK Applying auth.0004_alter_user_username_opts... OK Applying auth.0005_alter_user_last_login_null... OK Applying auth.0006_require_contenttypes_0002... OK Applying auth.0007_alter_validators_add_error_messages... OK Applying auth.0008_alter_user_username_max_length... OK Applying auth.0009_alter_user_last_name_max_length... OK Applying auth.0010_alter_group_name_max_length... OK Applying auth.0011_update_proxy_permissions... OK Applying sessions.0001_initial... OK
建立一個名為 admin
,範例密碼為 password123
的初始使用者:
$ python3 ../manage.py createsuperuser \ --email [email protected] \ --username admin
在提示時建立密碼。
為了使 Django 能夠將資訊傳遞給 HTTP GET 請求,必須將資訊物件轉化為有效的響應資料。Django 為此實現了“序列化類” serializers
。
在你的專案中,建立一個名為 quickstart/serializers.py
的新模組,使用它來定義一些序列化器,模組將用於資料展示:
from django.contrib.auth.models import User, Groupfrom rest_framework import serializersclass UserSerializer(serializers.HyperlinkedModelSerializer): class Meta: model = User fields = ['url', 'username', 'email', 'groups']class GroupSerializer(serializers.HyperlinkedModelSerializer): class Meta: model = Group fields = ['url', 'name']
Django 中的檢視是一個接受 Web 請求並返回 Web 響應的函數。響應可以是 HTML、HTTP 重定向、HTTP 錯誤、JSON 或 XML 文件、影象或 TAR 檔案,或者可以是從 Internet 獲得的任何其他內容。要建立檢視,開啟 quickstart/views.py
並輸入以下程式碼。該檔案已經存在,並且其中包含一些範例文字,保留這些文字並將以下程式碼新增到檔案中:
from django.contrib.auth.models import User, Groupfrom rest_framework import viewsetsfrom tutorial.quickstart.serializers import UserSerializer, GroupSerializerclass UserViewSet(viewsets.ModelViewSet): """ API 允許檢視或編輯使用者 """ queryset = User.objects.all().order_by('-date_joined') serializer_class = UserSerializerclass GroupViewSet(viewsets.ModelViewSet): """ API 允許檢視或編輯組 """ queryset = Group.objects.all() serializer_class = GroupSerializer
現在,你可以生成 URL 以便人們可以存取你剛起步的 API。在文字編輯器中開啟 urls.py
並將預設範例程式碼替換為以下程式碼:
from django.urls import include, pathfrom rest_framework import routersfrom tutorial.quickstart import viewsrouter = routers.DefaultRouter()router.register(r'users', views.UserViewSet)router.register(r'groups', views.GroupViewSet)# 使用自動路由 URL# 還有登入 URLurlpatterns = [ path('', include(router.urls)), path('api-auth/', include('rest_framework.urls', namespace='rest_framework'))]
這個範例專案的設定模組儲存在 tutorial/settings.py
中,因此在文字編輯器中將其開啟,然後在 INSTALLED_APPS
列表的末尾新增 rest_framework
:
INSTALLED_APPS = [ ... 'rest_framework',]
現在,你可以測試構建的 API。首先,從命令列啟動內建伺服器:
$ python3 manage.py runserver
你可以通過使用 curl
導航至 URL http://localhost:8000/users
來存取 API:
$ curl --get http://localhost:8000/users/?format=json[{"url":"http://localhost:8000/users/1/?format=json","username":"admin","email":"[email protected]","groups":[]}]
使用 Firefox 或你選擇的開源瀏覽器:
有關使用 Django 和 Python 的 RESTful API 的更多深入知識,參考出色的 Django 文件。
Django 的主要優點:
Django 的主要缺點:
對你的應用程式或 API 來說,Django 是絕佳選擇。下載並熟悉它,開始開發一個迷人的專案!