Jak může být GraphQL integrován do hexagonální architektury?

V hexagonální architektuře může GraphQL hrát roli brány, která usnadňuje interakci mezi vnějším prostředím a jádrem aplikace. Může být implementována jako:

1. Příchozí adaptér: GraphQL API přijímá požadavky od klientů (frontend, jiné služby), transformuje je a volá příslušné doménové služby ("porty" jádra) k provedení obchodní logiky. Výsledky doménových služeb jsou následně agregovány a vráceny ve formátu GraphQL.

2. Odchozí adaptér (méně typický): V některých případech může být GraphQL použit pro integraci s externími službami, které také poskytují GraphQL API. V takovém případě bude klient GraphQL z jádra aplikace ("port") volat externí službu přes adaptér.

Integrace je dosažena implementací vrstvy resolverů GraphQL. Tyto resolvery slouží jako "most" mezi schématem GraphQL a doménovými objekty/službami jádra.

// Příklad resolveru GraphQL v Node.js
const resolvers = {
  Query: {
    getUser: async (parent, { id }, { domainServices }) => {
      // Volání doménové služby přes "port"
      const user = await domainServices.userService.findUserById(id);
      return user;
    },
  },
  Mutation: {
    createUser: async (parent, { input }, { domainServices }) => {
      // Volání doménové služby pro provedení obchodní logiky
      const newUser = await domainServices.userService.createUser(input);
      return newUser;
    },
  },
};

Výhody tohoto přístupu:

• Izolace: GraphQL API může být měněno bez vlivu na obchodní logiku jádra.
• Testovatelnost: Doménové služby mohou být testovány nezávisle na vrstvě GraphQL.
• Flexibilita: Je snazší měnit technologie na úrovni "portů" bez ovlivnění jádra.

Tímto způsobem se GraphQL stává jedním z "fasád", přes které externí spotřebitelé komunikují s izolovaným a dobře strukturovaným jádrem aplikace.