Node.js und GraphQL: Eine optimale Wahl für REST-freie APIs

In der Welt der Softwareentwicklung gibt es mehrere Ansätze, um APIs zu implementieren. Einer der beliebtesten Ansätze ist die Erstellung von REST (Representational State of Resource)-APIs. Doch was ist mit den Vor- und Nachteilen dieser Art von API-Design? Und gibt es alternative Ansätze, wie zum Beispiel GraphQL, das als optimaler Ersatz für REST-APIs angesehen wird?

In diesem Artikel werden wir uns mit der Frage befassen, ob Node.js und GraphQL eine optimale Wahl für die Erstellung von REST-freien APIs sind.

Was ist ein REST-Api

Ein REST-Api (Representational State of Resource) ist ein Standard für das Design von APIs, der ursprünglich von Roy Fielding entwickelt wurde. Die Grundidee eines REST-apis besteht darin, die Ressourcen, die im System verfügbar sind, als Objekte zu modellieren und diese Objekte über HTTP-Anfragen abzurufen.

Ein typisches Beispiel für ein REST-Api ist eine API, die Zugriff auf eine Datenbank bietet. Ein Benutzer kann die API verwenden, um bestimmte Ressourcen wie Kunden, Bestellungen oder Artikel zu erstellen, zu lesen, zu aktualisieren oder zu löschen.

Vorteile von REST-APIs

REST-APIs haben mehrere Vorteile:

• Skalierbarkeit: Durch die Verwendung von HTTP-Anfragen kann ein REST-Api leicht skaliert werden, indem mehr Server hinzugefügt werden.
• Konsistenz: Alle Clientanwendungen müssen sich an einen bestimmten Standard halten und diese Vorteile entfalten sich natürlich.
• Die meisten Webservern sind so aufgebaut, dass sie HTTP-Anfragen unterstützen.

Nachteile von REST-APIs

Die Hauptvorteile eines REST-Designs sind jedoch auch die größten Nachteile:

• Eine übermäßige Komplexität ist durch die Verwendung von mehreren Konfliktsignalen entstehen, was zu einer großen und komplexen API führt.
• Die Anzahl der Anforderungen in der API muss nicht unbedingt auf die Anzahl der Endpunkte abgestimmt sein, die ein Benutzer an eine bestimmte API heranzustellen gedenkt.
• Rest-Designs sind stark von der HTTP-Version 1.0 abhängig.

Alternativen zu REST-APIs

Es gibt jedoch auch einige Alternativen zu REST-APIs:

• GraphQL: Ein Query Language, das die API-Definition in einem einzigen Codeblock zusammenfasst und es ermöglicht, auf einzelne Felder zuzugreifen.
• gRPC: Eine Kommunikationsbibliothek der Google-Gruppe, die für die Entwicklung von REST-freien APIs verwendet werden kann.
• SOAP-WSDL: Ein Standard für die Definition von Web Diensten über XML und HTTP.

Beispiele für Node.js und GraphQL

Hier sind einige Beispiele für Node.js und GraphQL:

Beispiel 1: Ein einfaches GraphQL-Schema

const { gql } = require('apollo-server');

const typeDefs = gql`
  type Person {
    id: ID!
    name: String!
    age: Int
  }

  type Query {
    person(id: ID!): Person
  }
`;

Beispiel 2: Eine einfache GraphQL-Instanzierung

const express = require('express');
const graphqlHTTP = require('express-graphql');

const app = express();

const rootQuery = {
  Person: {
    Query,
  },
};

app.use('/graphql', graphqlHTTP({
  schema: new GraphQLSchema(typeDefs, rootQuery),
}));

Beispiel 3: Ein vollständiges Beispieldbogen

const { gql } = require('apollo-server');

const typeDefs = gql`
  type Person {
    id: ID!
    name: String!
    age: Int
  }

  type Query {
    person(id: ID!): Person
    persons: [Person]
  }

  type Mutation {
    createPerson(name: String!, age: Int!): Person
  }
`;

const resolvers = {
  Query: {
    person: (parent, args) => {
      const { id } = args;
      return { id, name: 'John Doe', age: 30 };
    },
    persons: () => [
      { id: 1, name: 'John Doe', age: 30 },
      { id: 2, name: 'Jane Doe', age: 25 },
    ],
  },
  Mutation: {
    createPerson: (parent, args) => {
      const { name, age } = args;
      return { id: 3, name, age };
    },
  },
};

const schema = new GraphQLSchema(typeDefs, resolvers);

Beispiel 4: Die Verwendung von Apollo Client

import React from 'react';
import { ApolloClient, InMemoryCache, gql } from '@apollo/client';

const typeDefs = gql`
  query GetPerson {
    person(id: "1") {
      name
      age
    }
  }

`;

const client = new ApolloClient({
  uri: process.envGRAPHQL_URL,
  cache: new InMemoryCache(),
});

function App() {
  const [data, setData] = React.useState(null);

  const fetchPerson = () => {
    client.query({ query: typeDefs }).then((response) => {
      setData(response.data.person);
    });
  };

  return (
    <div>
      <button onClick={fetchPerson}>Fetch Person</button>
      {data && <p>Name: {data.name}, Age: {data.age}</p>}
    </div>
  );
}

export default App;