Что такое адаптер в гексагональной архитектуре

Адаптер в гексагональной архитектуре — это слой, который преобразует внешние запросы или данные в формат, понятный ядру приложения (domain), и наоборот. Он изолирует бизнес-логику от внешних интерфейсов (UI, БД, API и т.д.).

Типы адаптеров:

1. Первичные (входные) — преобразуют внешние запросы (HTTP, CLI) в вызовы ядра.
2. Вторичные (выходные) — адаптируют ядро к внешним сервисам (БД, сторонние API).

Пример (выходной адаптер для БД):

class DatabaseAdapter:
    def __init__(self, db_client):
        self.db = db_client

    def save_user(self, user: User) -> None:
        # Преобразуем доменный объект в формат БД
        db_data = {"id": user.id, "name": user.name}
        self.db.insert("users", db_data)

Адаптеры обеспечивают гибкость: замена БД или API требует изменений только в адаптере, а не в ядре.