【odoo二次開(kāi)發(fā)】ORM框架(二、Model方法及api裝飾器)

介紹

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

api裝飾器

@api.model

封裝不關(guān)聯(lián)數(shù)據(jù)記錄的Model對(duì)象,用于與數(shù)據(jù)庫(kù)記錄無(wú)關(guān)的邏輯方法,例如:create方法。

@api.multi

封裝關(guān)聯(lián)多個(gè)數(shù)據(jù)記錄的Model對(duì)象,用于與數(shù)據(jù)庫(kù)記錄關(guān)聯(lián)的處理方法。

@api.one

封裝關(guān)聯(lián)單條數(shù)據(jù)記錄的Model對(duì)象,用于與單條數(shù)據(jù)庫(kù)記錄關(guān)聯(lián)的處理方法。

@api.onchange

頁(yè)面Fields值變更觸發(fā)的調(diào)用方法,見(jiàn)下文中onchange

@api.constrains

對(duì)添加數(shù)據(jù)自定義約束。

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

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:結(jié)果忽略條數(shù);limit:最大查詢條數(shù)

read 讀取記錄屬性值

返回指定ids記錄的指定fields字段值,采用列表加字典的數(shù)據(jù)結(jié)構(gòu)([{},{},…])返回。
原型:def read(self, fields=None, load='_classic_read'):
fields:列表可指定要讀取的屬性名稱(chēng)

search_read

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

unlink 刪除記錄

原型:def unlink(self)

write 修改記錄

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

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

頁(yè)面Field值發(fā)生變更時(shí)由前端js框架觸發(fā)調(diào)用,一般用于控制頁(yè)面元素聯(lián)動(dòng)。
原型:def onchange(self, values, field_name, field_onchange)

default_get 設(shè)置缺省值

原型:def default_get(self, fields_list)

name_get 設(shè)置記錄顯示名

原型:def name_get(self)

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書(shū)系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,182評(píng)論 6 543
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡,警方通過(guò)查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 99,489評(píng)論 3 429
  • 文/潘曉璐 我一進(jìn)店門(mén),熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái),“玉大人,你說(shuō)我怎么就攤上這事。” “怎么了?”我有些...
    開(kāi)封第一講書(shū)人閱讀 178,290評(píng)論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)。 經(jīng)常有香客問(wèn)我,道長(zhǎng),這世上最難降的妖魔是什么? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 63,776評(píng)論 1 317
  • 正文 為了忘掉前任,我火速辦了婚禮,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 72,510評(píng)論 6 412
  • 文/花漫 我一把揭開(kāi)白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開(kāi)封第一講書(shū)人閱讀 55,866評(píng)論 1 328
  • 那天,我揣著相機(jī)與錄音,去河邊找鬼。 笑死,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,860評(píng)論 3 447
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起,我...
    開(kāi)封第一講書(shū)人閱讀 43,036評(píng)論 0 290
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒(méi)想到半個(gè)月后,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 49,585評(píng)論 1 336
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 41,331評(píng)論 3 358
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 43,536評(píng)論 1 374
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,058評(píng)論 5 363
  • 正文 年R本政府宣布,位于F島的核電站,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 44,754評(píng)論 3 349
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 35,154評(píng)論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 36,469評(píng)論 1 295
  • 我被黑心中介騙來(lái)泰國(guó)打工, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 52,273評(píng)論 3 399
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 48,505評(píng)論 2 379

推薦閱讀更多精彩內(nèi)容