编辑页面
.archiveOne()
存档（“软删除”）与指定条件匹配的记录，将其（如果存在）作为新记录保存到内置的 Archive 模型中，然后销毁原始记录。
var originalRecord = await Something.archiveOne(criteria);
在尝试修改数据库之前，Waterline 将检查给定条件是否会匹配多条记录，如果是，它将抛出错误而不是继续执行。
用法
| 参数 | 类型 | 详情 | |
|---|---|---|---|
| 1 | criteria | 用于在数据库中匹配记录的Waterline 查询语言。 |
结果
| 类型 | 描述 |
|---|---|
由于此方法永远不会存档多条记录，因此如果存档了记录，则始终将其作为结果提供。否则，这将返回undefined。 |
错误
有关在 Sails 和 Waterline 中处理错误的示例，请参阅概念 > 模型和 ORM > 错误。
示例
var finn = await User.archiveOne({ firstName: 'Finn' });
if (finn) {
sails.log('Archived the user named "Finn".');
} else {
sails.log('The database does not have a user named "Finn".');
}
备注
此方法最适合用于您原本会使用
.destroyOne()的情况，但您仍然需要将删除的数据保留在某个地方（例如，出于合规性原因）。如果您预计需要在您的应用程序中再次访问数据（例如，如果您允许取消删除），您可能需要考虑使用isDeleted标志，因为存档的记录在编程上更难以处理。（没有内置的“取消存档”。）
- 此方法不支持 .fetch()，因为它始终返回存档的记录（如果匹配了一个）。
为了在 sailsjs.com 上获得更好的体验，请更新您的浏览器。
参考
- 应用
- 蓝图 API
- 命令行界面
-
配置
- sails.config.*
- sails.config.blueprints
- sails.config.bootstrap()
- sails.config.custom
- sails.config.datastores
- sails.config.globals
- sails.config.http
- sails.config.i18n
- sails.config.log
- sails.config.models
- sails.config.policies
- sails.config.routes
- sails.config.security
- sails.config.session
- sails.config.sockets
- sails.config.views
-
请求 (`req`)
- req._startTime
- req.body
- req.cookies
- req.fresh
- req.headers
- req.hostname
- req.ip
- req.ips
- req.isSocket
- req.method
- req.options
- req.originalUrl
- req.params
- req.path
- req.protocol
- req.query
- req.secure
- req.signedCookies
- req.socket
- req.subdomains
- req.url
- req.wantsJSON
- req.xhr
- req.accepts()
- req.acceptsCharsets()
- req.acceptsLanguages()
- req.allParams()
- req.file()
- req.get()
- req.is()
- req.param()
- req.setLocale()
- req.setTimeout()
- req.host
- 响应 (`res`)
- Waterline (ORM)
- WebSockets
参考
用心打造
Sails 框架由 德克萨斯州奥斯汀的一家网络与移动商店 以及我们的贡献者共同构建。我们在 2012 年创建了 Sails，以协助我们进行 Node.js 项目。自然地，我们将其开源。我们希望它能使您的生活更轻松！
© 2012-2024 Sails 公司.
Sails 框架是根据 MIT 许可证发布的免费开源软件。
插图由 Edamame 提供。