# Блокировки как средство управления параллелизмом

<span style="font-weight: 400;">Управление блокировками является центральной концепцией в контексте многопользовательских систем при совместном, параллельном использовании ресурсов несколькими пользователями, точнее - параллельными процессами. Для построения правильной архитектуры параллельных процессов очень важно понимать основные принципы работы блокировок, чтобы не допускать распространенных ошибок.  
</span>

<span style="font-weight: 400;">Мы не будем приводить подробное описание принципа работы блокировок, тк такие статьи можно с легкостью найти в интернете, но для тех кто в этом совсем новичок, приведем список статей, которые имеет смысл изучить, хотя-бы поверхностно:</span>

<table border="1" id="bkmrk-%D0%A1%D0%BE%D1%81%D1%82%D0%BE%D1%8F%D0%BD%D0%B8%D0%B5-%D0%B3%D0%BE%D0%BD%D0%BA%D0%B8-%28rac" style="border-collapse: collapse; width: 100.001%;"><tbody><tr><td class="align-center" style="width: 99.91%;">[<span style="font-weight: 400;">Состояние гонки (Race Condition)</span>](https://ru.wikipedia.org/wiki/%D0%A1%D0%BE%D1%81%D1%82%D0%BE%D1%8F%D0%BD%D0%B8%D0%B5_%D0%B3%D0%BE%D0%BD%D0%BA%D0%B8)</td></tr><tr><td class="align-center" style="width: 99.91%;">[<span style="font-weight: 400;">Взаимная блокировка (Deadlock)</span>](https://ru.wikipedia.org/wiki/%D0%92%D0%B7%D0%B0%D0%B8%D0%BC%D0%BD%D0%B0%D1%8F_%D0%B1%D0%BB%D0%BE%D0%BA%D0%B8%D1%80%D0%BE%D0%B2%D0%BA%D0%B0)</td></tr><tr><td class="align-center" style="width: 99.91%;">[<span style="font-weight: 400;">Атомарная операция (Atomic Operation)</span>](https://ru.wikipedia.org/wiki/%D0%90%D1%82%D0%BE%D0%BC%D0%B0%D1%80%D0%BD%D0%B0%D1%8F_%D0%BE%D0%BF%D0%B5%D1%80%D0%B0%D1%86%D0%B8%D1%8F)</td></tr><tr><td class="align-center" style="width: 99.91%;"><span style="font-weight: 400;">[Параллельные вычисления](https://ru.wikipedia.org/wiki/%D0%9F%D0%B0%D1%80%D0%B0%D0%BB%D0%BB%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5_%D0%B2%D1%8B%D1%87%D0%B8%D1%81%D0%BB%D0%B5%D0%BD%D0%B8%D1%8F)</span></td></tr><tr><td class="align-center" style="width: 99.91%;"><span style="font-weight: 400;">[Распределённый менеджер блокировок](https://ru.wikipedia.org/wiki/%D0%A0%D0%B0%D1%81%D0%BF%D1%80%D0%B5%D0%B4%D0%B5%D0%BB%D1%91%D0%BD%D0%BD%D1%8B%D0%B9_%D0%BC%D0%B5%D0%BD%D0%B5%D0%B4%D0%B6%D0%B5%D1%80_%D0%B1%D0%BB%D0%BE%D0%BA%D0%B8%D1%80%D0%BE%D0%B2%D0%BE%D0%BA)</span></td></tr></tbody></table>

### <span style="font-weight: 400;">Почему блокировки важны для вашего бизнеса</span>

<span style="font-weight: 400;">Не редко случаются ситуации, когда нескольким пользователям в одно и то же время требуется взаимодействие с одними и теми же данными. Например, два пользователя могут одновременно попытаться зарегистрироваться на один и тот же временной слот. Без применения блокировок, в базу данных поступят две заявки на одно и то же время, что приведет к проблемам, особенно если другие временные слоты уже заняты.</span>

<span style="font-weight: 400;">При использовании блокировок вы сможете обеспечить последовательное выполнение операций, запрошенных одновременно, гарантируя таким образом более надежную работу вашего приложения.</span>

<span style="font-weight: 400;">Приложение Metabot предоставляет различные функции для работы с блокировками в контексте вашего бизнеса или конкретного бота. </span>Например, функции получения блокировки включают в себя проверку блокировки и захват блокировки. Эти две операции является атомарными, т.е. выполняются одномоментно, если блокировка доступна для захвата (т.е. если никакой другой процесс не захватил блокировку на момент проверки). Такая атомарная операция автоматически исключает возникновение <span style="font-weight: 400;">состояния гонки (Race Condition).</span>

Чтобы не возникло взаимной блокировки, предусмотрено указание времени жизни блокировки (time to leave) в параметрах функций захвата блокировки (см параметр ttlSec).

Также, для упрощения работы с блокировками, в функции захвата встроены алгоритмы, позволяющие автоматически выполнять повторную попытку захвата блокировки на протяжении указанного промежутка времени (см параметр maxWaitSec).

<span style="font-weight: 400;">Все это может быть особенно полезно во многих сценариях, в которых важно обеспечить согласованность и предотвратить конкурирующие операции.</span>

<p class="callout warning"><span style="font-weight: 400;">**ВНИМАНИЕ!!!** Будьте очень аккуратны при использовании функций блокировок, неправильное использование может нарушить работоспособность всей системы! Ваш бот может быть внесен в черный список а все вебхуки и задания бота будут исключаться из очередей!</span></p>

<p class="callout info"><span style="font-weight: 400;">Подробное описание назначения блокировок с описанием примеров смотрите в статье про блокировки в нашем блоге. **ДОБАВИТЬ ССЫЛКУ!**</span></p>

### <span style="font-weight: 400;">Методы блокировок в Metabot</span>

<span style="font-weight: 400;">Приложение Metabot предлагает ряд методов, которые помогают управлять блокировками.</span>

<p class="callout warning"><span style="font-weight: 400;">Все перечисленные ниже методы вам не нужны, если вы используете стандартные функции связанные с контакт-центром: lead.**assignDialogToNextOperator**, lead.**assignDialogToOperator** или lead.**getNextOperators** и т.д., так как данные функции уже включают в себя алгоритмы блокировок.</span></p>

#### <span style="font-weight: 400;">Методы генерации имени блокировок</span>

<span style="font-weight: 400;">Использование на данный момент смысла не имеет, функции блокировок сами добавляют дополнительные префиксы к именами блокировок указанным в аргументах функций.</span>

<table border="1" id="bkmrk-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-bot.g" style="border-collapse: collapse; width: 100.001%; height: 522.5px;"><tbody><tr style="background-color: #c2e0f4; height: 29.537px;"><td style="width: 49.9543%; height: 29.537px;">Метод</td><td style="width: 49.9557%; height: 29.537px;">Описание</td></tr><tr style="height: 46.3426px;"><td style="width: 49.9543%; height: 46.3426px;">bot.**getLockNameForBot**(string $lockName, string $lockPrefix = ''): **string**</td><td style="width: 49.9557%; height: 46.3426px;">Генерирует имя блокировки по боту</td></tr><tr style="height: 46.3426px;"><td style="width: 49.9543%; height: 46.3426px;">bot.**getLockNameForBusiness**(string $lockName, string $lockPrefix = ''): **string**</td><td style="width: 49.9557%; height: 46.3426px;">Генерирует имя блокировки по бизнесу</td></tr></tbody></table>

#### <span style="font-weight: 400;">Методы </span><span style="font-weight: 400;">перехвата блокировок</span>

<span style="font-weight: 400;">Данные методы позволяют дождаться, когда блокировка будет освобождена, и затем захватить ее. Это может быть полезно, чтобы обеспечить выполнение операции только одним процессом в определенный момент времени.</span>

<table border="1" id="bkmrk-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-bot.w" style="border-collapse: collapse; width: 100.001%; height: 522.5px;"><tbody><tr style="background-color: #c2e0f4; height: 29.537px;"><td style="width: 49.9543%; height: 29.537px;">Метод</td><td style="width: 49.9557%; height: 29.537px;">Описание</td></tr><tr style="height: 46.3426px;"><td style="width: 49.9543%; height: 46.3426px;">bot.**waitForBusinessLock**(string $lockName, string $lockPrefix = '', ?int $ttlSec = null, $maxWaitSec = 300): **bool**</td><td style="width: 49.9557%; height: 46.3426px;">Захватывает блокировку по бизнесу

</td></tr><tr style="height: 46.3426px;"><td style="width: 49.9543%; height: 46.3426px;">bot.**waitForBotLock**(string $lockName, string $lockPrefix = '', ?int $ttlSec = null, $maxWaitSec = 300): **bool**</td><td style="width: 49.9557%; height: 46.3426px;">Захватывает блокировку по боту

</td></tr></tbody></table>

<p class="callout warning">Если нет понимания что указать в параметре ttlSec, укажите значение равное 30 (это значит что блокировка будет автоматически удалена спустя 30 секунд, если вы забыли это сделать в коде), это необходимо, чтобы не возникло взаимной блокировки, если же вы указываете время жизни равное 0, то блокировка не ограничена по времени, но в таком случае нужно подходить к алгоритмам еще тщательнее, чтобы не забывать освобождать блокировку.</p>

#### <span style="font-weight: 400;">Методы </span><span style="font-weight: 400;">удаления блокировок</span>

<span style="font-weight: 400;">Данные методы позволяют освобождать различные виды блокировок. Какие именно из этих методов использовать зависит от того, была ли блокировка создана в текущем скрипте или нет, и нужно ли вам принудительно освободить блокировку.</span>

<table border="1" id="bkmrk-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-bot.r" style="border-collapse: collapse; width: 100.001%; height: 281.481px;"><tbody><tr style="background-color: #c2e0f4; height: 29.537px;"><td style="width: 49.9543%; height: 29.537px;">Метод</td><td style="width: 49.9557%; height: 29.537px;">Описание</td></tr><tr style="height: 48.0556px;"><td style="width: 49.9543%; height: 48.0556px;">bot.**releaseAllCurrentLocks**(): **bool**</td><td style="width: 49.9557%; height: 48.0556px;">Освобождает все блокировки захваченные в текущем скрипте</td></tr><tr style="height: 64.8611px;"><td style="width: 49.9543%; height: 64.8611px;">bot.**releaseCurrentLockForBusiness**(string $lockName, string $lockPrefix = ''): **bool**</td><td style="width: 49.9557%; height: 64.8611px;">Освобождает блокировку захваченную текущем скрипте по бизнесу</td></tr><tr style="height: 46.3426px;"><td style="width: 49.9543%; height: 46.3426px;">bot.**releaseCurrentLockForBot**(string $lockName, string $lockPrefix = ''): **bool**</td><td style="width: 49.9557%; height: 46.3426px;">Освобождает блокировку захваченную в текущем скрипте по боту</td></tr><tr style="height: 46.3426px;"><td style="width: 49.9543%; height: 46.3426px;">bot.**releaseLockForBusiness**(string $lockName, string $lockPrefix = ''): **bool**</td><td style="width: 49.9557%; height: 46.3426px;">Освобождает блокировку по бизнесу</td></tr><tr style="height: 46.3426px;"><td style="width: 49.9543%; height: 46.3426px;">bot.**releaseLockForBot**(string $lockName, string $lockPrefix = ''): **bool**</td><td style="width: 49.9557%; height: 46.3426px;">Освобождает блокировку по боту</td></tr></tbody></table>

#### <span style="font-weight: 400;">Методы </span><span style="font-weight: 400;">проверки наличия блокировок</span>

<span style="font-weight: 400;">Данные методы позволяют проверить наличие блокировок. Они помогут определить, должен ли ваш скрипт ожидать освобождения блокировки или может продолжить работу.</span>

<table border="1" id="bkmrk-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-bot.h" style="border-collapse: collapse; width: 100.001%; height: 522.5px;"><tbody><tr style="background-color: #c2e0f4; height: 29.537px;"><td style="width: 49.9543%; height: 29.537px;">Метод</td><td style="width: 49.9557%; height: 29.537px;">Описание</td></tr><tr style="height: 46.3426px;"><td style="width: 49.9543%; height: 46.3426px;">bot.**hasLockForBusiness**(string $lockName, string $lockPrefix = '', $checkValue = null): **bool**</td><td style="width: 49.9557%; height: 46.3426px;">Проверяет существование блокировки по бизнесу</td></tr><tr style="height: 46.3426px;"><td style="width: 49.9543%; height: 46.3426px;">bot.**hasLockForBot**(string $lockName, string $lockPrefix = '', $checkValue = null): **bool**</td><td style="width: 49.9557%; height: 46.3426px;">Проверяет существование блокировки по боту</td></tr></tbody></table>

<span style="font-weight: 400;">Все эти методы обеспечивают гибкость при работе с блокировками в вашем приложении Metabot. С их помощью вы можете создавать более надежные и эффективные бизнес-процессы.</span>

<p class="callout info align-left"><span style="font-weight: 400;">Подробнее методы перечисленные выше и примеры к ним вы можете изучить в [**Справочнике по функциям JS**](https://docs.metabot24.ru/books/7-spravocnik-po-funkciyam-js/page/spravocnik-vsex-funkcii-Cgt "Справочник всех функций")</span></p>

<p class="callout warning"><span style="font-weight: 400;">**ВНИМАНИЕ!!!** Если у вас нет понимания как пользоваться функциями блокировок, то лучше не экспериментировать и обратиться к нашим специалистам!</span></p>