Czym jest schemat GraphQL? Wyjaśnij typy skalarne i obiektowe.

Question

IT Interview Practice · Accepted Answer

**Schemat** to typowany kontrakt API GraphQL zapisany w SDL (Schema Definition Language). Deklaruje każdy typ, każde pole oraz specjalne **typy główne (root types)** — `Query` (odczyt), `Mutation` (zapis) i opcjonalnie `Subscription` (dane na żywo). Serwer odrzuca każde żądanie, które nie pasuje do schematu.

## Typy skalarne kontra obiektowe

- **Typy skalarne** to wartości-liście, które przechowują faktyczne dane: wbudowane to `Int`, `Float`, `String`, `Boolean` i `ID`. Możesz też zdefiniować własne skalary, takie jak `DateTime`.
- **Typy obiektowe** grupują pola razem. Ich pola mogą być skalarami *lub* innymi typami obiektowymi — właśnie tak modeluje się relacje.

```graphql
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)
}
```

Znak `!` oznacza **non-null**; `[Post!]!` to lista non-null, której elementy są non-null. Argumenty (`id: ID!`) pozwalają sparametryzować pole.

## Dlaczego to ważne

Schemat jest jedynym źródłem prawdy — napędza walidację, automatycznie generowaną dokumentację i codegen po stronie klienta. Prawidłowe czytanie `!` oraz typów listowych to częsty element weryfikacji juniorów, a decyzje o nullowalności kształtują sposób, w jaki klienci obsługują błędy.

Typy skalarne kontra obiektowe

Dlaczego to ważne

Powiązane pytania