schema არის GraphQL API-ის ტიპიზირებული კონტრაქტი, დაწერილი SDL-ში (Schema Definition Language). ის აღწერს ყველა ტიპს, ყველა ველს და სპეციალურ root ტიპებს — Query (წაკითხვა), Mutation (ჩაწერა) და, სურვილისამებრ, Subscription (ცოცხალი მონაცემი). სერვერი უარყოფს ნებისმიერ request-ს, რომელიც schema-ს არ ესადაგება.
Int, Float, String, Boolean და ID. ასევე შეგიძლია განსაზღვრო custom scalar-ები, მაგალითად DateTime.scalar DateTime # a custom scalar
type User { # an object type
id: ID! # ! means non-null (always present)
name: String!
createdAt: DateTime!
posts: [Post!]! # a list of Post objects, non-null list of non-null items
}
type Post {
id: ID!
title: String!
author: User! # points back to User -> a relationship
}
type Query { # root type: the entry points for reads
user(id: ID!): User # a field with an argument; returns a User (nullable)
}
! აღნიშნავს non-null-ს; [Post!]! არის non-null სია, რომლის ელემენტებიც non-null-ია. არგუმენტები (id: ID!) ველის პარამეტრიზების საშუალებას იძლევა.
schema არის ჭეშმარიტების ერთადერთი წყარო — ის ამოძრავებს ვალიდაციას, ავტომატურად გენერირებულ დოკუმენტაციას და კლიენტის codegen-ს. !-ისა და სია-ტიპების სწორად წაკითხვა ხშირი junior დონის შემოწმებაა, ხოლო nullability-ის გადაწყვეტილებები განსაზღვრავს, როგორ ამუშავებენ კლიენტები შეცდომებს.
IT გასაუბრების კითხვების ბიბლიოთეკა დეტალური პასუხებით — Junior-დან Senior-მდე.
შემოწირულობა