REST データ・サービスでの削除要求

WebSphere® eXtreme Scale REST データ・サービスでは、エンティティー、プロパティー値、およびリンクを削除できます。

エンティティーの削除

DeleteEntity 要求は、eXtreme Scale エンティティーを REST データ・サービスから削除できます。

cascade-delete が設定された削除対象エンティティーに対する関係がある場合は、eXtreme Scale REST データ・サービスでは、関連するエンティティーが削除されます。DeleteEntity 要求の詳細については、MSDN Library: DeleteEntity Request を参照してください。

以下の DeleteEntity 要求は、キーが「IBM」の Customer を削除します。
  • メソッド: DELETE
  • 要求 URI: http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/Customer('IBM')
  • 要求ペイロード: なし
  • 応答ペイロード: なし
  • 応答コード: 204 No Content

プロパティー値の削除

DeleteValue 要求は、eXtreme Scale エンティティー・プロパティーをヌルに設定します。

DeleteValue 要求を使用すると、eXtreme Scale エンティティーのすべてのプロパティーがヌルに設定されます。プロパティーをヌルに設定するには、以下のすべてを確認します。
  • プリミティブ数値型およびそのラッパー (BigInteger、BigDecimal) の場合、プロパティー値が 0 に設定されている。
  • Boolean (boolean) 型の場合、プロパティー値が false に設定されている。
  • char (Character) 型の場合、プロパティー値が文字 #X1 (NIL) に設定されている。
  • enum 型の場合、プロパティー値が、序数が 0 の enum 値に設定されている。
  • それ以外の型の場合、プロパティー値がヌルに設定されている。

ただし、例えばデータベース内でプロパティーがヌル可能ではない場合などに、このような削除要求はデータベース・バックエンドによって拒否される可能性があります。 その場合、REST データ・サービスは 500 (Internal Server Error) 応答を返します。 DeleteValue 要求の詳細については、MSDN Library: DeleteValue Request を参照してください。

以下に、DeleteValue 要求の例を示します。 この例では、Customer('IBM') の連絡先名をヌルに設定します。

リンクの削除

DeleteLink 要求は、2 つの eXtreme Scale エンティティー・インスタンス間のアソシエーションを削除できます。アソシエーションは、対 1 関係または対多関係にすることができます。 ただし、例えば外部キー制約が設定されている場合などに、このような削除要求はデータベース・バックエンドによって拒否される可能性があります。 その場合、REST データ・サービスは 500 (Internal Server Error) 応答を返します。 DeleteLink 要求の詳細については、MSDN Library: DeleteLink Request を参照してください。

以下の DeleteLink 要求は、Order(101) と関連付けられた Customer との間のアソシエーションを削除します。