Higher view of GraphQL

[reboottime]

What is it and When to use it

• What is GraphQL?: what you defined is what you will get.
  GraphQL offers a solution to the issues of under-fetching and over-fetching data present in traditional RESTful APIs by allowing clients to specify the exact data they need through a declarative language
• When you may want to use it:
  • data source complexity: apply graphql server as the middleware to glue multiple data source, either during BE refactoring or FE needs to work with multiple data source
  • Project with anticipation of future complexity on data

[reboottime]

Major Concepts

• Grammar: Similar to Typescript, support defining new primitive type or composing new type based on other types.

• GraphQL Concepts Map

  • Schema
    • Types
      • Objects
      • Scalars
      • Enums
      • Interfaces
  • Query Language
    • Fields
    • Reduce over-fetching
  • Resolvers
    • Fetch data for fields
  • Mutations
    • Modify data on server
  • Subscriptions
    • Real-time communication
  • Introspection
    • Query schema

• Comparison:

[reboottime]

Production Ready Solutions

• TypeGraphQL, server side, write query code using typescript
• Client Side Interaction: Apollo Client, design logic is similar to react query
  • variables passed in are query keys in react query
  • graphql code similar to services, defined as the api contract on data interaction
  • mutation, query concepts

---

Unresolved problems

• integration test?