Solicitudes de supresión con los servicios de datos REST

El servicio de datos REST de WebSphere eXtreme Scale suprime entidades, valores de propiedad y enlaces.

Supresión de una entidad

La solicitud DeleteEntity suprime entidades de eXtreme Scale del servicio de datos REST.

Si cualquier relación con la entidad que se debe suprimir tiene definida la supresión en cascada, el servicio de datos REST de eXtreme Scale suprimirá la entidad o las entidades relacionadas.Si desea más detalles sobre la solicitud DeleteEntity, consulte: MSDN Library: DeleteEntity Request (Biblioteca MSDN: solicitud DeleteEntity).

La siguiente solicitud DeleteEntity suprime el cliente con la clave 'IBM'.
  • Método: DELETE
  • URI de la solicitud: http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/Customer('IBM')
  • Carga útil de la solicitud: Ninguna
  • Carga útil de la respuesta: Ninguna
  • Código de respuesta: 204 No Content

Supresión del valor de una propiedad

La solicitud DeleteValue define una propiedad de entidad de eXtreme Scale como nula.

Cualquier propiedad de una entidad de eXtreme Scale se puede definir como nula con una solicitud DeleteValue. Para definir una propiedad como nula, asegúrese de todo lo siguiente:
  • Para cualquier tipo de número primitivo y su derivador, BigInteger, o BigDecimal, el valor de la propiedad se define como 0.
  • Para el tipo Boolean o boolean, el valor de la propiedad se define como false.
  • Para el tipo char o Character, el valor de la propiedad se define con el carácter #X1 (NIL).
  • Para el tipo enum, el valor de la propiedad se define con el valor enum con el ordinal 0.
  • Para todos los demás tipos, el valor de la propiedad se define como nulo.

No obstante, el programa de fondo de base de datos puede rechazar una solicitud de supresión de este tipo si, por ejemplo, la propiedad no puede tener un valor nulo en la base de datos. En este caso, el servicio de datos REST devuelve una respuesta 500 (Internal Server Error). Si desea más detalles sobre la solicitud DeleteValue, consulte: MSDN Library: DeleteValue Request (Biblioteca MSDN: solicitud DeleteValue).

A continuación se ofrece un ejemplo de solicitud DeleteValue. En este ejemplo, definimos como nulo el nombre de contacto de Customer('IBM').

Supresión de un enlace

La solicitud DeleteLink puede eliminar una asociación entre dos instancias de entidad de eXtreme Scale. La asociación puede ser una relación a uno o una relación a muchos.No obstante, el programa de fondo de base de datos puede rechazar una solicitud de supresión de este tipo si, por ejemplo, la restricción de clave foránea está definida. En este caso, el servicio de datos REST devuelve una respuesta 500 (Internal Server Error).Si desea más detalles sobre la solicitud DeleteLink, consulte: MSDN Library: DeleteLink Request (Biblioteca MSDN: solicitud DeleteLink).

La siguiente solicitud DeleteLink elimina la asociación entre Order(101) y su Customer asociado.