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)。
• 引用字段: 就像电脑上的一个多功能接口 (或者一个万能插座)， 它可以连接任何类型的设备，只需要用户在连接的时候选择接口类型。

从日常场景理解引用字段

1. 评论功能：
   • 场景： 网站上常见的评论功能，允许用户评论文章、商品、视频等。
   • fields.Reference 的作用： 评论模型可以使用一个引用字段，让用户选择要评论的对象， 而不是为每个模型都定义一个关系字段。
2. 任务管理：
   • 场景： 任务管理系统，你可以分配任务给不同的对象 (用户、部门、项目)。
   • fields.Reference 的作用： 任务模型可以使用引用字段， 让用户选择任务分配的对象，而不用为每个对象都定义不同的关系字段。
3. 通知中心：
   • 场景： 通知中心需要通知系统中的任何对象 (用户、商品、订单等)。
   • fields.Reference 的作用： 通知模型可以使用引用字段， 让用户选择通知对象。

代码解析

1. _referencable_models 方法：
   • @api.model: 表示该方法是一个模型级别的方法， 用于获取可选择的模型列表。
   • self.env['ir.model'].search(...): 从 ir.model 模型中查询模型信息。
   • 返回列表： 返回 [(model_id, model_name)] 格式的列表， 定义了哪些模型可以被引用。
2. 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 的缺点

1. 性能问题： 每次读取数据，Odoo 都需要解析字符串，并查询数据库，性能较低。
2. 缺乏引用完整性： 无法保证引用数据的有效性，如果引用数据被删除，字段值可能失效。
3. 复杂度高： 代码可读性差，更难理解和维护。

总结

• fields.Reference： 动态关联不同模型数据的万能接口。
• 适用场景： 需要动态选择目标模型的场景，如评论、通知、自定义关联等。
• 谨慎使用： 由于性能和数据完整性的考虑， 不要滥用 fields.Reference， 优先使用 m2o、o2m、m2m 等传统的关系型字段。
• _referencable_models： 动态获取可选择的模型列表， 就像一个模型注册表。

结语

fields.Reference 字段为 Odoo 开发提供了更强的灵活性，但也需要开发者充分了解其优缺点，并在合适的场景下使用它。希望本文能够帮助你更好地掌握 Odoo 的引用字段，并编写出更加灵活、高效的代码！