Что такое propagation level в Spring Data

1️⃣ Как кратко ответить

Propagation level в Spring Data определяет, как транзакции должны распространяться в методах, вызываемых в рамках существующих транзакций. Это позволяет контролировать, будет ли новый метод выполняться в рамках текущей транзакции, в новой транзакции или без транзакции. Основные уровни включают REQUIRED, REQUIRES_NEW, SUPPORTS, NOT_SUPPORTED, MANDATORY, NEVER и NESTED.

2️⃣ Подробное объяснение темы

В Spring Data, как и в Spring Framework в целом, управление транзакциями является важной частью работы с базами данных. Транзакции обеспечивают целостность данных, гарантируя, что все операции в рамках транзакции будут выполнены успешно или ни одна из них не будет применена. Propagation level определяет, как транзакции должны вести себя в отношении существующих транзакций, когда метод, аннотированный @Transactional, вызывается в контексте другой транзакции.

Основные уровни распространения (Propagation Levels)

1. REQUIRED: Это значение по умолчанию. Если существует текущая транзакция, метод будет выполнен в её контексте. Если транзакции нет, будет создана новая. Это наиболее часто используемый уровень, так как он обеспечивает простую и предсказуемую модель транзакций.

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

3. SUPPORTS: Если существует текущая транзакция, метод будет выполнен в её контексте. Если транзакции нет, метод будет выполнен без транзакции. Это позволяет методам работать как в транзакционном, так и в нетранзакционном контексте.

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

5. MANDATORY: Требует существования текущей транзакции. Если транзакции нет, будет выброшено исключение. Это гарантирует, что метод всегда будет выполняться в транзакционном контексте.

6. NEVER: Метод никогда не должен выполняться в транзакционном контексте. Если существует текущая транзакция, будет выброшено исключение. Это используется для методов, которые не должны быть частью транзакции.

7. NESTED: Если существует текущая транзакция, метод будет выполнен в её контексте, но в рамках отдельной вложенной транзакции. Если транзакции нет, будет создана новая. Это полезно для сложных операций, где необходимо иметь возможность откатить часть транзакции без отката всей транзакции.

Пример использования

Рассмотрим пример, где используется REQUIRES_NEW для выполнения операции, которая должна быть независимой от основной транзакции:

@Service
public class OrderService {
​
    @Autowired
    private PaymentService paymentService;
​
    @Transactional
    public void processOrder(Order order) {
        // Основная транзакция начинается здесь
        saveOrder(order); // Сохраняем заказ в базе данных
​
        // Платеж должен быть обработан в отдельной транзакции
        paymentService.processPayment(order.getPayment());
    }
​
    private void saveOrder(Order order) {
        // Логика сохранения заказа
    }
}
​
@Service
public class PaymentService {
​
    @Transactional(propagation = Propagation.REQUIRES_NEW)
    public void processPayment(Payment payment) {
        // Эта операция выполняется в новой транзакции
        // Логика обработки платежа
    }
}

• В OrderService.processOrder начинается основная транзакция.
• saveOrder выполняется в контексте этой транзакции.
• PaymentService.processPayment аннотирован с @Transactional(propagation = Propagation.REQUIRES_NEW), что означает, что он будет выполняться в новой транзакции, независимо от основной транзакции.
• Это позволяет обработать платеж отдельно, что может быть полезно, если, например, необходимо гарантировать, что платеж будет обработан даже если сохранение заказа не удастся.

Таким образом, propagation level предоставляет гибкость в управлении транзакциями, позволяя разработчикам точно контролировать, как и когда транзакции должны начинаться и завершаться в сложных сценариях.