Juniper: Элегантная GraphQL библиотека на Rust для современных веб-приложений

Juniper — GraphQL на Rust с безопасностью типов и производительностью

В мире современных веб-API GraphQL стал стандартом для построения гибких и эффективных интерфейсов. Если вы разрабатываете на Rust и ищете зрелую, безопасную и быструю библиотеку для реализации GraphQL, то Juniper — это то, что вам нужно. Juniper предоставляет декларативный макросный подход, полную поддержку типов Rust и бесшовную интеграцию с популярными веб-фреймворками.

Juniper позволяет описывать GraphQL-схему напрямую через структуры и перечисления Rust, что гарантирует type-safety на всех этапах. Библиотека поддерживает подписки (subscriptions), мутации (mutations), сложные типы, интерфейсы, union-типы и пользовательские скаляры. Благодаря нулевой стоимости абстракций Rust, Juniper работает с минимальными накладными расходами.

Основные возможности Juniper

• Декларативное описание схемы — используйте макросы #[derive(GraphQLObject)], #[derive(GraphQLInputObject)] и #[derive(GraphQLEnum)].
• Поддержка асинхронности — работает с async/await и любым асинхронным рантаймом (Tokio, async-std).
• Встроенные контексты — передавайте состояние (база данных, авторизация) через Context.
• Подписки (Subscriptions) — реализация real-time обновлений через WebSocket.
• Интеграция с фреймворками — официальные крейты для actix-web, rocket, warp, axum и iron.
• Валидация и ошибки — автоматическая проверка типов и кастомные ошибки через FieldError.

Быстрый старт с Juniper и Actix-web

Рассмотрим минимальный пример GraphQL-сервера на Actix-web. Для начала добавьте зависимости в Cargo.toml:

[dependencies]
juniper = "0.16"
actix-web = "4"
actix-rt = "2"
serde = { version = "1", features = ["derive"] }
serde_json = "1"

Теперь создадим простую схему с одним корневым запросом:

use juniper::{GraphQLObject, GraphQLInputObject, FieldResult, Context, RootNode};

// Определяем объект для ответа
#[derive(GraphQLObject)]
struct User {
    id: i32,
    name: String,
    email: String,
}

// Входной объект для мутации
#[derive(GraphQLInputObject)]
struct CreateUserInput {
    name: String,
    email: String,
}

// Контекст — хранилище данных (например, in-memory)
pub struct Database {
    users: Vec<User>,
}

impl Context for Database {}

// Корневые запросы (Query)
pub struct Query;

#[juniper::graphql_object(context = Database)]
impl Query {
    fn users(context: &Database) -> Vec<User> {
        context.users.clone()
    }

    fn user(context: &Database, id: i32) -> Option<User> {
        context.users.iter().find(|u| u.id == id).cloned()
    }
}

// Корневые мутации (Mutation)
pub struct Mutation;

#[juniper::graphql_object(context = Database)]
impl Mutation {
    fn create_user(context: &mut Database, input: CreateUserInput) -> FieldResult<User> {
        let new_id = context.users.len() as i32 + 1;
        let user = User {
            id: new_id,
            name: input.name,
            email: input.email,
        };
        context.users.push(user.clone());
        Ok(user)
    }
}

// Собираем схему
pub type Schema = RootNode<'static, Query, Mutation>;

Интеграция с Actix-web

Теперь подключим Juniper к HTTP-эндпоинтам Actix-web:

use actix_web::{web, App, HttpServer, HttpResponse, middleware};
use juniper_actix::{graphql_handler, playground_handler};
use std::sync::Mutex;

async fn graphql_route(
    req: actix_web::HttpRequest,
    payload: actix_web::web::Payload,
    schema: web::Data<Schema>,
    db: web::Data<Mutex<Database>>,
) -> Result<HttpResponse, actix_web::Error> {
    let context = Database {
        users: db.lock().unwrap().users.clone(),
    };
    graphql_handler(&schema, &context, req, payload).await
}

async fn playground_route() -> Result<HttpResponse, actix_web::Error> {
    playground_handler("/graphql", None).await
}

#[actix_web::