Какой метод идемпотентный: GET или POST?

HTTP методы: идемпотентность GET vs POST

GET — это идемпотентный HTTP метод. POST — это неидемпотентный метод. Понимание этой разницы критично для разработки надёжных REST API и веб-приложений на Java.

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

Идемпотентность — это свойство операции, при котором повторное её выполнение дает тот же результат, что и первый раз. Математический пример: f(f(x)) = f(x).

В контексте HTTP:

• Идемпотентный метод — несколько идентичных запросов дают одинаковый результат
• Не идемпотентный метод — повторные запросы могут изменить состояние

GET — идемпотентный метод

GET — это безопасный метод, который ВСЕГДА должен быть идемпотентным:

@RestController
@RequestMapping("/api/users")
public class UserController {
    
    @GetMapping("/{id}")
    public ResponseEntity<User> getUser(@PathVariable Long id) {
        // Три одинаковых запроса вернут одинаковый результат
        // GET /api/users/1 → User(id=1, name="Alice")
        // GET /api/users/1 → User(id=1, name="Alice")
        // GET /api/users/1 → User(id=1, name="Alice")
        
        User user = userService.findById(id);
        return ResponseEntity.ok(user);
    }
}

Характеристики GET:

• Не изменяет состояние сервера
• Безопасен для повторного выполнения
• Результат кэшируется браузерами и прокси
• Параметры передаются в URL

POST — не идемпотентный метод

POST — это метод, который может изменять состояние на сервере. Повторное его выполнение может дать РАЗНЫЙ результат:

@RestController
@RequestMapping("/api/users")
public class UserController {
    
    @PostMapping
    public ResponseEntity<User> createUser(@RequestBody CreateUserRequest request) {
        // Первый POST запрос → создан User с id=1
        // Второй POST запрос → создан User с id=2 (другой результат!)
        // Третий POST запрос → создан User с id=3
        
        User newUser = userService.create(request);
        return ResponseEntity.status(HttpStatus.CREATED).body(newUser);
    }
}

Характеристики POST:

• Может изменять состояние сервера
• Не безопасен для повторного выполнения
• Результат НЕ кэшируется
• Параметры передаются в теле запроса

Практические примеры проблем

Проблема 1: Двойная отправка формы

@PostMapping("/transfer")
public ResponseEntity<String> transferMoney(
        @RequestParam Long fromAccount,
        @RequestParam Long toAccount,
        @RequestParam BigDecimal amount) {
    
    // Пользователь отправил форму
    // Деньги переведены
    // Браузер перезагрузился и отправил ещё раз
    // Деньги переведены ещё раз! (проблема идемпотентности)
    
    accountService.transfer(fromAccount, toAccount, amount);
    return ResponseEntity.ok("Успешный перевод");
}

Решение: использование GET для запросов чтения

@GetMapping("/accounts/{id}/balance")
public ResponseEntity<BigDecimal> getBalance(@PathVariable Long id) {
    // Можешь вызвать 100 раз — результат одинаковый
    BigDecimal balance = accountService.getBalance(id);
    return ResponseEntity.ok(balance);
}

Правила для других HTTP методов

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

@RestController
@RequestMapping("/api/products")
public class ProductController {
    
    // GET — идемпотентный, для чтения
    @GetMapping("/{id}")
    public ResponseEntity<Product> getProduct(@PathVariable Long id) {
        return ResponseEntity.ok(productService.findById(id));
    }
    
    // POST — не идемпотентный, для создания
    @PostMapping
    public ResponseEntity<Product> createProduct(@RequestBody ProductRequest request) {
        Product product = productService.create(request);
        return ResponseEntity.status(HttpStatus.CREATED).body(product);
    }
    
    // PUT — идемпотентный, для полного обновления
    @PutMapping("/{id}")
    public ResponseEntity<Product> updateProduct(
            @PathVariable Long id,
            @RequestBody ProductRequest request) {
        Product updated = productService.update(id, request);
        return ResponseEntity.ok(updated);
    }
    
    // DELETE — идемпотентный, для удаления
    @DeleteMapping("/{id}")
    public ResponseEntity<Void> deleteProduct(@PathVariable Long id) {
        productService.delete(id);
        return ResponseEntity.noContent().build();
    }
}

Обеспечение идемпотентности для POST

Если нужно сделать POST идемпотентным, используй Idempotency Key:

@PostMapping
public ResponseEntity<Order> createOrder(
        @RequestBody OrderRequest request,
        @RequestHeader("Idempotency-Key") String idempotencyKey) {
    
    // Проверяем, не обрабатывали ли уже этот ключ
    Order existingOrder = orderService.findByIdempotencyKey(idempotencyKey);
    if (existingOrder != null) {
        return ResponseEntity.ok(existingOrder);
    }
    
    // Создаём новый заказ
    Order order = orderService.create(request, idempotencyKey);
    return ResponseEntity.status(HttpStatus.CREATED).body(order);
}

Заключение

GET — идемпотентный метод, безопасен для повторного выполнения. POST — неидемпотентный, каждое выполнение может изменить состояние. Правильный выбор метода критичен для надёжности системы, особенно при нестабильном сетевом соединении.