Khi nào sử dụng api.one và api.multi trong odoo | openerp?

Question

Gần đây odoo (trước đây là OpenERP) V8 đã được phát hành. Trong trang trí phương pháp API mới được giới thiệu. trong các phương thức models.py cần được trang trí với @api.one hoặc @api.multi.

Tham chiếu odoo documentation tôi không thể xác định chính xác sử dụng. Ai có thể giải thích chi tiết.

Cảm ơn.

Answer 1

Thông thường cả hai trình bày deco đều được sử dụng để trang trí phương thức kiểu bản ghi trong đó 'self' chứa recordset (s). Hãy để tôi giải thích ngắn gọn khi sử dụng @api.one và @api.multi:

1.@api.one:

• Trang trí một phương pháp kỷ phong cách nơi 'tự' được kỳ vọng sẽ là một ví dụ singleton.

• Phương pháp trang trí tự động lặp lại trên hồ sơ (nghĩa là, đối với mỗi bản ghi trong bộ sưu tập mà nó gọi phương thức) và tạo danh sách có kết quả.

• Trong trường hợp phương pháp được trang trí bằng @returns, nó sẽ kết hợp các phiên bản kết quả. một phương pháp như:

  @ api.one phương pháp def (tự, args): trở self.name

có thể được gọi trong cả hai kỷ lục và truyền thống phong cách, giống như ::

# recs = model.browse(cr, uid, ids, context) 
names = recs.method(args) 

names = model.method(cr, uid, ids, args, context=context) 

• Mỗi lần 'tự' được định nghĩa lại là bản ghi hiện tại.

2.@api.multi:

• Trang trí một phương pháp kỷ phong cách nơi 'self' là một recordset. Phương thức này thường định nghĩa một thao tác trên các bản ghi. một phương pháp như:

  @ api.multi phương pháp def (tự, args):

có thể được gọi trong cả hai kỷ lục và truyền thống phong cách, giống như ::

# recs = model.browse(cr, uid, ids, context) 
recs.method(args) 

model.method(cr, uid, ids, args, context=context) 

Khi để sử dụng:

1. Nếu bạn đang sử dụng @ api.one, retu giá trị rned nằm trong danh sách. Điều này không phải lúc nào cũng được ứng dụng web hỗ trợ, ví dụ: trên nút hành động phương pháp. Trong trường hợp đó, bạn nên sử dụng @api.đa để trang trí phương thức của bạn và có thể gọi self.ensure_one() trong định nghĩa phương thức.

2. Luôn sử dụng tốt hơn @ api.multi với self.ensure_one() thay vì @ api.one để tránh tác dụng phụ trong giá trị trả lại.

Answer 2

@ api.one:

trang trí này lặp tự động trên hồ sơ của RecordSet cho bạn. Tự được định nghĩa lại như kỷ lục hiện tại:

@api.one 
def func(self): 
    self.name = 'xyz' 

@ api.multi:

tự sẽ là RecordSet hiện tại mà không lặp lại. Đây là hành vi mặc định:

@api.multi 
def func(self): 
    len(self) 

Đối với mô tả chi tiết của tất cả các API bạn có thể tham khảo này Link

Answer 3

@api.model #When the record data/self is not as relevant. Sometimes also used with old API calls. 
def model_text(self): 
    return "this text does not rely on self" 

@api.multi #Normally followed by a loop on self because self may contain multiple records 
def set_field(self): 
    for r in self: 
     r.abc = r.a + r.b 

@api.one #The api will do a loop and call the method for each record. Not preferred because of potential problems with returns to web clients 
def set_field(self): 
    self.abc = self.a + self.b