odoo框架源码研读二：ORM与日志

忘是亡心i 2023-10-03 11:09 6阅读 0赞

黄华信，神州数码云基地软件开发工程师，擅长odoo定制化开发。

上一篇文章讨论了odoo源码的整体结构和前后端交互。感兴趣的同学可以戳下面的链接~

[odoo框架源码研读一：前后端交互][odoo]

本文接着研读odoo的源码，主要讲述odoo的ORM和日志。

#### 1. ORM ####

#### 1.1Environment ####

请求到达controller后，又是如何实现后端的业务逻辑呢？这就不得不提到odoo一个非常强大的类，那就是Environment。通过\_local属性，Environment可以直接管理线程中的environments上下文状态，并且包装了ORM相关四个属性：  
'cr'：当前数据库游标对象，通过self.env.cr(sql)，可以直接执行SQL语句进行数据的CRUD,  
'uid': 当前登陆用户ID,通过self.env.uid获取当前登陆用户ID  
'context'：当前上下文字典，通过self.env.context，我们可以缓存前后端的数据用来交互  
'su':切换超级用户模式，通过它我们可以越过model\_access权限的校验，直接操作数据

而且Environment还提供了model name和model之间的映射，通过self.env\[ModelName\]就可以直接调用model的api,非常强大。

![f12140fd7b3b2ffc59a95e9b652973cc.png][]

现在再回首看Controller中的方法，可以看到通过request.env\[model\]可以直接获取对应的Model对象，然后直接调用Model的方法。

#### 1.2 Model ####

**odoo中一切都是基于model编程，即使是前端的menu、action、view，都是也都有对应model，和业务数据无异。**一个model的创建，然后通过简单的视图配置，那么这个model对应的CRUD基础功能就已经实现，这些都归功于odoo对于model的抽象。  
odoo中的model分为三类**AbstractModel**、**Model**、**TransientModel**,继承关系如图

![f7410a95776e9c349aa0ae727d4c7241.png][]

![8a0245af0842470c0c2799a67493b38f.png][]

从源码中可以看出AbstractModel是Model和TransientModel的父类。而这个三者的区别也主要在\_auto、\_register、\_abstract、\_transient这四个属性上，由此可以AbstractModel是抽象类，不会在数据库创建表，Model和TransientModel不是抽象类，会在数据库建表，但TransientModel建的是临时表，数据会被系统定期清除，这个可以在系统中设置清除频率。  
由于这种特性的不同，三个model的用途也不相同，TransientModel由于存临时表的特性，多用来做wizard向导视图，存储临时缓存数据，Model多用于做业务的主要model，AbstractModel多用来抽象做父类，由于不创建表的特性有时也会用来做向导视图。  
新模块中的model,根据功能需要去继承这三个类，由于这三个父类中丰富的api方法，新建model在创建完字段后功能就已经基本完善，如果有定制化的逻辑只需要重写父类的方法就可以了。

#### 1.3 Field ####

model中的field不是python的基础类型，而是继承odoo封装的Field类。

![0b660e1f2d8a93d3b73a9643cc3ebd71.png][]

因此在model字段赋值的时候，和基础类型字段不同，会调用Field中的api方法，这是容易踩坑的地方。

### 2. 日志 ###

odoo的日志是python的logging基础模块之上，做了定制化的封装和配置。这部份的代码主要在odoo/netsvc.py文件中。 odoo定义了自己的Filter对象、Formatter对象、以及Handler对象。

![a75b33b40d0b7ebeb61c3093f2e856be.png][]

![19f24c28a478a97490859016e05939af.png][]

Handler对象  
日志处理器，对传入的日志进行处理。比如PostgreSQLHandler就是把日志存入数据库。  
Formatter对象  
日志格式器，对日志内容进行格式化。  
Filter对象  
日志过滤器，可以实现复杂的过滤，截取需要的日志内容。

#### **2.1 配置参数** ####

