Odoo 引用字段 fields.Reference：动态关系的选择器
在 Odoo 模型开发中，关系型字段是构建复杂应用的基础。 然而，传统的 m2o、o2m 和 m2m 字段需要在模型定义时就明确指定关系的目标模型，这在某些场景下会显得不够灵活。 为了解决这个问题，Odoo 提供了 fields.Reference 引用字段，它允许在运行时动态选择关系的目标模型。
传统关系字段的局限性：静态关系的束缚
- 静态定义: 传统的
m2o、o2m、m2m字段在定义时必须指定目标模型。 例如：fields.Many2one('res.users', '用户')表示这个字段只能关联到res.users模型的数据。 - 局限性：
- 无法动态选择：用户无法在运行时选择这个字段应该关联到哪个模型。
- 代码冗余： 如果需要关联多个不同的模型，你需要定义很多
m2o、o2m或m2m字段。
引用字段 fields.Reference：动态关系的选择器
- 动态关系：
fields.Reference允许用户在运行时动态选择要关联的目标模型。 - 目标： 不再是预先定义好的目标， 而是让用户在界面上自己选择要关联的模型。
- 灵活性：
fields.Reference就像一个万能接口， 可以根据用户的选择， 连接到任何模型的数据。 - 核心： 在用户界面上提供一个下拉列表，让用户选择要关联的模型的类型，然后再选择该模型下的具体记录。
形象比喻：不同的接口
- 传统关系字段: 就像电脑上固定的接口，只能连接特定类型的设备 (USB, HDMI)。
- 引用字段: 就像电脑上的一个多功能接口 (或者一个万能插座)， 它可以连接任何类型的设备，只需要用户在连接的时候选择接口类型。
从日常场景理解引用字段
- 评论功能：
- 场景： 网站上常见的评论功能，允许用户评论文章、商品、视频等。
fields.Reference的作用： 评论模型可以使用一个引用字段，让用户选择要评论的对象， 而不是为每个模型都定义一个关系字段。
- 任务管理：
- 场景： 任务管理系统，你可以分配任务给不同的对象 (用户、部门、项目)。
fields.Reference的作用： 任务模型可以使用引用字段， 让用户选择任务分配的对象，而不用为每个对象都定义不同的关系字段。
- 通知中心：
- 场景： 通知中心需要通知系统中的任何对象 (用户、商品、订单等)。
fields.Reference的作用： 通知模型可以使用引用字段， 让用户选择通知对象。
代码解析
_referencable_models方法：@api.model: 表示该方法是一个模型级别的方法， 用于获取可选择的模型列表。self.env['ir.model'].search(...): 从ir.model模型中查询模型信息。- 返回列表： 返回
[(model_id, model_name)]格式的列表， 定义了哪些模型可以被引用。
fields.Reference：selection： 指定使用哪个方法获取可选的模型列表（即_referencable_models）。- 数据存储： 以字符串形式存储
model_name,record_id( 例如：res.users,1)。
代码示例
from odoo import models, fields, apiclass Hostel(models.Model):_name = 'hostel.hostel'@api.modeldef _referencable_models(self):models = self.env['ir.model'].search([('field_id.name', '=', 'message_ids')])return [(x.model, x.name) for x in models]ref_doc_id = fields.Reference(selection='_referencable_models',string='参考文档')
fields.Reference 的缺点
- 性能问题： 每次读取数据，Odoo 都需要解析字符串，并查询数据库，性能较低。
- 缺乏引用完整性： 无法保证引用数据的有效性，如果引用数据被删除，字段值可能失效。
- 复杂度高： 代码可读性差，更难理解和维护。
总结
fields.Reference： 动态关联不同模型数据的万能接口。- 适用场景： 需要动态选择目标模型的场景，如评论、通知、自定义关联等。
- 谨慎使用： 由于性能和数据完整性的考虑， 不要滥用
fields.Reference， 优先使用m2o、o2m、m2m等传统的关系型字段。 _referencable_models： 动态获取可选择的模型列表， 就像一个模型注册表。
结语
fields.Reference 字段为 Odoo 开发提供了更强的灵活性，但也需要开发者充分了解其优缺点，并在合适的场景下使用它。希望本文能够帮助你更好地掌握 Odoo 的引用字段，并编写出更加灵活、高效的代码！