Конкурентная запись и завершение операций
Единица блокировки
Altera содержит общий для серверного процесса реестр WRITES. Ключ блокировки — полный путь модуля, например /backend3/hostname.
Ниже показаны тела ответов и событий. В Unix-соединении и на веб-маршруте /ws они обёрнуты путём модуля, на фиксированном веб-маршруте передаются без обёртки.
После разрешения операции с именем write Altera пытается захватить блокировку. Если другой экземпляр того же модуля уже пишет:
{"type":"woo-error","code":"busy","message":"Module is busy writing"}
При успешном захвате подписчики модуля получают:
{"altera":"write_state","busy":true}
После завершения:
{"altera":"write_state","busy":false}
При подключении к модулю передаётся и начальный снимок его состояния.
Последовательность выполнения
Клиент: write
↓
Проверка разрешения
↓ Allow
Подготовка сообщения
↓
Захват блокировки WRITES для пути модуля
├─ Модуль занят → woo-error/busy
└─ Блокировка получена
↓
Уведомление write_state: busy=true
↓
Запрос в stdin backend
↓
Данные ответа → клиент
↓
Завершение операции
↓
Освобождение блокировки
↓
Уведомление write_state: busy=false
Эта схема отражает логические зависимости, а не обещание строгого порядка доставки всех событий между разными соединениями: уведомления распространяются отдельным broadcast-каналом.
Что блокировка гарантирует и чего не гарантирует
Она предотвращает одновременный допуск двух и более write к одному пути модуля от нескольких соединений в рамках одного процесса Altera.
Она не блокирует другие модули/пути бекенда или стороннюю утилиту, редактирующие тот же файл, и не охватывает другой экземпляр сервера. read/list из других соединений не получают аналогичную эксклюзивную блокировку.
Поэтому модуль должен сам обеспечивать целостность своих данных, корректно называть изменяющие действия и не объявлять завершение раньше, чем закончены его изменения. Нельзя запускать изменение «в фоне», сразу выводить _message:end и считать файл защищённым до завершения фонового процесса.
Если корректное завершение/очистка не подтверждены, WriteGuard не освобождает блокировку, и модуль может остаться занятым до перезапуска основной службы Altera.