Введение: что такое XServer и как читать эту книгу

Обзор

Сначала определение в одно предложение:

XServer — однофайловый сервер приложений на C: один исполняемый файл (с встроенными компилятором и рантаймом) плюс один каталог исходников на чистом C — это полное серверное развёртывание с горячей перезагрузкой.

Три ключевых слова в этом предложении соответствуют трём сюжетным линиям книги: одиночный файл (рантайм и инструментарий полностью встроены — том 2 о сборке и поставке), каталог исходников на C (приложение — сами исходники, а не прекомпилированный артефакт — тома 1 и 3 о том, как писать) и горячая перезагрузка (правка кода без простоя — глубокое погружение в томе 4).

1.1 Что такое XServer

Классическая разработка C-сервера — это «написал → скомпилировал → слинковал → развернул бинарник → перезапустил», и каждое бизнес-изменение проходит весь конвейер. XServer сворачивает конвейер в рантайм: на целевую машину вы кладёте каталог исходников как артефакт развёртывания; xs.exe компилирует ваш C-код встроенным компилятором TCC при старте и при каждой горячей перезагрузке в машинный код и исполняет его в процессе.

/* Классический C-сервер */
myapp/  →  конвейер сборки  →  myapp.exe + список зависимостей  →  установка зависимостей  →  перезапуск

/* xs */
myapp/  =  xs.exe (единственный бинарник; компилятор/рантайм/SDK внутри)
        + main.c + modules/ + wwwroot/ + db/ (исходники и есть развёртывание)
        →  скопировал — развернул; правишь исходники — горячая перезагрузка

Это не игрушечное «C как скрипты», а осознанный инженерный компромисс: скрипты — доверенный нативный код, в одном процессе с хостом, вызывающий его 3 030 API xrt по адресу — без накладных расходов интерпретатора и без границы FFI; вызов функции остаётся вызовом функции. Плата — отсутствие песочницы: XServer предназначен для доверенных развёртываний под контролем оператора и не принимает недоверенные сторонние скрипты (граница разбирается в главе 44 тома 5).

Фундамент под XServer — xrt: 310 тысяч строк собственного рантайма (TLS 1.2/1.3, HTTP/1.1, WebSocket, событийный цикл на пяти бэкендах, корутины, отладка памяти). Эта книга не переучивает xrt: где важны основы xrt, блок «Что дальше» в конце главы ссылается на соответствующие главы учебника xrt.

1.2 Сравнение с альтернативами

Разница одной фразой: остальные стеки управляют «средой исполнения» и «вашим кодом» как двумя разными вещами; XServer упаковывает их в один файл, один процесс и один жизненный цикл.

1.3 Дорожная карта книги

• Том 1 (гл. 01–06): ментальная модель и инструментарий. Три ключевые главы — 03 (ментальная модель), 04 (минимальное приложение) и 06 (отладка).
• Том 2 (гл. 07–13): xs.json — единственный интерфейс сборки; каждое поле, ограничение и семантика ошибок.
• Том 3 (гл. 14–25): шаблоны разработки четырёх классов протоколов; выбирайте свои.
• Том 4 (гл. 26–31): горячая перезагрузка от «умею запустить» до «понимаю семантику» — откат, передача состояния, ноль утечек.
• Том 5 (гл. 32–43): система расширений, развёртывание и эксплуатация, границы безопасности и три сквозных проекта.

1.4 Контракт шаблона глав

Все 51 глава следуют единой восьмичастной структуре. Глава 1 превращает шаблон в контракт — любая последующая глава, ему не соответствующая, считается дефектом главы, а не стилевым выбором:

Каждая глава заканчивается двумя фиксированными блоками: API, затронутые в главе (ссылки на справочные страницы книги с числом записей) и что дальше по xrt (ссылки на учебник xrt). У каждого блока кода с меткой «проверено на реальной машине» вывод — настоящий, включая неподделываемые детали: динамические порты и реальные метки времени.

1.5 Маршруты читателей

Частые ошибки

curl http://127.0.0.1:9080/__xs/status
/* ожидание встроенной админ-точки → 404 */

/* Пишите админ-маршруты в своём скрипте:
 * инспекция/перезагрузка — обычные бизнес-маршруты */

Упражнения