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?