Odoo中如何生成唯一不重复的序列号详解


Posted in Python onFebruary 10, 2018

前言

最近在做的项目中有一个需求是要让某个字段值根据记录产生的日期和一定的组合规则按顺序生成一个序列号,这个序列号不可重复,这原本是一个很常见的需求,没有多想就写好了。由于没有考虑到并发的情况,到后面测试的时候才发现一个比较严重的问题,如果用户同时操作产生的记录,生成的序列号会出现重复。

经过讨论和思考后有几种解决方案,一是在数据库表层加锁,一是采用类似 redis 的消息队列,还有就是通过文件锁达到数据库排他锁的目的,鉴于时间和项目当前的情况,最后采用了通过文件锁实现这个需求。

其实除了以上几种方式,Odoo 本身就有一个模型(ir.sequence)是用于生成序列的,可以很方便地实现这个需求,因为之前一直没有接触过这个模块,还是在项目之后的阶段同事使用到了并且告诉我之后才知道原来有这么个好东西的存在。在这里我将会把我原本通过文件锁实现的方式和通过 Odoo 自带的ir.sequence实现的方式都记录下来。

给文件加锁 - fcntl

fcntl是 Python 标准库里的一个模块,用来对文件进行加锁的操作。在实现中主要用到的是下面这个函数:

def flock(fd, operation):
 """
 flock(fd, operation)

 Perform the lock operation op on file descriptor fd. See the Unix 
 manual page for flock(2) for details. (On some systems, this function is
 emulated using fcntl().)
 """
 pass

其中fd是文件描述符,operation为锁的操作,总共有4种:

  • fcntl.LOCK_EX - 排他锁
  • fcntl.LOCK_NB - 非阻塞锁
  • fcntl.LOCK_SH - 共享锁
  • fcntl.LOCK_UN - 解锁

关于fcntl的其他具体内容请查看 官方标准库文档 。

下面来看一下具体的实现,在给出代码之前,先描述一下需求,假设模型中有一个字段sn用于存储按一定规则生成的序列号,序列号的组成规则如下:

  • 固定的前缀SN
  • 取记录生成的日期组成的6位数字%y%m%d,如2017年12月8日取值为171208
  • 最后是3位的流水号,从001开始递增
  • 生成的序列号不能有重复
  • 最后的3位流水号每天自动重置,从001开始递增(这个需求涉及到一些扩展,故此文将不实现这一需求)

需求很简单,也很清楚了,下面就上代码开始具体的实现。首先创建一个模块demo_sequence:

./odoo-bin scaffold demo_sequence

然后在模块的目录下创建数据文件目录data/,在目录下创建一个data.xml文件,在后面会用到;继续在模块目录下创建静态文件目录static/,在目录下创建一个空文件SN.LOCK用作加锁的文件对象。完成之后的目录结构如下:

demo_sequence
├── __init__.py
├── __manifest__.py
├── controllers
│ ├── __init__.py
│ └── controllers.py
├── data
│ └── data.xml
├── demo
│ └── demo.xml
├── models
│ ├── __init__.py
│ └── models.py
├── security
│ └── ir.model.access.csv
├── static
│ └── SN.LOCK
└── views
├── templates.xml
└── views.xml

模型的创建和视图的编写,这里将跳过不说,具体的代码将在后面给出。先创建一个给文件加锁的函数:

def _file_lock(flag=fcntl.LOCK_EX):
 FILE_PATH = get_module_resource('demo_sequence', 'static/SN.LOCK')
 file = open(FILE_PATH)
 fcntl.flock(file.fileno(), flag)
 _logger.info('Acquire Lock')
 return file

然后重写模型的create()方法:

@api.model
def create(self, vals):
 file = _file_lock()
 sn_prefix = 'SN' + datetime.date.today().strftime("%y%m%d")
 obj = self.env['demo_sequence.fcntl'].search_read([('sn', '=like', sn_prefix + '%')], limit=1, order='sn DESC')
 # 今天已经有序列号,在最新的序列号上递增
 if obj and obj[0]['sn'].startswith(sn_prefix):
 sn_suffix = int(obj[0]['sn'][-3:]) + 1
 vals['sn'] = sn_prefix + str(sn_suffix).zfill(3) # 补0
 else:
 vals['sn'] = sn_prefix + '001'
 res = super(DemoSequence, self).create(vals)
 # 关闭文件将自动解锁
 file.close()
 return res

利用fcntl给文件加锁后再生成序列号写入数据库,以达到序列号不重复的目的,就这么点代码就搞定了,不过还有更简单的方式,就是利用 Odoo 自带的ir.sequence模型产生序列号。

生成唯一标识 - ir.sequence

在模型ir.sequence中是这样描述的:

The sequence model allows to define and use so-called sequence objects. Such objects are used to generate unique identifiers in a transaction-safeway.

我们可以利用它生成唯一的标识,下面就看一下怎么用ir.sequence实现前面所说的需求。

打开data/data.xml并添加以下代码:

<?xml version="1.0" encoding="utf-8"?>
<odoo>
 <data noupdate="1">
 <record id="seq_demo_sequence_sn" model="ir.sequence">
  <field name="name">Demo Sequence SN</field>
  <field name="code">demo_sequence.sequence</field>
  <field name="prefix">SN%(y)s%(month)s%(day)s</field>
  <field name="padding">3</field>
 </record>
 </data>
</odoo>

