大家好，我是你的Odoo技术伙伴。在日常使用Odoo时，你一定对这个操作非常熟悉：在任意一个表单视图的“操作”菜单中，都有一个“复制”（Duplicate）按钮。点击一下，一个新的、几乎一模一样的记录就被创建出来了，省去了大量重复录入的工作。
这个便捷功能的背后，其实隐藏着一个经典的设计模式——原型模式（Prototype Pattern），也常被称为克隆模式（Clone Pattern）。今天，我们就来深入剖析Odoo 17是如何实现并运用这一模式的。
一、什么是原型模式？
让我们先用一个生物学的比喻来理解它：克隆羊多利。科学家们不是从零开始，用原子和分子来组装一只羊，而是取了一个现有羊的体细胞（原型 Prototype），通过复制其完整的基因信息，创造出了一只新的、几乎完全相同的羊（克隆 Clone）。
将这个思想转换到软件设计领域：
原型模式指定了创建对象的种类，通过复制一个现有的实例（即“原型”）来创建新的对象，而无需关心其具体的创建细节。简而言之，就是用一个对象来创建另一个可定制的、一模一样的对象。
它的核心优势在于：
- 性能提升：对于创建过程非常复杂或耗时的对象，直接复制一个已有的实例，远比从头开始执行其初始化过程要快得多。
- 简化创建：客户端代码无需知道复杂的实例化逻辑，只需调用一个
clone()方法即可。
二、Odoo的实现：ORM核心方法 copy()
在Odoo中，原型模式的实现非常直观和强大，它被内建于ORM的核心之中，这个实现就是每个模型都拥有的 copy() 方法。
- 原型 (Prototype): Odoo中任意一条已经存在的记录，例如一张特定的销售订单
sale.order(1)。 - 克隆操作 (Clone Operation): 该记录上调用的
copy()方法。 - 新实例 (New Instance):
copy()方法执行后返回的新记录。
当你点击UI上的“复制”按钮时，Odoo前端就会触发一个RPC调用，最终执行了当前记录的 copy() 方法。
默认的copy()方法会遍历原始记录的所有字段，读取它们的值，然后调用 create() 方法创建一个新记录，并将这些值赋给新记录的相应字段。
三、定制克隆过程：copy=False 与重写 copy()
当然，并非所有信息都适合被复制。一张被复制的销售订单，其状态应该回到“草稿”，而不是保持“已完成”；其唯一的订单号需要重新生成，而不是直接沿用。Odoo为此提供了两种强大的定制机制。
1. 字段级控制：copy=False 属性
这是最简单、最常用的定制方式。你可以在模型字段的定义中，设置 copy=False，来明确告诉Odoo ORM：“在执行copy()操作时，请忽略这个字段。”
经典应用场景：
- 状态字段 (
state): 复制的单据应该回到初始状态。 - 唯一性字段: 如订单号、发票号，复制后需要重新生成，避免违反数据库唯一约束。
- 关联的沟通记录 (
message_ids): 复制一张单据，不应该把它的历史沟通记录也一并复制过去。 - 计算字段 (
store=False): 非存储的计算字段本身就没有值可复制。
代码示例:
让我们看一个简化的sale.order模型定义：
# models/sale_order.py
from odoo import models, fields
class SaleOrder(models.Model):
_inherit = 'sale.order'
# name 字段是序列号，每次都应不同，所以不复制
name = fields.Char(string='Order Reference', required=True, copy=False, readonly=True, default='/')
# state 字段，复制后应回到草稿状态
# copy=False 意味着它会被设置为其 default 值，即 'draft'
state = fields.Selection(
selection=[
('draft', 'Quotation'),
('sent', 'Quotation Sent'),
('sale', 'Sales Order'),
('done', 'Locked'),
('cancel', 'Cancelled'),
],
string='Status', readonly=True, copy=False, default='draft')
# 订单行是组合的一部分，我们希望它们被深拷贝，所以保持默认 copy=True
order_line = fields.One2many('sale.order.line', 'order_id', string='Order Lines', copy=True)
设置copy=False后，当copy()执行时，该字段将被赋予其default值（如果定义了的话），否则将被留空（False或None）。
2. 方法级控制：重写 copy() 方法
当copy=False无法满足更复杂的克隆逻辑时，我们可以直接重写模型的copy()方法。
经典应用场景：
- 在复制后的记录名称后追加“(副本)”或“(copy)”字样。
- 在复制时，需要根据某些条件动态修改某些字段的值。
- 在复制主记录后，需要执行一些额外的关联操作。
代码示例:
假设我们希望在复制项目（project.project）时，自动将其名称加上“(副本)”，并清空项目负责人。
# models/project_project.py
from odoo import models, fields, api, _
class ProjectProject(models.Model):
_inherit = 'project.project'
# 假设我们想让负责人字段在复制时不被沿用
user_id = fields.Many2one('res.users', string='Project Manager', copy=False)
@api.returns('self', lambda value: value.id)
def copy(self, default=None):
# 1. 首先，调用父类的copy方法，完成基础的克隆操作
# `super()`会处理所有字段的复制（除了copy=False的）并返回新记录
new_record = super(ProjectProject, self).copy(default)
# 2. 然后，在新创建的记录上进行我们自定义的修改
original_name = self.name
new_record.name = _('%s (copy)', original_name)
# 3. 你还可以在这里执行更复杂的逻辑，比如：
# new_record.message_post(body="This project was duplicated from another project.")
# 4. 最后，返回被修改过的新记录
return new_record
重要提示:
- 在重写
copy()时，强烈建议首先调用super().copy(default)。这能确保所有基础的、Odoo内置的复制逻辑被正确执行。 copy()方法接受一个可选的default字典参数。这个字典里的键值对，会在创建新记录时覆盖从原型复制过来的值。这为我们从代码层面调用copy()并进行定制提供了极大的灵活性。
四、广义的原型：default_get
从更广义的角度看，Odoo的default_get()方法也蕴含了原型模式的思想。它并不复制一个已有的对象，而是为即将创建的新对象提供一个“类别原型”或“上下文原型”。
当你点击“创建”按钮时，default_get()方法被调用，它会根据模型的default定义、用户的偏好设置、以及传入的context，预先填充表单。这相当于给你提供了一个基于“理想模板”的、而非完全空白的初始对象，大大提升了数据录入的效率。
结论
原型模式在Odoo中是一个非常接地气、与业务结合紧密的设计模式。它通过ORM核心的copy()方法被完美实现，并通过copy=False属性和方法重写提供了强大的定制能力。
掌握原型模式在Odoo中的应用，意味着你能够：
- 提升用户体验：通过精确控制复制行为，减少用户的重复劳动和错误。
- 保证数据一致性：确保复制出的新单据符合业务规则（如状态重置、唯一号更新）。
- 编写优雅的代码：使用
copy=False和重写copy()来清晰地表达你的业务意图，而不是在多个地方用变通方法来处理复制逻辑。
下次当你在思考如何简化用户的重复录入任务时，不妨想一想原型模式，看看是否能通过定制copy()方法，为你的模块提供一个智能、高效的“一键复制”功能。