GraphQL: Typy danych

15.3.0 +

0:00Witaj w kolejnej lekcji, w której opowiem Ci o typach danych.

0:03Jak widzisz jesteśmy na stronie https://graphql.org/.

0:05Jest to strona z oficjalną dokumentacją GraphQL'a

0:08i znajdujemy się w sekcji scalar types.

0:11Również link do tej strony znajdziesz w plikach źródłowych.

0:14To co możesz tutaj zobaczyć, są to typy wbudowane w GraphQL'a.

0:18Są to tzw. typy scalar i możemy wyróżnić

0:20pięć różnych typów: Int, Float, String, Boolean oraz ID.

0:26Typ ID nie różni się niczym szczególnym od typu String,

0:30poza tym że powinien on być unikatowy, tak abyśmy mogli

0:34stworzyć z niego cache lub takie rzeczy.

0:37Poza typami wbudowanymi mamy również typy customowe,

0:41które tworzymy właśnie z tych wbudowanych typów.

0:44Jeżeli wrócimy do dokumentacji.

0:49To możemy zobaczyć, że nasze metody getBooks,

0:53getBook, getAuthor posiadają swoje własne typy.

0:57Typ Book, Author, PersonResults itd.

1:01Typ Book implementuje typy scalar: typ ID oraz String

1:07oraz typ Author posiada nowy customowy typ Author.

1:11Te typy są zaimplementowane po stronie naszego serwera.

1:15Nie będziemy implementować własnych customowych typów,

1:18ponieważ tym zajmuje się serwer.

1:19Natomiast ważne jest abyśmy umiał je odróżnić.

1:23Kiedy wejdziemy w typ Author

1:25możesz zobaczyć, że mamy kolejne typy skalar jest to: ID, String

1:31dla pól firstName oraz pól lastName.

1:34Dodatkowo są tutaj takie wykrzykniki, które oznaczają,

1:37że dane pole nie może być nullem,

1:40czyli oznacza to, że kiedy zapytamy o pole Author,

1:43to nie może ono zwrócić nulla.

1:45Również kiedy zapytamy o pole String nie może zwrócić nulla czy o pole ID.

1:50Kolejną rzeczą, którą widzisz jest to tak zwany nawias kwadratowy

1:55i oznacza on, że dane pole będzie tablicą.

1:58Kiedy przypomnisz sobie jak używaliśmy typu getBooks,

2:02to zwracana była tablica z książkami.

2:05Jeżeli zobaczymy tą metodę getBook, to zwracana jest po prostu książka,

2:10getAuthor będzie zwracany po prostu author

2:13ponieważ nie ma tutaj tych nawiasów kwadratowych.

2:15Natomiast wróćmy jeszcze do pól typu non-nullable.

2:19Wróćmy do dokumentacji.

2:21Kiedy tutaj niżej,

2:23mamy tutaj rozdział List and Non-Null.

2:27i mamy tutaj kilka przykładów.

2:29Zobaczmy na pierwszy przykład.

2:31Pierwszy przykład implementuje tablicę ze Stringami,

2:35natomiast mamy tutaj wykrzyknik po słowie kluczowym String

2:39czyli pole może być nullem, ale już pola w tablicy nie mogą być nullami,

2:44czyli muszą być tam zwrócone ciągi znaków.

2:47I tutaj jest to bardzo fajnie opisane,

2:50kiedy zwróci nam dane pole null będzie to walidowalne.

2:54Kiedy zwróci nam tablicę również jest to poprawne.

2:57Kiedy zwróci a, b jako stringi to jest to poprawne.

3:00Natomiast w momencie kiedy mamy w tej tablicy nulla to już dostaniemy błąd.

3:04I to waliduje dla nas GraphQL,

3:07więc GraphQL od razu rzuci nam błąd, że mamy niepoprawne dane.

3:11W drugim przykładzie wykrzyknik jest w troszeczkę innym miejscu.

3:14Oznacza to, że dane pole nie może być nullem.

3:17Natomiast to co już jest w środku teoretycznie mogłoby być nullem.

3:22I na tych przykładach tutaj jak widzisz jest to dokładnie opisane.

3:28Kiedy jest null dostaniemy błąd.

3:29Natomiast kiedy jest pusta tablica czy tablica ze stringami

3:33czy tablica ze stringami i nullem to jest to poprawne.

3:37Wracając do naszej dokumentacji,

3:40dla metody getBooks nie możemy dostać pola null.

3:44Czyli na pewno musimy dostać tablicę.

3:46Jeżeli w naszej bazie danych nie będzie książek, to dostaniemy pustą tablicę.

3:50To daje nam pewność podczas implementacji frontendowej, że możemy wykonać

3:54jakieś działania na tablicy typu: map, filter itd.