永久地从数据库中删除由id
指定的记录,并通知已订阅的套接字。
DELETE /:model/:id
这会销毁与id参数匹配的记录,并以 JSON 字典的形式响应被销毁的实例。如果不存在与指定的id匹配的模型实例,则返回404
。
此外,destroy
事件将发布到订阅该记录房间的所有套接字,并且所有当前订阅该记录的套接字将取消订阅它。
参数 | 类型 | 细节 |
---|---|---|
model | 包含模型的标识。 例如: 'purchase' (在/purchase/7 中) |
|
id (必填) |
要销毁的记录的主键值,在路径中指定。 例如: '7' (在/purchase/7 中)。 |
删除Pinkie Pie
DELETE /user/4
{
"name": "Pinkie Pie",
"hobby": "kickin",
"id": 4,
"createdAt": 1485550644076,
"updatedAt": 1485550644076
}
如果你为你的应用程序启用了 WebSockets,那么每个订阅了被销毁记录的客户端都会收到一条通知,其中事件名称是模型标识的名称(例如:user
),并且“消息”具有以下格式
verb: 'destroyed',
id: <the record primary key>,
previous: <a dictionary of the attribute values of the destroyed record (including populated associations)>
例如,继续上面的示例,所有订阅了User
#4 的客户端(除了发出请求的客户端)可能会收到以下消息
id: 4,
verb: 'destroyed',
previous: {
name: 'Pinkie Pie',
hobby: 'kickin',
createdAt: 1485550644076,
updatedAt: 1485550644076
}
如果被销毁的记录与其他记录有任何链接,则可能会有其他一些通知
假设我们示例中被销毁的记录与via
相关联,那么updated
或removedFrom
通知也会发送到订阅了关系另一端这些子记录的任何客户端。有关这些通知结构的更多信息,请参见蓝图 > 从中移除和蓝图 > 更新。
如果
via
指向的是复数关联(例如:cashiers
),则会发送removedFrom
通知。否则,如果via
指向的是单数关联(例如:cashier
),则会发送updated
通知。
req
)