Архитектура и принципы работы GraphQL
Что происходит между клиентом, схемой и источниками данных
1. Главная идея архитектуры
GraphQL-сервер — это прослойка, которая принимает декларативные запросы, проверяет их на соответствие схеме, исполняет нужные резолверы и возвращает результат.
Он не хранит данные сам по себе.
GraphQL — это не база данных, а универсальный интерфейс к любому источнику данных: SQL, NoSQL, микросервисы, REST, файлы, внешние API.
Его задача — связать клиентскую структуру запроса со структурой данных в бэкенде.
Схематично:
Клиент → GraphQL сервер → Источники данных (DB, REST, gRPC, API)
2. Schema — сердце GraphQL
Schema (схема) — это основной контракт между клиентом и сервером.
Она описывает:
какие данные доступны;
какие поля у этих данных есть;
какие операции можно выполнять.
Схема написана на SDL (Schema Definition Language), декларативном языке, напоминающем описание классов.
Пример:
Ключевые понятия:
type — определяет структуру данных (аналог Java-класса или DTO).
! — обязательное поле (non-null).
[User!]! — список пользователей, где ни один элемент не равен null.
Query — специальный тип, описывающий операции чтения.
Схема — это не код, а декларация.
На её основе GraphQL сервер автоматически понимает, как валидировать запросы, какие поля допустимы и какие возвращать ошибки.
3. Query, Mutation, Subscription — три типа операций
GraphQL разделяет все действия на три категории.
1. Query — запрос данных (аналог GET в REST)
Используется для чтения.
Клиент описывает, какие сущности и поля нужны:
Сервер вернёт данные в том же формате:
2. Mutation — изменение данных (аналог POST/PUT/DELETE)
Mutation обозначает действия, которые модифицируют состояние системы.
Они могут создавать, обновлять или удалять записи.
GraphQL возвращает результат — обновлённые данные или подтверждение операции.
3. Subscription — подписка на события (реактивный поток)
Subscription создаёт постоянное соединение между клиентом и сервером (обычно через WebSocket).
Когда на сервере происходят изменения, клиент получает уведомления в реальном времени.
Если на сервере создан новый пользователь, событие userCreated автоматически отправляется всем подписанным клиентам.
4. Как работает запрос GraphQL: путь от клиента до данных
Чтобы понять механику, посмотрим на полный цикл обработки запроса.
Шаг 1. Клиент отправляет запрос
Клиент (например, браузер) отправляет HTTP POST на /graphql с JSON-телом:
Шаг 2. Сервер парсит и валидирует запрос
GraphQL-сервер:
Парсит текст запроса.
Проверяет, что все поля и типы существуют в схеме.
Проверяет типы аргументов (id действительно ID!).
Отклоняет запрос, если нарушен контракт схемы.
Таким образом, сервер никогда не выполнит запрос, который не соответствует схеме.
Это гарантирует типобезопасность и предсказуемость работы.
#Java #middle #GraphQL
Что происходит между клиентом, схемой и источниками данных
1. Главная идея архитектуры
GraphQL-сервер — это прослойка, которая принимает декларативные запросы, проверяет их на соответствие схеме, исполняет нужные резолверы и возвращает результат.
Он не хранит данные сам по себе.
GraphQL — это не база данных, а универсальный интерфейс к любому источнику данных: SQL, NoSQL, микросервисы, REST, файлы, внешние API.
Его задача — связать клиентскую структуру запроса со структурой данных в бэкенде.
Схематично:
Клиент → GraphQL сервер → Источники данных (DB, REST, gRPC, API)
2. Schema — сердце GraphQL
Schema (схема) — это основной контракт между клиентом и сервером.
Она описывает:
какие данные доступны;
какие поля у этих данных есть;
какие операции можно выполнять.
Схема написана на SDL (Schema Definition Language), декларативном языке, напоминающем описание классов.
Пример:
type User {
id: ID!
name: String!
posts: [Post!]!
}
type Post {
id: ID!
title: String!
content: String
}
type Query {
user(id: ID!): User
allUsers: [User!]!
}Ключевые понятия:
type — определяет структуру данных (аналог Java-класса или DTO).
! — обязательное поле (non-null).
[User!]! — список пользователей, где ни один элемент не равен null.
Query — специальный тип, описывающий операции чтения.
Схема — это не код, а декларация.
На её основе GraphQL сервер автоматически понимает, как валидировать запросы, какие поля допустимы и какие возвращать ошибки.
3. Query, Mutation, Subscription — три типа операций
GraphQL разделяет все действия на три категории.
1. Query — запрос данных (аналог GET в REST)
Используется для чтения.
Клиент описывает, какие сущности и поля нужны:
query {
user(id: 42) {
name
posts {
title
}
}
}Сервер вернёт данные в том же формате:
{
"data": {
"user": {
"name": "Den",
"posts": [
{ "title": "gRPC и Java" },
{ "title": "GraphQL под капотом" }
]
}
}
}2. Mutation — изменение данных (аналог POST/PUT/DELETE)
Mutation обозначает действия, которые модифицируют состояние системы.
Они могут создавать, обновлять или удалять записи.
mutation {
createUser(input: { name: "Alex" }) {
id
name
}
}GraphQL возвращает результат — обновлённые данные или подтверждение операции.
3. Subscription — подписка на события (реактивный поток)
Subscription создаёт постоянное соединение между клиентом и сервером (обычно через WebSocket).
Когда на сервере происходят изменения, клиент получает уведомления в реальном времени.
subscription {
userCreated {
id
name
}
}Если на сервере создан новый пользователь, событие userCreated автоматически отправляется всем подписанным клиентам.
4. Как работает запрос GraphQL: путь от клиента до данных
Чтобы понять механику, посмотрим на полный цикл обработки запроса.
Шаг 1. Клиент отправляет запрос
Клиент (например, браузер) отправляет HTTP POST на /graphql с JSON-телом:
{
"query": "query { user(id: 42) { name posts { title } } }"
}
GraphQL-запрос — это декларативное описание структуры данных, не код и не SQL.Шаг 2. Сервер парсит и валидирует запрос
GraphQL-сервер:
Парсит текст запроса.
Проверяет, что все поля и типы существуют в схеме.
Проверяет типы аргументов (id действительно ID!).
Отклоняет запрос, если нарушен контракт схемы.
Таким образом, сервер никогда не выполнит запрос, который не соответствует схеме.
Это гарантирует типобезопасность и предсказуемость работы.
#Java #middle #GraphQL
👍1
Шаг 3. Сервер вызывает резолверы
Резолвер (resolver) — это функция, которая знает, как получить данные для конкретного поля.
Например, в Java через библиотеку graphql-java:
Резолверы вызываются рекурсивно:
Сначала выполняется user(id: 42).
Затем для каждого пользователя — posts.
Затем для каждого поста — title.
GraphQL умеет оптимизировать выполнение: например, группировать одинаковые вызовы (DataLoader паттерн).
Шаг 4. Формирование ответа
После выполнения всех резолверов GraphQL собирает результат в структуру, повторяющую форму запроса, и отправляет JSON-ответ клиенту:
Если на каком-то шаге произошла ошибка, она не прерывает всё выполнение.
GraphQL вернёт частичные данные + список ошибок:
5. Почему GraphQL — не база данных
Эта путаница встречается часто.
GraphQL не хранит и не управляет данными.
Он не заменяет SQL или ORM.
GraphQL — это API-уровень, который:
принимает запросы,
интерпретирует их,
вызывает нужные источники данных,
собирает и возвращает результат в едином формате.
Под капотом это может быть:
JDBC-запросы в PostgreSQL,
вызовы REST API других микросервисов,
gRPC-вызовы,
кэш Redis,
файловая система или внешние API.
GraphQL — унифицированный интерфейс доступа к любым данным, независимо от их источника.
6. Интеграция GraphQL в бэкенд
GraphQL не заменяет ваш backend — он становится поверх него.
В Java это обычно выглядит так:
Spring Boot + graphql-spring-boot-starter — стандартный способ поднять GraphQL-сервер.
Схема (.graphqls) описывается декларативно.
Резолверы реализуются как обычные Spring-бины.
Пример:
GraphQL сам вызывает нужный метод в зависимости от запроса клиента.
Таким образом, GraphQL интегрируется поверх существующего слоя сервисов и репозиториев, не требуя переписывания бизнес-логики.
#Java #middle #GraphQL
Резолвер (resolver) — это функция, которая знает, как получить данные для конкретного поля.
Например, в Java через библиотеку graphql-java:
GraphQLObjectType userType = newObject()
.name("User")
.field(field -> field
.name("id")
.type(Scalars.GraphQLID))
.field(field -> field
.name("name")
.type(Scalars.GraphQLString))
.field(field -> field
.name("posts")
.type(new GraphQLList(postType))
.dataFetcher(env -> postService.getByUser(env.getSource())))
.build();
Резолверы вызываются рекурсивно:
Сначала выполняется user(id: 42).
Затем для каждого пользователя — posts.
Затем для каждого поста — title.
GraphQL умеет оптимизировать выполнение: например, группировать одинаковые вызовы (DataLoader паттерн).
Шаг 4. Формирование ответа
После выполнения всех резолверов GraphQL собирает результат в структуру, повторяющую форму запроса, и отправляет JSON-ответ клиенту:
{
"data": {
"user": {
"name": "Den",
"posts": [{ "title": "gRPC и Java" }]
}
}
}Если на каком-то шаге произошла ошибка, она не прерывает всё выполнение.
GraphQL вернёт частичные данные + список ошибок:
{
"data": { "user": null },
"errors": [{ "message": "User not found" }]
}5. Почему GraphQL — не база данных
Эта путаница встречается часто.
GraphQL не хранит и не управляет данными.
Он не заменяет SQL или ORM.
GraphQL — это API-уровень, который:
принимает запросы,
интерпретирует их,
вызывает нужные источники данных,
собирает и возвращает результат в едином формате.
Под капотом это может быть:
JDBC-запросы в PostgreSQL,
вызовы REST API других микросервисов,
gRPC-вызовы,
кэш Redis,
файловая система или внешние API.
GraphQL — унифицированный интерфейс доступа к любым данным, независимо от их источника.
6. Интеграция GraphQL в бэкенд
GraphQL не заменяет ваш backend — он становится поверх него.
В Java это обычно выглядит так:
Spring Boot + graphql-spring-boot-starter — стандартный способ поднять GraphQL-сервер.
Схема (.graphqls) описывается декларативно.
Резолверы реализуются как обычные Spring-бины.
Пример:
@Component
public class UserResolver implements GraphQLQueryResolver {
private final UserService userService;
public UserResolver(UserService userService) { this.userService = userService; }
public User user(Long id) {
return userService.findById(id);
}
public List<User> allUsers() {
return userService.findAll();
}
}
GraphQL сам вызывает нужный метод в зависимости от запроса клиента.
Таким образом, GraphQL интегрируется поверх существующего слоя сервисов и репозиториев, не требуя переписывания бизнес-логики.
#Java #middle #GraphQL
👍1
Что выведет код?
#Tasks
import java.util.concurrent.ConcurrentHashMap;
public class Task131125 {
public static void main(String[] args) {
ConcurrentHashMap<String, Integer> map = new ConcurrentHashMap<>();
map.put("a", 1);
map.put("b", 2);
map.put("c", 3);
int result = map.reduce(2,
(k, v) -> k.length() + v,
Integer::sum
);
System.out.println(result);
}
}
#Tasks
Вопрос с собеседований
Что такое CI/CD pipeline?🤓
Ответ:
CI/CD — это процесс автоматизации сборки, тестирования и доставки кода.
CI (Continuous Integration) проверяет код при каждом коммите, CD (Continuous Deployment/Delivery) — автоматически выкатывает его на сервер.
Примеры: Jenkins, GitHub Actions, GitLab CI.
#собеседование
Что такое CI/CD pipeline?
Ответ:
CI (Continuous Integration) проверяет код при каждом коммите, CD (Continuous Deployment/Delivery) — автоматически выкатывает его на сервер.
Примеры: Jenkins, GitHub Actions, GitLab CI.
#собеседование
Please open Telegram to view this post
VIEW IN TELEGRAM
👍3
История IT-технологий сегодня — 14 ноября
ℹ️ Кто родился в этот день
Александр Юльевич Дроздов (род. 14 ноября 1966) — российский разработчик/учёный, кандидат/д.т.н.; вёл работы по трансляторам, автоматическим распараллеливателям и созданию Универсальной Библиотеки Трансляции (УБТ), применимым к современным архитектурам (x86, ARM и др.).
Питер Нортон (англ. Peter Norton; род. 14 ноября 1943) — американский предприниматель, программист и филантроп. В 1980-х годах создал популярную программу для персональных компьютеров, позволяющую восстанавливать стёртые данные. Эта утилита вместе с несколькими другими образовали пакет Norton Utilities. Вскоре в пакет был включён Norton Commander, удобный файловый менеджер для операционной системы DOS.
🌐 Знаковые события
1969 — с мыса Канаверал стартовал к Луне американский космический корабль «Аполлон-12», пилотируемый астронавтами Ч. Конрадом, А. Бином и Р. Гордоном.
#Biography #Birth_Date #Events #14Ноября
Александр Юльевич Дроздов (род. 14 ноября 1966) — российский разработчик/учёный, кандидат/д.т.н.; вёл работы по трансляторам, автоматическим распараллеливателям и созданию Универсальной Библиотеки Трансляции (УБТ), применимым к современным архитектурам (x86, ARM и др.).
Питер Нортон (англ. Peter Norton; род. 14 ноября 1943) — американский предприниматель, программист и филантроп. В 1980-х годах создал популярную программу для персональных компьютеров, позволяющую восстанавливать стёртые данные. Эта утилита вместе с несколькими другими образовали пакет Norton Utilities. Вскоре в пакет был включён Norton Commander, удобный файловый менеджер для операционной системы DOS.
1969 — с мыса Канаверал стартовал к Луне американский космический корабль «Аполлон-12», пилотируемый астронавтами Ч. Конрадом, А. Бином и Р. Гордоном.
#Biography #Birth_Date #Events #14Ноября
Please open Telegram to view this post
VIEW IN TELEGRAM
👍2