编辑页面
.replaceCollection()
替换指定集合的所有成员（例如，博客文章 #4 的 comments）。
await Something.replaceCollection(parentId, association)
.members(childIds);
用法
| 参数 | 类型 | 详情 | |
|---|---|---|---|
| 1 | parentId | 父记录的主键值（即 id）。 必须是数字或字符串（例如 '507f191e810c19729de860ea' 或 49）。或者，可以指定一个数字或字符串数组（例如 ['507f191e810c19729de860ea', '14832ace0c179de897'] 或 [49, 32, 37]）。在这种情况下，子记录将在每个父记录中被替换。 |
|
| 2 | association | 复数（“集合”）关联的名称（例如，“pets”） | |
| 3 | childIds | 将成为关联新成员的子记录的主键值（即 id）。请注意，这不会创建这些记录或销毁旧的记录，它只是将记录附加到/分离到指定的父项。 |
错误
| 名称 | 类型 | 何时 |
|---|---|---|
| UsageError | 如果传入无效内容，则抛出此错误。 | |
| AdapterError | 如果数据库适配器中出现错误，则抛出此错误。 | |
| Error | 如果发生任何其他意外情况，则抛出此错误。 |
有关在 Sails 和 Waterline 中协商错误的示例，请参阅概念 > 模型和 ORM > 错误。
示例
对于用户 3，用宠物 99 和 98 替换“pets”集合中的所有宠物
await User.replaceCollection(3, 'pets')
.members([99,98]);
边缘情况
- 如果父 ID 实际上不对应于现有的持久化记录，则此操作将不执行任何操作。
- 如果其中一个子 ID 实际上不对应于现有的持久化记录，则该子 ID 将被忽略，并且只有与其他提供的子 ID 对应的成员将包含在替换集合中。
- 如果提供了空的子 ID 数组，或者如果提供的子 ID 均不对应于现有记录，则这将从父项分离所有子记录。
备注
- 此方法可与
await、promise 链或传统的 Node 回调一起使用。- 如果关联是“双向”（表示它具有
via），则子记录将相应地修改。如果另一侧的属性是单数，则每个新链接或断开链接的子记录的外键将被更改。如果是复数，则每个子记录的集合将相应地修改。- 此外，如果
via指向另一侧的单数（“模型”）属性，则.addToCollection()将在必要时“窃取”这些子记录。例如，假设您有一个 Employee 模型，它具有以下复数（“集合”）属性：involvedInPurchases: { collection: 'Purchase', via: 'cashier' }。如果您执行Employee.addToCollection(7, 'involvedInPurchases', [47])将此购买分配给员工 #7（Dolly），但购买 #47 已经与其他员工（例如 #12，Motoki）关联，则这将从 Motoki 处“窃取”购买并将其交给 Dolly。换句话说，如果您执行Employee.find([7, 12]).populate('involvedInPurchases')，Dolly 的involvedInPurchases数组将包含购买 #47，而 Motoki 的则不会。
为了在 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)
- WebSocket
参考
用心打造
Sails 框架由 德克萨斯州奥斯汀市的一家网络和移动商店 在贡献者的帮助下构建。我们在 2012 年创建了 Sails 来帮助我们完成 Node.js 项目。自然而然地，我们将其开源。我们希望它能让你生活更轻松！
© 2012-2024 The Sails Company.
Sails 框架是根据 MIT 许可证发布的免费开源软件。
插图由 Edamame 提供。