环境
odoo-14.0.post20221212.tar
Web Controllers
Controllers
控制器需要提供可扩展性，就像Model，但不能使用相同的机制，因为先决条件（已加载模块的数据库）可能还不可用（例如，未创建数据库或未选择数据库）。
因此，控制器提供了自己的与模型的扩展机制：
通过继承Controller创建控制器。通过 route()修饰的方法定义路由:
class MyController(odoo.http.Controller):
@route('/some_url', auth='public')
def handler(self):
return stuff()
要重写控制器，继承其类并重写相关方法，必要的话，重新暴露它们。
class Extension(MyController):
@route()
def handler(self):
do_before()
return super(Extension, self).handler()
-
用
route()修饰是保持方法（和路由）可见的必要条件：如果方法在没有修饰的情况下被重新定义，它将是“未发布的” -
所有方法的修饰符都是组合的，如果没使用任何参数重写方法修饰符，之前所有的参数都被保留，任何提供的参数都将覆盖之前定义的参数，比如:
class Restrict(MyController): @route(auth='user') def handler(self): return super(Restrict, self).handler()将
/some_url从公共身份验证更改为用户身份验证(需要登录）
一个简单示例
代码组织结构如下：
odoo14\custom\estate\controllers\controller.py
#!/usr/bin/env python
# -*- coding:utf-8 -*-
from odoo import http
import json
class TestApi(http.Controller):
@http.route('/test-api-service/testService/testReq', type='http',
auth="public", methods=['POST'], csrf=False, cors='*')
def test_api(self, **kwargs):
try:
print(kwargs)
return json.dumps({'code': 200, 'msg': '请求成功'}, ensure_ascii=False)
except Exception as e:
return json.dumps({'code': 500, 'msg': '%s' % e}, ensure_ascii=False)
注意：不能直接返回json字典，bool值等，会提示不可返回不可调用对象，但是可直接返回字符串，或者返回字符串的函数，如下：
class TestApi(http.Controller):
@http.route('/test-api-service/testService/testReq', type='http',
auth="public", methods=['POST'], csrf=False, cors='*')
def test_api(self, **kwargs):
try:
return self.get_result()
except Exception as e:
return json.dumps({'code': 500, 'msg': '%s' % e}, ensure_ascii=False)
def get_result(self, *args):
return '请求成功'
odoo14\custom\estate\controllers\__init__.py
#!/usr/bin/env python
# -*- coding:utf-8 -*-
from . import controller
odoo14\custom\estate\__init__.py
from . import models
from . import controllers
验证
服务端控制台输出请求参数：
{'arg1': 'value1', 'arg2': 'value2'}
API
Routing
源代码]
修饰器将被修饰的方法标记为请求的处理程序。该方法必须是Controller子类的一部分
参数：
-
route – 字符或者数组。将确定哪些http请求将匹配被修饰方法的路由部分。可以是单个字符串或字符串数组。有关路由表达式的格式，请参见werkzeug的路由文档（http://werkzeug.pocoo.org/docs/routing/ )。
-
type – 请求类型，可选值：
'http'、'json' -
auth –
身份验证方法的类型，可以是以下类型之一:
-
user: 用户必须经过身份验证，执行当前请求的用户，必须具有对应的执行权限 -
public: 用户可能已经过身份验证，也可能没有经过身份证验证。如果没经过身份验证，使用共享公共用户(Public user)执行当前请求。 -
none: 即使没有数据库，该方法也始终处于活动状态。主要由框架和认证模块使用。请求代码没有任何访问数据库的设施，也没有任何指示当前数据库或当前用户的配置。
-
-
methods – 此路由所应用的一系列http方法。如果未指定，则允许使用所有方法。
-
cors – Access-Control-Allow-Origin cors 指令值
-
csrf (bool) –
是否为该路由开启CSRF 保护。
默认为
True。查看CSRF Protection 获取更多信息。
参考连接
https://www.odoo.com/documentation/14.0/zh_CN/developer/reference/addons/http.html