Files
mtusi2026lab4/app/idempotency.py
T
2026-10-30 22:16:54 +03:00

67 lines
3.1 KiB
Python

"""Логика идемпотентности для POST запросов."""
import hashlib
import json
from .errors import ApiError, bad_request
def get_request_hash(data: dict) -> str:
"""Хеш тела запроса, независимый от порядка ключей."""
return hashlib.sha256(json.dumps(data, sort_keys=True).encode("utf-8")).hexdigest()
def check_and_lock(conn, user_id: str, method: str, path: str, key: str, req_hash: str):
"""
Блокирует ключ идемпотентности через advisory lock в PostgreSQL.
"""
if not key:
raise bad_request("Missing Idempotency-Key")
if not isinstance(key, str) or not (1 <= len(key) <= 128):
raise bad_request("Invalid Idempotency-Key format")
# Берем блокировку на уровне БД по хешу ключа.
lock_id = f"{user_id}:{method}:{path}:{key}"
conn.execute("SELECT pg_advisory_xact_lock(hashtext(%s))", (lock_id,))
# Проверяем, есть ли уже такой ключ
row = conn.execute("""
SELECT request_hash, status_code, response_body
FROM idempotency_keys
WHERE user_id = %s AND method = %s AND path = %s AND key = %s
""", (user_id, method, path, key)).fetchone()
if row:
# Ключ уже существует
if row["request_hash"] != req_hash:
raise ApiError(409, "conflict", "Idempotency-Key conflict: body differs")
# Если запрос уже был успешно обработан, возвращаем сохраненный ответ
if row["status_code"] is not None and row["response_body"] is not None:
return False, json.loads(row["response_body"])
# Если status_code пустой, значит первая транзакция упала. Разрешаем перезапись.
return True, None
return True, None
def save_result(conn, user_id: str, method: str, path: str, key: str, req_hash: str, status_code: int, response_body: dict):
"""Сохраняет результат выполнения запроса для будущих повторных вызовов."""
conn.execute("""
INSERT INTO idempotency_keys (user_id, method, path, key, request_hash, status_code, response_body)
VALUES (%s, %s, %s, %s, %s, %s, %s)
ON CONFLICT (user_id, method, path, key) DO UPDATE
SET status_code = EXCLUDED.status_code, response_body = EXCLUDED.response_body
""", (user_id, method, path, key, req_hash, status_code, json.dumps(response_body)))
def cleanup(conn, ttl_seconds: int):
"""Оппортунистическая очистка старых ключей (через подзапрос, т.к. DELETE LIMIT в PG нет)."""
conn.execute("""
DELETE FROM idempotency_keys
WHERE (user_id, method, path, key) IN (
SELECT user_id, method, path, key
FROM idempotency_keys
WHERE created_at < now() - make_interval(secs => %s)
LIMIT 100
)
""", (ttl_seconds,))