Ako môže byť GraphQL integrovaný do šesťuholníkovej architektúry?

V hexagonálnej architektúre môže GraphQL hrať úlohu brány, ktorá uľahčuje interakciu medzi vonkajším prostredím a jadrom aplikácie. Môže byť implementovaná ako:

1. Vstupný adaptér: GraphQL API prijíma požiadavky od klientov (frontend, iné služby), ich transformuje a volá príslušné doménové služby ("porty" jadra) na vykonanie obchodnej logiky. Výsledky doménových služieb sa agregujú a vracajú vo formáte GraphQL.

2. Výstupný adaptér (menej typický): V niektorých prípadoch môže byť GraphQL použitý na integráciu s externými službami, ktoré tiež poskytujú GraphQL API. V takom prípade bude klient GraphQL z jadra aplikácie ("port") volať externú službu cez adaptér.

Integrácia sa dosahuje implementáciou vrstvy resolverov GraphQL. Títo resolveri slúžia ako "most" medzi schémou GraphQL a doménovými objektmi/službami jadra.

// Príklad resolvera GraphQL v Node.js
const resolvers = {
  Query: {
    getUser: async (parent, { id }, { domainServices }) => {
      // Volanie doménovej služby cez "port"
      const user = await domainServices.userService.findUserById(id);
      return user;
    },
  },
  Mutation: {
    createUser: async (parent, { input }, { domainServices }) => {
      // Volanie doménovej služby na vykonanie obchodnej logiky
      const newUser = await domainServices.userService.createUser(input);
      return newUser;
    },
  },
};

Výhody tohto prístupu:

• Izolácia: GraphQL API sa môže meniť bez ovplyvnenia obchodnej logiky jadra.
• Testovateľnosť: Doménové služby môžu byť testované nezávisle od vrstvy GraphQL.
• Flexibilita: Je jednoduchšie meniť technológie na úrovni "portov" bez ovplyvnenia jadra.

Týmto spôsobom sa GraphQL stáva jednou z "fasád", cez ktoré externí spotrebitelia komunikujú s izolovaným a dobre štruktúrovaným jadrom aplikácie.