编辑页面
.updateOne()
更新匹配给定条件的记录（如果存在）。
var updatedRecord = await Something.updateOne(criteria)
.set(valuesToSet);
在尝试修改数据库之前，Waterline 会检查是否有多条记录匹配给定条件；如果是，它会抛出一个错误而不是继续执行。
用法
| 参数 | 类型 | 详情 | |
|---|---|---|---|
| 1 | criteria | 用于匹配数据库中记录的Waterline 查询条件。 | |
| 2 | valuesToSet | 所有匹配记录都应更新为具有的值的字典（普通 JavaScript 对象）。（注意，如果此模型处于“模式化”模式，则任何多余的键都会被静默忽略。） |
注意：出于性能原因，从 Sails v1.0 / Waterline 0.13 开始，传递给此模型方法的
valuesToSet对象在大多数情况下都会就地修改（而在 Sails/Waterline v0.12 中，情况并非总是如此）。
结果
| 类型 | 描述 |
|---|---|
updateOne() 永远不会更新超过一条记录，因此，如果更新了一条记录，则该记录将作为结果提供。否则，将返回 undefined。 |
错误
有关在 Sails 和 Waterline 中协商错误的示例，请参见概念 > 模型和 ORM > 错误。
示例
var updatedUser = await User.updateOne({ firstName:'Pen' })
.set({
firstName:'Finn'
});
if (updatedUser) {
sails.log('Updated the user named "Pen" so that their new name is "Finn".');
}
else {
sails.log('The database does not contain a user named "Pen".');
}
备注
- 此方法不支持 .fetch()，因为它始终返回匹配到的修改后的记录。
- 此方法可与
await、Promise 链或传统的 Node 回调一起使用。- 此方法可用于替换整个集合关联（例如，用户的友人列表），从而获得与
replaceCollection方法相同的结果。要单独修改集合中的项目，请使用addToCollection或removeFromCollection方法。
为了在 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 The Sails Company.
Sails 框架是免费的，并在 MIT 许可证下开源。
插图由 Edamame 提供。