Mutationen

Dies ist Teil 3 der Serie für GraphQL und Adobe Commerce. Mutationen sind die Möglichkeit, Werte mithilfe von GraphQL zu speichern, zu aktualisieren und zurückzugeben.

Verwandte Videos und Tutorials zu GraphQL in dieser Reihe

Beispielmutation

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

REST unterscheidet zwischen Anfragen, die Daten ändern, und solchen, die nicht mit dem Anfragetyp oder „Verb“ (GET vs. POST oder PUT) übereinstimmen.
Bei Verwendung von GraphQL werden datenmodifizierende Abfragen durch das mutation-Schlüsselwort unterschieden, das einem anderen entspricht
Stammentyp im auf dem Server definierten Schema.

Sehen Sie sich diese Beispielmutation für das Hinzufügen eines Produkts zum Warenkorb eines Benutzers an. (Dies erfordert eine generierte Warenkorb-ID
für die Sitzung des angemeldeten Kunden oder unter 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 obige Mutation in einer Anfrage zusammen mit den folgenden Wörterbuchvariablen gesendet wird:

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

Und schließlich erhalten Sie möglicherweise eine Antwort wie die folgende:

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

Im Hinblick auf das obige Beispiel ist Folgendes am wichtigsten: Abgesehen von der Verwendung des mutation-Schlüsselworts anstelle von query
Die Syntax ist identisch mit der einer Abfrage. Wie Abfragen umfasst die Mutation:

Mit der Unterauswahl „Felder“ können Sie flexibel die Felder definieren, die Sie zurückgeben möchten (vom Typ , der als zugewiesen wurde).
Rückgabewert von addProductsToCart - AddProductsToCartOutput), nachdem die Mutation abgeschlossen ist.

Wie bereits erläutert, beginnen in einem GraphQL-Schema definierte Felder in einem Stammtyp für Abfragen (in der Regel als Query bezeichnet). Ähnlich gilt
Für Mutationen gibt es einen anderen Stammentyp (in der Regel als Mutation bezeichnet). addProductsToCart ist ein Feld
über diesen Stammentyp.

Einige weitere Hinweise zum obigen Beispiel:

Nützliche GraphQL-Ressourcen