这里的参数实际上不止这几个,在实现需求的前提下这几个就够用了,分别说明一下各个参数的作用:

  • name - 名字,随便叫什么都行
  • code - 调用生成编码的 Key,需保证唯一性
  • prefix - 前缀,可以是固定的字面量也可以是组合参数
  • padding - 序列递增的位数

注:记得将data/data.xml加入到__manifest__.py的data列表中

接下来就是调用得到按规则生成的序列号,同样重写模型的create()方法:

@api.model
def create(self, vals):
 vals['sn'] = self.env['ir.sequence'].next_by_code('demo_sequence.sequence')
 return super(DemoSequence2, self).create(vals)

可以看到只需要一行代码就可以得到一个唯一的序列号,比前面用fcntl给文件加锁的方式简单了几个级别。这里的调用就用到了前面定义中所写的code。

在实际项目中所使用到的两种方式都已经在这里记录下来了,官方的东西确实是个好东西,回头看看自己写的东西,毕竟 too young,可惜官方的文档好像并没有相关的记录(抑或是我没找到?),多翻翻官方实现的功能模块源码,才是精进 Odoo 之道。

源码下载

以上出现的所有代码均可在仓库 ruter/TNK-Odoo-Demo 中 查看并下载 (大家也可以通过本地下载)。

总结

以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,如果有疑问大家可以留言交流,谢谢大家对三水点靠木的支持。

Python 相关文章推荐
Python开发的单词频率统计工具wordsworth使用方法
Jun 25 Python
让Python更加充分的使用Sqlite3
Dec 11 Python
Python装饰器(decorator)定义与用法详解
Feb 09 Python
Python 生成一个从0到n个数字的列表4种方法小结
Nov 28 Python
python面向对象之类属性和类方法案例分析
Dec 30 Python
使用TensorFlow对图像进行随机旋转的实现示例
Jan 20 Python
TensorFlow MNIST手写数据集的实现方法
Feb 05 Python
python集合删除多种方法详解
Feb 10 Python
基于Python的OCR实现示例
Apr 03 Python
python seaborn heatmap可视化相关性矩阵实例
Jun 03 Python
Python函数调用追踪实现代码
Nov 27 Python
Python3中最常用的5种线程锁实例总结
Jul 07 Python
python TCP Socket的粘包和分包的处理详解
Feb 09 #Python
python实现Adapter模式实例代码
Feb 09 #Python
python实现Decorator模式实例代码
Feb 09 #Python
Python多线程扫描端口代码示例
Feb 09 #Python
Python编程实现从字典中提取子集的方法分析
Feb 09 #Python
python tensorflow学习之识别单张图片的实现的示例
Feb 09 #Python
python删除服务器文件代码示例
Feb 09 #Python
You might like
PHP 存储文本换行实现方法
2010/01/05 PHP
PHP设计模式 注册表模式
2012/02/05 PHP
PHP反射API示例分享
2016/10/08 PHP
用javascript做拖动布局的思路
2008/05/31 Javascript
验证手机号码的JS方法分享
2013/09/10 Javascript
js生成动态表格并为每个单元格添加单击事件的方法
2014/04/14 Javascript
node.js开发中使用Node Supervisor实现监测文件修改并自动重启应用
2014/11/04 Javascript
学习javascript面向对象 掌握创建对象的9种方式
2016/01/04 Javascript
javascript实现数字倒计时特效
2016/03/30 Javascript
jQuery Easyui Tabs扩展根据自定义属性打开页签
2016/08/15 Javascript
AngularJS入门教程之AngularJS 模板
2016/08/18 Javascript
微信小程序(六):列表上拉加载下拉刷新示例
2017/01/13 Javascript
Node.js使用Koa搭建 基础项目
2018/01/08 Javascript
angular6.0使用教程之父组件通过url传递id给子组件的方法
2018/06/30 Javascript
JS中的两种数据类型及实现引用类型的深拷贝的方法
2018/08/12 Javascript
vue.js实现简单购物车功能
2020/05/30 Javascript
Python实现TCP协议下的端口映射功能的脚本程序示例
2016/06/14 Python
浅谈python中的占位符
2017/11/09 Python
Python读取Json字典写入Excel表格的方法
2018/01/03 Python
django admin添加数据自动记录user到表中的实现方法
2018/01/05 Python
python如何使用unittest测试接口
2018/04/04 Python
sublime python3 输入换行不结束的方法
2018/04/19 Python
Python字典的核心底层原理讲解
2019/01/24 Python
在Qt5和PyQt5中设置支持高分辨率屏幕自适应的方法
2019/06/18 Python
基于Python 中函数的 收集参数 机制
2019/12/21 Python
keras中的loss、optimizer、metrics用法
2020/06/15 Python
深入浅析HTML5中的SVG
2015/11/27 HTML / CSS
HTML5在手机端实现视频全屏展示方法
2020/11/23 HTML / CSS
南威尔士家居商店:Leekes
2016/10/25 全球购物
新西兰廉价汽车租赁:Snap Rentals
2018/09/14 全球购物
描述Cookie和Session的作用,区别和各自的应用范围,Session工作原理
2015/03/25 面试题
个人找工作的自我评价
2013/10/17 职场文书
教师自我鉴定范文
2013/11/10 职场文书
课前三分钟演讲稿
2014/04/24 职场文书
银行实习推荐信
2015/03/27 职场文书
网吧管理制度范本
2015/08/05 职场文书