Что такое идемпотентность метода?

Идемпотентный метод — это метод, выполнение которого многократно с одинаковыми входными данными приводит к одному и тому же конечному состоянию системы, как после однократного выполнения.

Ключевые аспекты:

• Многократные вызовы не вызывают побочных эффектов, меняющих состояние после первого успешного выполнения.
• Результат выполнения может отличаться (например, ответ 200 OK при первом вызове и 409 Conflict при последующих успешных попытках, если ресурс уже создан).
• Примеры в HTTP: методы GET, HEAD, OPTIONS, PUT, DELETE.
• Пример неидемпотентного метода в HTTP: POST, так как каждый вызов обычно создает новый ресурс или выполняет новую операцию.

// Пример идемпотентного метода
public void setUserStatus(String userId, String status) {
    User user = findUserById(userId);
    if (user != null) {
        user.setStatus(status); // Установка статуса многократно не меняет его, если статус уже такой
        saveUser(user);
    }
}

// Пример неидемпотентного метода
public void createUser(User user) {
    // Каждый вызов создаст нового пользователя, если не предусмотрена проверка
    saveNewUser(user);
}

Важно для надежности распределенных систем, повторных попыток и кэширования.