odoo Web Controllers 学习总结

环境

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

odoo.http.route(route=None, **kw)[源代码]

修饰器将被修饰的方法标记为请求的处理程序。该方法必须是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