介紹

二開時模型創(chuàng)建完畢并配好視圖后對于基本的CRUD操作不需要再在代碼中實現，框架會自動提供這些功能，但如果我們的開發(fā)需求不僅僅是對當前對象的CRUD時，就需要在框架原來方法的基礎上擴展出一些自己所需要的操作。
odoo8以前與odoo8以后使用兩種不同的model接口形式(odoo8兩者都可使用)，odoo8以前old api中，記錄ids和上下文環(huán)境均通過參數傳入def old_api (self, cr, uid, ids, context)，比較凌亂，不建議使用。以下內容均為new api內容。

api裝飾器

@api.model

封裝不關聯數據記錄的Model對象,用于與數據庫記錄無關的邏輯方法，例如：create方法。

@api.multi

封裝關聯多個數據記錄的Model對象，用于與數據庫記錄關聯的處理方法。

@api.one

封裝關聯單條數據記錄的Model對象,用于與單條數據庫記錄關聯的處理方法。

@api.onchange

頁面Fields值變更觸發(fā)的調用方法，見下文中onchange

@api.constrains

對添加數據自定義約束。

@api.constrains(‘field_name1’,’field_name2’,…) def _check_field(self):
# 校驗方法 不符合校驗條件拋出異常

model方法

create 創(chuàng)建記錄

原型：def create(self, vals)
vals：記錄屬性值字典

search 查找記錄

原型：def search(self, args, offset=0, limit=None, order=None, count=False)
args：domain格式的條件列表；offset：結果忽略條數；limit：最大查詢條數

read 讀取記錄屬性值

返回指定ids記錄的指定fields字段值，采用列表加字典的數據結構（[{},{},…]）返回。
原型：def read(self, fields=None, load='_classic_read'):
fields：列表可指定要讀取的屬性名稱

search_read

原型：def search_read(self, domain=None, fields=None, offset=0, limit=None, order=None)
用法即search方法與read方法相結合。

unlink 刪除記錄

原型：def unlink(self)

write 修改記錄

原型：def write(self, vals)
vals：修改屬性值字典

onchange 頁面變更觸發(fā)事件

頁面Field值發(fā)生變更時由前端js框架觸發(fā)調用，一般用于控制頁面元素聯動。
原型：def onchange(self, values, field_name, field_onchange)

default_get 設置缺省值

原型：def default_get(self, fields_list)

name_get 設置記錄顯示名

原型：def name_get(self)