Mutationen

Dies ist Teil 3 der Reihe für GraphQL und Adobe Commerce. Mutationen ermöglichen das Speichern, Aktualisieren und Zurückgeben von Werten mithilfe von GraphQL.

Verwandte Videos und Tutorials zu GraphQL in dieser Reihe

Beispiel-Mutation

Jede vollständige API-Spezifikation muss die Möglichkeit bieten, Daten nicht nur abzufragen, sondern auch zu erstellen und zu aktualisieren.

REST unterscheidet zwischen Anforderungen, die Daten ändern, und Anforderungen, die nicht mit dem Anfragetyp oder "Verb"(GET vs. POST oder PUT) übereinstimmen.
Bei Verwendung von GraphQL werden datenmodifizierte Abfragen durch das Schlüsselwort mutation gekennzeichnet, das einem anderen
Stammtyp im Schema, das auf dem Server definiert ist.

Sehen Sie sich diese Beispiel-Mutation an, um einem Benutzer ein Produkt zum Warenkorb hinzuzufügen. (Dies erfordert eine generierte Warenkorb-ID.
für die Sitzung des angemeldeten Kunden oder die Verwendung der createEmptyCart -Mutation.)

mutation doAddToCart(
    $cartId: String!,
    $cartItems: [CartItemInput!]!
) {
    addProductsToCart(
        cartId: $cartId
        cartItems: $cartItems
    ) {
        cart {
            total_quantity
            prices {
                grand_total {
                    value
                }
            }
        }
    }
}

Sie können sich vorstellen, dass die oben genannte Mutation in einer Anfrage zusammen mit dem folgenden Variablenwörterbuch gesendet wird:

{
  "cartId": "{cart-id}",
  "cartItems": [
    {
      "quantity": 1,
      "sku": "VT01-RN-XS"
    }
  ]
}

Und schließlich könnten Sie eine Antwort wie die folgende erhalten:

{
  "data": {
    "addProductsToCart": {
      "cart": {
        "total_quantity": 1,
        "prices": {
          "grand_total": {
            "value": 35.2
          }
        }
      }
    }
  }
}

Beachten Sie vor allem, dass im oben gezeigten Beispiel abgesehen von der Verwendung des Schlüsselworts mutation anstelle von query,
die Syntax mit einer Abfrage identisch ist. Wie bei Abfragen umfasst die Mutation:

Die Teilauswahl der Felder ermöglicht es, die Felder, die Sie zurückgeben möchten, flexibel zu definieren (ausgehend vom Typ, der als
Rückgabewert von addProductsToCart - AddProductsToCartOutput) nach Abschluss der Mutation.

Wie bereits erläutert, beginnen in einem GraphQL-Schema definierte Felder bei Abfragen mit einem Stammtyp (normalerweise als Query bezeichnet). Ebenso
Ein anderer Stammtyp ist für Mutationen vorhanden (normalerweise als Mutation bezeichnet). addProductsToCart ist ein Feld
auf diesem Stammtyp.

Einige weitere Hinweise zum obigen Beispiel:

Nützliche GraphQL-Ressourcen