'GraphQL Schema Design' by Borys Mohyla. OdessaJS'2021
Download as PPTX, PDF•0 likes•207 views
OdessaJS'2021
'GraphQL Schema Design' by Borys Mohyla. OdessaJS'2021
- 2. Agenda 1 ПРАВИЛА ІМЕНУВАННЯ 6 2 3 4 5 ПРАВИЛА ТИПІВ ПРАВИЛА ПОЛІВ ПРАВИЛА АРГУМЕНТІВ ПРАВИЛА СПИСКІВ ПРАВИЛА МУТАЦІЙ 2 7 ПРАВИЛА ЗВ’ЯЗКІВ 8 ІНШІ ПРАВИЛА
- 6. Варіанти реалізації GraphQL схеми
- 7. Правила іменування Використовуйте camelCase для іменування полів і аргументів
- 8. Правила іменування Використовуйте UpperCamelCase для іменування GraphQL-типів
- 10. Правила типів Використовуйте кастомні скалярні типи для визначення семантичного значення
- 11. Правила типів Використовуйте Enum для полів з визначеним набором значень
- 12. Правила полів Використовуйте зрозумілі імена, а не те як вони реалізовані
- 13. Правила полів Робіть поля NonNull, якщо дані повертаються завжди
- 14. Правила полів Досягайте максимального опису обов’язкових полів
- 15. Правила полів VS
- 16. Правила аргументів Групуйте зв’язані аргументи в input-типи
- 17. Правила аргументів Використовуйте скалярні типи для аргументів
- 19. Правила списків Для фільтрації використовуйте input-тип (filter)
- 20. Правила списків Для сортування використовуйте Enum input-тип (sort)
- 22. Правила списків
- 23. Правила списків Використовуйте Relay Cursor Connections Specification для безкінечних списків
- 24. Правила мутацій Використовуйте Namespace- типи для групування мутацій в рамках одного ресурса
- 25. Створюйте невеликі мутації для різних логічних операцій Правила мутацій
- 26. Розглядайте можливість виконання мутацій відразу над декількома елементами Правила мутацій
- 27. Використовуйте чіткі аргументи для мутацій Правила мутацій
- 28. Вкладайте всі змінні для мутації в один input аргумент Правила мутацій
- 29. Мутація повинна повертати свій унікальний Payload-тип Правила мутацій
- 30. Правила зв’язків GraphQL-схема повинна бути “волосатою”
- 31. Правила зв’язків
- 32. Інші правила Для документації використовуйте markdown
- 33. Підтримка складної схеми ● використовуйте code-first підхід ● при потребі потрібно використати apollo-federation
- 34. Корисні посилання • GraphQL - schema-first vs code-first • Schema Design by Pavel Chertorogov • Shopify: Designing a GraphQL API • Designing GraphQL Mutations by Caleb Meredith • GraphQL best practices for GraphQL schema design by David Mráz • GraphQL Best Practices Resources and Design Patterns • GraphQL Summit 2019
- 35. 35 site : https://boryamogila.github.io/ facebook: Boris Mohyla twitter: Borya Mogila email: [email protected] Контактні дані
- 36. THANK YOU! 36