Hoe kan GraphQL worden geïntegreerd in een hexagonale architectuur?

In de hexagonale architectuur kan GraphQL fungeren als een poort, die de interactie tussen de externe omgeving en de kern van de toepassing faciliteert. Het kan worden geïmplementeerd als:

1. Inkomende Adapter: De GraphQL API ontvangt verzoeken van clients (frontend, andere services), transformeert ze en roept de bijbehorende domeinservices aan ("poorten" van de kern) om de bedrijfslogica uit te voeren. De resultaten van de domeinservices worden vervolgens geaggregeerd en in GraphQL-formaat geretourneerd.

2. Uitgaande Adapter (minder typisch): In sommige gevallen kan GraphQL worden gebruikt om te integreren met externe services die ook een GraphQL API bieden. In dat geval roept de GraphQL-client uit de kern van de toepassing ("poort") de externe service aan via de adapter.

De integratie wordt bereikt door het implementeren van de laag van GraphQL-resolvers. Deze resolvers dienen als een "brug" tussen het GraphQL-schema en de domeinobjecten/-services van de kern.

// Voorbeeld van een GraphQL-resolver in Node.js
const resolvers = {
  Query: {
    getUser: async (parent, { id }, { domainServices }) => {
      // Aanroep van de domeinservice via de "poort"
      const user = await domainServices.userService.findUserById(id);
      return user;
    },
  },
  Mutation: {
    createUser: async (parent, { input }, { domainServices }) => {
      // Aanroep van de domeinservice om de bedrijfslogica uit te voeren
      const newUser = await domainServices.userService.createUser(input);
      return newUser;
    },
  },
};

Voordelen van deze aanpak:

• Isolatie: De GraphQL API kan worden gewijzigd zonder invloed op de bedrijfslogica in de kern.
• Testbaarheid: Domeinservices kunnen onafhankelijk van de GraphQL-laag worden getest.
• Flexibiliteit: Het is gemakkelijker om technologieën te wijzigen op het niveau van "poorten" zonder de kern aan te tasten.

Op deze manier wordt GraphQL een van de "gevels" waarmee externe consumenten interageren met een geïsoleerde en goed gestructureerde kern van de toepassing.