odoo开发中@api.depends与@api.onchange的区别

Posted ODOO实施、开发、教程资源

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了odoo开发中@api.depends与@api.onchange的区别相关的知识,希望对你有一定的参考价值。

@api.depends

这个装饰器主要运用在odoo的字段相关的函数中。在函数中,对该字段值进行处理时,如果计算值依赖于其他相关字段,不论是与该字段隶属同一张表的还是其他表的字段,都会触发所编写的字段函数。正因为此,可以利用@api.depends 装饰来侦测与字段相关的其他表的字段。如果decorator中依赖的任何字段“被ORM更改或在表单中更改”,都将触发对decorated函数的调用。

@api.onchange

这个装饰器触发decorated函数的时机是:定义的指定字段如果在form窗体出现了变化,就会触发执行。这里要注意的是,这些字段是隶属于同一个模型或同一界面。

综上,虽然 @api.depends 与@api.onchange有诸多相似的地方,但一个重要区别就是 onchange 的侦测字段范围需要在同一个模型或界面上;而depends 可以侦测关联的模型的字段(可以跨不同表)。

 

    @api.onchange(product_uom_qty, product_uom, route_id)
    def _onchange_product_id_check_availability(self):
        if not self.product_id or not self.product_uom_qty or not self.product_uom:
            self.product_packaging = False
            return {}
        if self.product_id.type == product:
            precision = self.env[decimal.precision].precision_get(Product Unit of Measure)
            product = self.product_id.with_context(
                warehouse=self.order_id.warehouse_id.id,
                lang=self.order_id.partner_id.lang or self.env.user.lang or en_US
            )

上面这段代码节选自sale_order.py 文件SaleOrderLine类中, ‘product_uom_qty‘, ‘product_uom‘, ‘route_id‘ 这些字段都是定义在 sale.order.line 模型中的。

再看下面代码中用到的depends:

class SaleOrderLine(models.Model):
    _inherit = sale.order.line

    qty_delivered_method = fields.Selection(selection_add=[(stock_move, Stock Moves)])
    product_packaging = fields.Many2one(product.packaging, string=Package, default=False)
    route_id = fields.Many2one(stock.location.route, string=Route, domain=[(sale_selectable, =, True)], ondelete=restrict)
    move_ids = fields.One2many(stock.move, sale_line_id, string=Stock Moves)

    @api.multi
    @api.depends(product_id)
    def _compute_qty_delivered_method(self):
        """ Stock module compute delivered qty for product [(‘type‘, ‘in‘, [‘consu‘, ‘product‘])]
            For SO line coming from expense, no picking should be generate: we don‘t manage stock for
            thoses lines, even if the product is a storable.
        """
        super(SaleOrderLine, self)._compute_qty_delivered_method()

        for line in self:
            if not line.is_expense and line.product_id.type in [consu, product]:
                line.qty_delivered_method = stock_move

    @api.multi
    @api.depends(move_ids.state, move_ids.scrapped, move_ids.product_uom_qty, move_ids.product_uom)
    def _compute_qty_delivered(self):
        super(SaleOrderLine, self)._compute_qty_delivered()

这段代码与上面onchange片段一样都来自SaleOrderLine类,但可以看到 @api.depends(‘product_id‘) 中的product_id字段是不在sale.order.line模型中的。同样,@api.depends(‘move_ids.state‘, ‘move_ids.scrapped‘, ‘move_ids.product_uom_qty‘, ‘move_ids.product_uom‘) 也是跨表侦测字段。

从上面两段代码,就能看出两者最主要的区别,另外从触发来看,api.onchage在字段变化的时候会触发一次,当字段内容变换完成保存的时候还会触发一次。而api.depends则只在字段变化的时候触发一次。

 

以上是关于odoo开发中@api.depends与@api.onchange的区别的主要内容,如果未能解决你的问题,请参考以下文章

在 Open ERP 中使用 Odoo 的库存管理

《odoo快速入门与实战》的在线开发在 13版 与 11版 的问题与解决

(07)odoo扩展API

Odoo新API

odoo基础开发之CURD(增删查改)

odoo基础开发之CURD(增删查改)