项目启动的时候,配置管理器configmanager初始化，这个时候会去初始化默认的系统配置，包括日志模块。之后配置管理器会去加载配置文件odoo.conf中的自定义配置覆盖原先的默认配置。处理完配置加载，odoo会调用日志初始化代码，根据最终的日志配置去设定相关的logger对象。

![29d6836839930055477c961e3819cf44.png][]

上图是odoo日志的默认配置。

![7bfbb2223ec84343a7be2705f87fa09e.png][]

#### **2.2 初始化** ####

初始化过程：

![f9dbc416c59cbc8243395a4a3b809ef0.png][]

![f2d00b5b5dabbeb271beb26e7086f611.png][]

1.  设定日志初始化标志\_logger\_init，保证odoo只会初始化一次logger对象。
2.  设定logRecordFactory，在日志信息中添加定制化参数信息，这里是将perf\_info设置成了""
3.  warnings.filterwarnings()设置警告过滤器去除一些不必要的告警信息
4.  resetlocale设置国际化
5.  根据syslog配置参数，以及操作系统类别设置系统日志的handler
6.  给handler设置fomatter
7.  将设定好的handler添加到root logger（root logger 与各个包层级下衍生logger的关系这里不做赘述）
8.  给wekzeug包下的logger对象添加filter
9.  根据log\_db配置参数设定postgresqHandler,确定是否将日志入库,以及log\_db\_level确定入库日志的级别
10. logging\_configurations设定特定几个包名下logger的配置

#### **2.3 logger的调用** ####

通过logging.logging.getLogger(\_*name*\_)调用前包层级的logger对象，logging.logging.getLogger()则返回root logger对象。

关于odoo的日志就聊到这里，下面一篇文章会继续聊一下odoo的异常和流程引擎。

小伙伴们可以点赞收藏评论，关注我们，可以及时看到文章更新~

**传送门**

[小“菜鸟”成长记][Link 1]

[TiKV源码略读-Server Start][TiKV_-Server Start]

[odoo框架源码研读一：前后端交互][odoo]

[odoo]: https://zhuanlan.zhihu.com/p/358372874
[f12140fd7b3b2ffc59a95e9b652973cc.png]: https://img-blog.csdnimg.cn/img_convert/f12140fd7b3b2ffc59a95e9b652973cc.png
[f7410a95776e9c349aa0ae727d4c7241.png]: https://img-blog.csdnimg.cn/img_convert/f7410a95776e9c349aa0ae727d4c7241.png
[8a0245af0842470c0c2799a67493b38f.png]: https://img-blog.csdnimg.cn/img_convert/8a0245af0842470c0c2799a67493b38f.png
[0b660e1f2d8a93d3b73a9643cc3ebd71.png]: https://img-blog.csdnimg.cn/img_convert/0b660e1f2d8a93d3b73a9643cc3ebd71.png
[a75b33b40d0b7ebeb61c3093f2e856be.png]: https://img-blog.csdnimg.cn/img_convert/a75b33b40d0b7ebeb61c3093f2e856be.png
[19f24c28a478a97490859016e05939af.png]: https://img-blog.csdnimg.cn/img_convert/19f24c28a478a97490859016e05939af.png
[29d6836839930055477c961e3819cf44.png]: https://img-blog.csdnimg.cn/img_convert/29d6836839930055477c961e3819cf44.png
[7bfbb2223ec84343a7be2705f87fa09e.png]: https://img-blog.csdnimg.cn/img_convert/7bfbb2223ec84343a7be2705f87fa09e.png
[f9dbc416c59cbc8243395a4a3b809ef0.png]: https://img-blog.csdnimg.cn/img_convert/f9dbc416c59cbc8243395a4a3b809ef0.png
[f2d00b5b5dabbeb271beb26e7086f611.png]: https://img-blog.csdnimg.cn/img_convert/f2d00b5b5dabbeb271beb26e7086f611.png
[Link 1]: https://zhuanlan.zhihu.com/p/355193859
[TiKV_-Server Start]: https://zhuanlan.zhihu.com/p/356584875