Генератор сигнатур резолверов GraphQL — Numio

Когда пригодится

• Типизировать объект резолверов, передаваемый в Apollo Server или graphql-yoga, чтобы проверялись parent, args и возвращаемые значения.
• Получить интерфейсы DataFetcher для graphql-java по каждому типу с вариантом JAVA Resolvers Signature.

Как пользоваться

1. Вставьте схему в редактор GraphQL Schema.
2. Выберите в выпадающем списке вывода TypeScript Resolvers Signature, Flow Resolvers Signature или JAVA Resolvers Signature.
3. Скопируйте вывод; для TypeScript аннотируйте карту резолверов сгенерированным типом Resolvers.

type Query {
  user(id: ID!): User
}

type User {
  id: ID!
  name: String
}

import { GraphQLResolveInfo } from "graphql"
…
export type QueryResolvers<
  ContextType = any,
  ParentType extends
    ResolversParentTypes["Query"] = ResolversParentTypes["Query"],
> = {
  user?: Resolver<
    Maybe<ResolversTypes["User"]>,
    ParentType,
    ContextType,
    RequireFields<QueryUserArgs, "id">
  >
}

export type UserResolvers<
  ContextType = any,
  ParentType extends
    ResolversParentTypes["User"] = ResolversParentTypes["User"],
> = {
  id?: Resolver<ResolversTypes["ID"], ParentType, ContextType>
  name?: Resolver<Maybe<ResolversTypes["String"]>, ParentType, ContextType>
  __isTypeOf?: IsTypeOfResolverFn<ParentType, ContextType>
}
…

Подробности и ограничения

Сгенерированные типы, такие как QueryResolvers, имеют ContextType = any; обязательные аргументы типизируются через RequireFields, а резолверы объектов содержат необязательный __isTypeOf.

Используется только схема. Сигнатуры резолверов не зависят от операций, поэтому редактора Documents на странице нет.

Вариант Java выводит public interface с методами DataFetcher внутри public class Resolvers в пакете com.example.graphql. Всё выполняется в Web Worker в браузере.

FAQ

Похожие инструменты

Спецификации и справка

• GraphQL Code Generator: typescript-resolvers