Anforderungen mit REST-Datenservices löschen

Der REST-Datenservice von WebSphere eXtreme Scale kann Entitäten, Eigenschaftswerte und Verbindungen löschen.

Entität löschen

Die Anforderung "DeleteEntity" kann eine eXtreme-Scale-Entität aus dem REST-Datenservice löschen.

Wenn für eine Beziehung zu der zu löschenden Entität "cascade-delete" gesetzt ist, löscht der REST-Datenservice von eXtreme Scale die zugehörigen Entitäten. Weitere Einzelheiten zur Anforderung "DeleteEntity" finden Sie auf der Webseite MSDN Library: DeleteEntity Request.

Die folgende Anforderung "DeleteEntity" löscht den Kunden mit dem Schlüssel 'IBM'.
  • Methode: DELETE
  • Anforderungs-URI: http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/Customer('IBM')
  • Nutzdaten der Anforderung: Ohne
  • Nutzdaten der Antwort: Ohne
  • Antwortcode: 204 Kein Inhalt

Eigenschaftswert löschen

Die Anforderung "DeleteValue" setzt eine Eigenschaft einer eXtreme-Scale-Entität auf null.

Mit einer Anforderung "DeleteValue" kann jede Eigenschaft einer eXtreme-Scale-Entität auf null gesetzt werden. Sie müssen Folgendes sicherstellen, um eine Eigenschaft auf null zu setzen:
  • Für primitive Zahlen und die zugehörigen Wrapper, BigInteger und BigDecimal muss der Eigenschaftswert auf 0 gesetzt werden.
  • Für Boolean und boolesche Typen wird der Eigenschaftswert auf "false" gesetzt.
  • Für char und Zeichentypen wird der Eigenschaftswert auf das #X1 (NIL) gesetzt.
  • Für Aufzählungstypen (enum) wird der Eigenschaftswert auf den enum-Wert mit der Ordinalzahl 0 gesetzt.
  • Für alle anderen Typen wird der Eigenschaftswert auf null gesetzt.

Eine solche Löschanforderung kann jedoch vom Datenbank-Back-End zurückgewiesen werden, wenn die Eigenschaft in der Datenbank beispielsweise keine Nullwerte enthalten kann. In diesem Fall gibt der REST-Datenservice eine Antwort 500 (Interner Serverfehler) zurück. Weitere Einzelheiten zur Anforderung "DeleteValue" finden Sie auf der Webseite MSDN Library: DeleteValue Request.

Im Folgenden sehen Sie ein Beispiel für eine Anforderung "DeleteValue". In diesem Beispiel wird der Name der Kontaktperson von Customer('IBM') auf null gesetzt.

Verbindung löschen

Die Anforderung "DeleteLink" kann eine Assoziation zwischen zwei Instanzen einer eXtreme-Scale-Entität entfernen. Die Assoziation kann eine :1- oder eine :N-Beziehung sein. Eine solche Löschanforderung kann jedoch vom Datenbank-Back-End zurückgewiesen werden, wenn beispielsweise eine Integritätsbedingung über Fremdschlüssel definiert ist. In diesem Fall gibt der REST-Datenservice eine Antwort 500 (Interner Serverfehler) zurück. Weitere Einzelheiten zur Anforderung "DeleteLink" finden Sie auf der Webseite MSDN Library: DeleteLink Request.

Die folgende Anforderung "DeleteLink" entfernt die Assoziation zwischen Order(101) und dem zugehörigen Customer.