二. 使用 Python 和 Django 創(chuàng)建 GraphQL API

本文將為學(xué)校管理系統(tǒng)構(gòu)建 GraphQL API，該系統(tǒng)包含學(xué)生、教師和課程之間的關(guān)系。我們將實現(xiàn)一個 API，用于獲取課程及其注冊學(xué)生和分配教師信息。

1. 所需工具和技術(shù)棧

• Python：從 Python 官網(wǎng) 下載并安裝適合的版本（本文使用 Windows 系統(tǒng)和 Python 3.12.3）。
• Django：作為 Web 框架，加速開發(fā)并提供完善的 ORM 支持。
• Graphene-Django：用于在 Django 中實現(xiàn) GraphQL API 的庫。

2. 創(chuàng)建開發(fā)環(huán)境

1. 創(chuàng)建虛擬環(huán)境

   python -m venv smsvenv

   激活虛擬環(huán)境后，所有依賴項（如 Django 和 Graphene-Django）都將在此環(huán)境中安裝。

2. 安裝依賴項

   pip install django graphene-django

3. 創(chuàng)建項目結(jié)構(gòu)
   使用 Django 命令創(chuàng)建項目文件夾結(jié)構(gòu)，并將 graphene-django 和 school 添加到 school_management/settings.py 中：

   INSTALLED_APPS = [
      ...
      'graphene_django',
      'school',
   ]

4. 配置數(shù)據(jù)庫
   默認使用 SQLite：

   DATABASES = {
      'default': {
          'ENGINE': 'django.db.backends.sqlite3',
          'NAME': BASE_DIR / 'db.sqlite3',
      }
   }

三. 定義數(shù)據(jù)模型

在 school/models.py 中為學(xué)生、教師和課程定義 Django ORM 模型及其關(guān)系：

1. 多對多關(guān)系：學(xué)生可注冊多門課程，課程可有多個學(xué)生。
2. 一對多關(guān)系：每門課程由一名教師教授，但教師可教授多門課程。

四. 插入示例數(shù)據(jù)

通過 Django Admin 界面創(chuàng)建學(xué)生、教師和課程的示例數(shù)據(jù)：

1. 在 admin.py 中注冊模型。
2. 使用 Django Admin 添加數(shù)據(jù)以便測試 API。

五. 實現(xiàn) GraphQL API

1. 集成 Graphene-Django

在 school/ 目錄創(chuàng)建 schema.py 文件，包含以下兩個主要部分：

• 類型（Types）：定義客戶端請求的數(shù)據(jù)結(jié)構(gòu)。
• 查詢與解析器（Queries and Resolvers）：從數(shù)據(jù)庫獲取數(shù)據(jù)的查詢定義。

2. 定義 GraphQL 類型

使用 DjangoObjectType 將 Django 模型轉(zhuǎn)換為 GraphQL 類型：

import graphene
from graphene_django.types import DjangoObjectType
from .models import Student, Teacher, Course

class StudentType(DjangoObjectType):
    class Meta:
        model = Student

class TeacherType(DjangoObjectType):
    class Meta:
        model = Teacher

class CourseType(DjangoObjectType):
    class Meta:
        model = Course

3. 定義查詢

示例查詢獲取課程及相關(guān)信息：

class Query(graphene.ObjectType):
    all_students = graphene.List(StudentType)
    all_teachers = graphene.List(TeacherType)
    all_courses = graphene.List(CourseType)

    def resolve_all_students(self, info, **kwargs):
        return Student.objects.all()

    def resolve_all_teachers(self, info, **kwargs):
        return Teacher.objects.all()

    def resolve_all_courses(self, info, **kwargs):
        return Course.objects.all()

schema = graphene.Schema(query=Query)

六. 連接 GraphQL 與 Django

在 school/views.py 中添加視圖，用于測試 GraphQL 查詢。在 school_management/urls.py 中將 URL 映射到該視圖，以便通過瀏覽器訪問 API。

七. 總結(jié)

本文介紹了 GraphQL 的基本原理及其在處理復(fù)雜數(shù)據(jù)結(jié)構(gòu)中的優(yōu)勢。通過 Python 和 Django，我們構(gòu)建了一個簡易 GraphQL API，用于管理學(xué)校系統(tǒng)中的學(xué)生、教師和課程數(shù)據(jù)。GraphQL 高性能、低帶寬使用，使其成為現(xiàn)代 API 開發(fā)的理想選擇。建議讀者通過實踐進一步掌握 GraphQL，實現(xiàn)更多高效的數(shù)據(jù)交互場景。

原文鏈接: https://refine.dev/blog/graphql-with-python/