Просто о сложном: язык запросов GraphQL

Но на самом деле многие из нас ежедневно используют продукты, созданные с его помощью. Например, Facebook, New York Times, GitHub, Shopify, Pinterest и пр. Давайте познакомимся с языком запросов поближе. 

GraphQL: определение и преимущества

GraphQL – это язык запросов, их проведения и манипулирования данными API. Его создала компания Meta (ранее Facebook) для собственных потребностей в 2012 году, а в 2015 – он стал доступен широкой аудитории. В конце 2018 года права на язык перешли к GraphQL Foundation. Сегодня он официально так и не переведен на русский язык.

GraphQL стал прекрасной альтернативой REST, в отличие от которого, он отправляет за один запрос сразу большое количество данных с нескольких источников. 

Преимущества:

• достаточно одного запроса для извлечения данных;
• нет привязки к одной базе данных;
• клиентоориентированность за счет предоставления возможности получения необходимого количества данных;
• для работы достаточно одного endpoint;
• можно проверить правильность запроса до начала работы команды;
• возможна комбинация запросов.

GraphQL имеет в своей основе два главных действия: запрос – query и схему – schema.

Запрос – query

GraphQL позволяет выполнять query с прописыванием дополнительного поля stuff. При формировании запроса не требуется прописывать полный путь и знать откуда будут поступать данные. Достаточно отправить его, и сервер сделает все остальное самостоятельно. То есть, отправленный query поступит на сервер и возвратится в виде готового ответа в формате JSON.

Самый простой запрос:

query {
	friends {
		name
		others {
			name
		}
	}
}

На него последует следующий ответ:

{
	"data": {
		"friends": {
			"name": "Alex",
			"others": [{
				"name": "Mike"
			},
			{
				"name": "Jason"
			},
			{
				"name": "Jack"
			}]
		}
	}
}

Ответ полностью отвечает на запрос и имеет идентичный ему формат. Для взаимодействия с языком запросов лучше всего использовать интегрированную среду разработки GraphiQL. После ее подключения будет проще структурировать все запросы, т.к. откроется удобный пользовательский интерфейс с возможностью прописывания каждой schema.

Схема – schema

Schema – это описание запрашиваемых типов данных и всего что с ними связано. Сервисы GraphQL прописывают типы данных, которые можно использовать для запроса. Без проверки на соответствие разработанной схеме, команда не будет выполнена. 

Например, отправляя запрос можно выбрать имя и адрес:

query {
	friend {
		name
		address
	}
}

Ответ всегда будет равен запросу. Именно поэтому мы постоянно можем предсказывать то, что нам выдаст сервер. Но при наличии подробного описания данных, удастся произвести полную детализацию и автоматизировать работу с большим количеством информации. Для этих целей как раз и предназначена schema.