GraphQL SDL – Schema Definition Language Phần 2

Tram Ho

Nối tiếp Phần một về Schema Definition Language của GraphQL, bài viết này trình bày tiếp các khái niệm được sử dụng để định nghĩa GraphQL Schema

1. Interfaces

  • Cũng giống như khái niệm Interface ở các language khác, trong GraphQL, một Interface là một asbstract type có thể bao gồm một tập nhất định các field mà các type khi implement nó cũng phải bao gồm các field đó.
  • Ví dụ, bạn có một interface Character đại diện cho bất kì nhân vật nào trong Star Wars

    Bất kì type nào mà Implements Characters cần phải có đầy đủ các trường trên với cùng tham số hay cùng type.
  • Ví dụ, các type sáu đây có thể implement Character

    Cả 3 type này đều có tất cả các trường từ Character interface, đồng thời cũng có các trường bổ sung như totalCredits, starships, primaryFunction giúp xác định các loại Character cụ thể.
  • Interface hữu ích khi mà bạn muốn trả về một object hay là một bộ các object, nhưng chúng lại có các trường khác nhau.
  • Ví dụ, câu query sau sẽ sinh ra lỗi

    QUERY DEFINITION


    CLIENT CALL QUERY

    VARIABLES

    RESULT
  • Trường hero trả về một kiểu Character, nó có thể là Human hay Droid tùy thuộc vào biến episode. Trong câu query trên bạn chỉ có thể chỉ định trả về những field mà tồn tại trong Character interface, như vậy sẽ không có primaryFunction
  • Để yêu cầu trả về các trường trong một object type cụ thể, sử dụng inline fragments

2. Union types

  • Ví dụ
  • Bất cứ khi nào chúng ta trả về một loại Search Result trong schema, SearchResult này có thể là một Human, Droid, hoặc một Starship. Các thành phần của một union type cần phải là một loại đối tượng cụ thể, không được là một interface hay là một union khác
  • Khi phía client query một field mà trả về một union type là SearchResult, chúng ta cần phải sử dụng inline fragment để có thể query bất kì trường nào.

    CLIENT QERRY


    RESULT
  • Trường __typename là một String giúp bạn phân biệt sự khác nhau giữa các object type ở Client
  • Ở ví dụ này, vì Human và Droid cùng implement một interface chung là Character nên bạn có thể query những trường chung của 2 object type này ở chỉ một chỗ mà không cần lặp lại các trường giống nhau ở mỗi type, ví dụ sau đây cho kết quả như bên trên:

    Lưu ý: Trường name vẫn phải được chỉ định đối với Starship bởi Starship không phải là một Character

3.Input types

  • Từ đầu đến giờ, chúng ta chỉ nói về truyền vào một field các argument thuộc về kiểu scalar như enums hay strings. Tuy nhiên bạn có thể truyền argument là một object phức tạp. Điều này cực kì hữu ích khi bạn muốn truyền vào toàn bộ object để tạo cái gì đó.
  • Trong GraphQL SDL, input types nhìn sẽ giống một object types thông tường nhưng với keyword input thay vì type
  • Ví dụ sử dụng input type trong một mutation

    MUTATION DEFINITION


    VARIABLES

    RESULT

4. Kết luận

Chia sẻ bài viết ngay

Nguồn bài viết : Viblo