3.定義Schema和類型

讓我們通過一個簡單的圖書管理系統來學習GraphQL。首先定義數據類型：

python

復制

importgraphene

classBook(graphene.ObjectType)： title=graphene.String() author=graphene.String() published_year=graphene.Int()

classAuthor(graphene.ObjectType)： name=graphene.String() books=graphene.List(Book)

4.創建查詢

接下來，我們來定義查詢類：

python

復制

classQuery(graphene.ObjectType)： book=graphene.Field(Book，title=graphene.String()) all_books=graphene.List(Book)

defresolve_book(self，info，title)：

這里模擬數據庫查詢

returnBook( title=title， author=“向前”， published_year=2024 )

defresolve_all_books(self，info)：

返回圖書列表

return[ Book(title=“Python進階”，author=“向前”，published_year=2024)， Book(title=“GraphQL實戰”，author=“向前”，published_year=2024) ]

schema=graphene.Schema(query=Query)

5.執行查詢

現在讓我們來執行一些查詢：

python

復制

查詢單本書

query=”’ query{ book(title：“Python進階”){ title author publishedYear } } ”’

result=schema.execute(query) print(result.data)

小貼士：GraphQL的查詢語句看起來很像JSON，但它有自己特殊的語法規則。字段名使用駝峰式命名規則（camelCase）。

6.添加變更（Mutation）

除了查詢，我們還可以通過mutation來修改數據：

python

復制

classCreateBook(graphene.Mutation)： classArguments： title=graphene.String() author=graphene.String() published_year=graphene.Int()

book=graphene.Field(Book)

defmutate(self，info，title，author，published_year)： book=Book(title=title，author=author，published_year=published_year)

這里應該添加保存到數據庫的代碼

returnCreateBook(book=book)

classMutation(graphene.ObjectType)： create_book=CreateBook.Field()

schema=graphene.Schema(query=Query，mutation=Mutation)

使用mutation添加新書：

python

復制

mutation=”’ mutation{ createBook(title：“GraphQL入門”，author：“向前”，publishedYear：2024){ book{ title author publishedYear } } } ”’

result=schema.execute(mutation) print(result.data)

7.實用技巧

1.錯誤處理：GraphQL會返回詳細的錯誤信息，包括具體的字段和原因。

2.查詢優化：可以使用only()和select_related()來優化數據庫查詢。

3.字段別名：可以給字段取別名，避免命名沖突：

python

復制

query=”’ query{ pythonBook：book(title：“Python進階”){ title } graphqlBook：book(title：“GraphQL實戰”){ title } } ”’

注意事項：

在生產環境中，記得添加適當的身份驗證和權限控制 對查詢的深度和復雜度進行限制，避免惡意查詢 *合理使用數據加載器（DataLoader）來避免N+1查詢問題

8.練習題

1.嘗試給Book類型添加一個price字段，并修改相關的查詢和變更操作 2.實現一個刪除圖書的mutation 3.添加一個按作者名查詢所有圖書的查詢

小伙伴們，今天的Python學習之旅就到這里啦！

GraphQL確實是一個強大的API查詢工具，它能讓我們的數據獲取更加精確和高效。

記得動手實踐哦，有問題隨時在評論區問向前。

祝大家學習愉快，Python學習節節高！

復制markdown

復制

PyGraphQL-API進階：深入GraphQL的高級特性！

大家好，我是向前！上一篇文章我們學習了GraphQL的基礎知識，今天讓我們繼續深入探索GraphQL在Python中的一些高級特性和實用技巧！

9.接口和聯合類型

在GraphQL中，接口（Interface）和聯合類型（Union）是兩個非常實用的高級特性。

接口實現

“`python importgraphene

classHasAuthor(graphene.Interface)： author=graphene.String() publish_date=graphene.String()

classArticle(graphene.ObjectType)： classMeta： interfaces=(HasAuthor，)

title=graphene.String() content=graphene.String()

classBook(graphene.ObjectType)： classMeta： interfaces=(HasAuthor，)

title=graphene.String() isbn=graphene.String()

聯合類型

python

復制

classSearchResult(graphene.Union)： classMeta： types=(Article，Book)

classQuery(graphene.ObjectType)： search=graphene.List(SearchResult，keyword=graphene.String())

defresolve_search(self，info，keyword)：

模擬搜索結果

results=[ Article( title=“GraphQL教程”， content=“GraphQL入門指南”， author=“向前”， publish_date=“2024-01-01” )， Book( title=“Python實戰”， isbn=“123-456-789”， author=“向前”， publish_date=“2024-02-01” ) ] returnresults

10.數據加載優化

為了解決N+1查詢問題，我們可以使用Promise和DataLoader：

python

復制

frompromiseimportPromise frompromise.dataloaderimportDataLoader

classBookLoader(DataLoader)： defbatch_load_fn(self，keys)：

模擬批量查詢數據庫

books=[ {“id”：k，“title”：f“Book{k}”，“author”：“向前”} forkinkeys ] returnPromise.resolve(books)

book_loader=BookLoader()

classQuery(graphene.ObjectType)： books=graphene.List( Book， ids=graphene.List(graphene.ID) )

defresolve_books(self，info，ids)： returnbook_loader.load_many(ids)

11.自定義標量類型

有時候我們需要自定義數據類型，比如日期或JSON：

python

復制

importjson fromgraphene.typesimportScalar fromdatetimeimportdatetime

classJSONScalar(Scalar)： @staticmethod defserialize(dt)： returnjson.dumps(dt)

@staticmethod defparse_literal(node)： returnjson.loads(node.value)

@staticmethod defparse_value(value)： returnjson.loads(value)

classDateTimeScalar(Scalar)： @staticmethod defserialize(dt)： returndt.isoformat()

@staticmethod defparse_value(value)： returndatetime.fromisoformat(value)

classBook(graphene.ObjectType)： metadata=JSONScalar() published_at=DateTimeScalar()

12.訂閱功能

GraphQL還支持實時訂閱功能，這在需要實時更新的場景非常有用：

python

復制

importasyncio fromgrapheneimportObjectType，Field，String

classSubscription(ObjectType)： count=Field(String)

asyncdefresolve_count(root，info)：

模擬實時數據流

foriinrange(5)： yieldf“Count：{i}” awaitasyncio.sleep(1)

schema=graphene.Schema( query=Query， mutation=Mutation， subscription=Subscription )

13.中間件實現

中間件可以幫助我們處理認證、日志等通用邏輯：

python

復制

classAuthMiddleware： defresolve(self，next，root，info，args)： ifnotinfo.context.get(‘is_authenticated’)： raiseException(‘Authenticationrequired’) returnnext(root，info，args)

classLoggingMiddleware： defresolve(self，next，root，info，args)： start=time.time() result=next(root，info，args) duration=time.time()-start print(f“Field{info.field_name}took{duration}storesolve”) returnresult

schema=graphene.Schema( query=Query， mutation=Mutation， middleware=[AuthMiddleware()，LoggingMiddleware()] )

14.性能優化小貼士

1.查詢復雜度控制：

python

復制

fromgraphene.validationimportvalidate_max_depth

defvalidate_query(query_string)： returnvalidate_max_depth(query_string，max_depth=5)

2.批量數據獲取：

python

復制

classQuery(graphene.ObjectType)： books=graphene.List( Book， first=graphene.Int()， offset=graphene.Int() )

defresolve_books(self，info，first=None，offset=None)： books=get_books()#獲取所有圖書 ifoffsetisnotNone： books=books[offset：] iffirstisnotNone： books=books[：first] returnbooks