Сервер Apollo GraphQL + TypeScript

Я использовал Аполлон-сервер-экспресс с Typescript для некоторых проектов, и у меня есть небольшая демонстрация gitHub с ним.

Я не уверен насчет best practices, но apollo-server-express в основном предоставляет обработчики graphqlExpress и graphiqlExpress.

Ознакомьтесь с документацией о Сервер Apollo с Express для получения дополнительной информации.

Я использую GraphQL CLI. Вы бы установили это так

npm install -g graphql-cli

затем сгенерируйте свой проект GraphQL с поддержкой TypeScript

Дополнительная информация: https://oss.prisma.io/content/graphql-cli/05-Boilerplates.html

Я написал для этого небольшую библиотеку и интерфейс командной строки. Он генерирует типизацию TypeScript как для сервера (согласно вашей схеме), так и для клиента (согласно вашей схеме и документам GraphQL). Он также генерирует сигнатуру резолверов и очень настраиваемый.

Вы можете попробовать это здесь: https://github.com/dotansimha/graphql-code-generator

Идея заключалась в том, чтобы позволить разработчику максимально использовать GraphQL и сгенерированные типы ввода, а также упростить настройку сгенерированного вывода.

Я довольно давно использую сервер typescript + apollo graphql и запустил шаблон, который включает в себя Дотанагенератор кода графа вместе с определенной структурой папок и подходом, который заставляет все хорошо работать вместе. Основное внимание уделяется простоте, но я продолжаю добавлять к нему, когда нахожу передовые практики и полезные библиотеки.

Репозиторий github - здесь.

Я написал небольшую упаковку под названием typescript-typedefs. Он позволяет вам определять классы и использовать декораторы машинописного текста для генерации оттуда определений типов машинописного текста. Это делает его очень простым и очень хорошо работает с сервером apollo.

Пример:

@Type()
class Student {
  @Field(ID)
  id: string;

  @Field()
  name: string;

  @Field(String)
  friendNames: string[];

  @Field({ type: Int, nullable: true })
  room: number;

  @Field()
  gpa: number;

  @Field(Course)
  courses: Course[];
}

Обязательно предлагаю использовать type-graphql + apollo-server-express

Обычно существует 2 основных способа написания API-интерфейсов Graphql. Либо сначала код, либо сначала схема.

Схема сначала была самой популярной в сообществе узлов. Это в основном означает написание файла схемы graphql (SDL), а затем его импорт и передачу на сервер apollo (или любые другие инструменты, которые вы используете), а затем подключение преобразователей. Чтобы добавить Typescript в этот поток, вы должны использовать генератор кода, такой как graphql-codegenerator, для генерации определений машинописного текста для преобразователей, которые вам необходимо реализовать.

Сначала код - это способ реализации API-интерфейсов graphql на большинстве других языков. Это в основном означает просто написание схемы с использованием библиотеки, а затем создание схемы (или файла схемы) из вашего кода. Этот подход имеет множество преимуществ, включая отсутствие необходимости определять ваши типы в нескольких разных местах.

Для решений, ориентированных на код, есть несколько хороших вариантов. Type-GraphQL и GraphQL nexus - очень надежные библиотеки с хорошей поддержкой машинописного текста. Лично я всегда буду защищать GiraphQL, потому что я поддерживаю его, но я верю, что в настоящее время это лучший способ создания API-интерфейсов graphql в машинописном тексте.

GiraphQL: https://giraphql.com/

Хорошая беседа о Prisma и почему код сначала хорош https://thewikihow.com/video_5oyWwjLpUS4