Транзакции

В Citeck реализованы транзакции на базе двухфазного коммита.

Описание сущностей:

Термин

Описание

Транзакционный ресурс

Ресурс, который поддерживает работу с транзакциями (например, база данных).

Транзакционное действие

Действие, которое привязывается к жизненному циклу транзакции и выполняется в одном из трёх случаев: перед коммитом, после коммита, после отката транзакции.

Транзакция

Сущность, в рамках которой можно регистрировать транзакционные ресурсы и действия. Если в ходе транзакции происходит ошибка, то транзакция откатывается и система возвращается к состоянию до начала транзакции.

Транзакционный менеджер

Менеджер, который управляет транзакциями.

Жизненный цикл транзакции:

../../_images/auth-ecos-proxy-app.drawio.png

Общая схема работы:

../../_images/transaction-flow.drawio.png
Описание работы
  1. Транзакция начинается.

  2. В ходе работы идёт работа с ресурсами, которые регистрируются в транзакции.

  3. Также в ходе работы возникают действия, которые нужно выполнить перед коммитом, после коммита или после отката транзакции.

  4. Перед коммитом выполняются все транзакционные действия, зарегистрированные в транзакции.

  5. Перед коммитом проверяется количество ресурсов. Если ресурс один, выполняется однофазный коммит. Если ресурсов несколько, выполняется подготовка к коммиту и коммит подготовленной транзакции.

  6. После коммита выполняются все транзакционные действия, зарегистрированные в транзакции.

  7. Если что-то пошло не так в ходе транзакции, все ресурсы откатываются к исходному состоянию и выполняются действия после отката, которые успели зарегистрироваться в ходе транзакции.

Работа с транзакциями:

val result = TxnContext.doInTxn {
    "выполняем нужные действия и возвращаем результат"
}
String result = TxnContext.doInTxnJ(() -> {
    return "выполняем нужные действия и возвращаем результат";
});

Данные методы создают транзакцию, если её нет, или используют существующую. Если требуется принудительно выполнить действие в новой транзакции, следует использовать методы doInNewTxn и doInNewTxnJ соответственно.

Для Records API транзакции запускаются автоматически в момент, когда приходит запрос извне приложения.