odoo 定时任务的使用方法

编写执行程序

编写openerp模块代码，在模块代码中编写执行程序! 此处为了方便，只是做了简单的打印输入， 代码如下：

# -*- coding: utf-8 -*-
from openerp.osv import osv

class task_test(osv.osv):
    _auto = False
    _name = "task.test"

    def run_scheduler(self, cr, uid, args,context=None):
        print "test scheduler"

---

配置任务运行参数

在模块中申明一个xxx_data.xml文件，xxx可以不为模块名称，然后在openerp.py 文件中的data属性中加入xxx_data.xml即可，xxx_data.xml文件的配置内容如下：

<?xml version="1.0" encoding="utf-8"?>
<openerp>
    <data noupdate="1">
        <record forcecreate="True" id="ir_cron_scheduler_action" model="ir.cron">
            <field name="name">Run mrp scheduler</field>
            <field eval="True" name="active"/>
            <field name="user_id" ref="base.user_root"/>
            <field name="interval_number">1</field>
            <field name="interval_type">minutes</field>
            <field name="numbercall">3</field>
            <field eval="False" name="doall"/>
            <field eval="'task.test'" name="model"/>
            <field eval="'run_scheduler'" name="function"/>
            <field eval="'(True,)'" name="args"/>
        </record>
    </data>
</openerp>

配置参数说明

从上面我们可以看到配置的这个xxx_data.xml文件在文件的第4行配置了model="ir.cron" 那么我们在oe中打开model ir_cron 可以看到该class的_columns有如下字段：

_columns = {
        'name': fields.char('Name', required=True),
        'user_id': fields.many2one('res.users', 'User', required=True),
        'active': fields.boolean('Active'),
        'interval_number': fields.integer('Interval Number',help="Repeat every x."),
        'interval_type': fields.selection( [('minutes', 'Minutes'),
            ('hours', 'Hours'), ('work_days','Work Days'), ('days', 'Days'),('weeks', 'Weeks'), ('months', 'Months')], 'Interval Unit'),
        'numbercall': fields.integer('Number of Calls', help='How many times the method is called,\na negative number indicates no limit.'),
        'doall' : fields.boolean('Repeat Missed', help="Specify if missed occurrences should be executed when the server restarts."),
        'nextcall' : fields.datetime('Next Execution Date', required=True, help="Next planned execution date for this job."),
        'model': fields.char('Object', help="Model name on which the method to be called is located, e.g. 'res.partner'."),
        'function': fields.char('Method', help="Name of the method to be called when this job is processed."),
        'args': fields.text('Arguments', help="Arguments to be passed to the method, e.g. (uid,)."),
        'priority': fields.integer('Priority', help='The priority of the job, as an integer: 0 means higher priority, 10 means lower priority.')
    }

• name 即该task的名称，由用户定义为该task主要的职责
• user_id 对应res_users表，需要一个用户ID
• active 是否激活该task，默认为True
• interval_number 间隔时间，类型为integer
• interval_type 执行task的周期类型，只能选择分钟、小时、天、周、月，可惜没有秒。
• numbercall 方法调用多少次，-1则是没有限制
• doall 如果任务执行时间错过了服务器重启时间是否重新执行任务
• nextcall 下次的调用时间，我们不用配置，oe会自动计算
• model 即模块名称
• function 要执行的方法
• args 传递的参数
• priority 任务优先级别 0是最高级别，10是最低级别

---

执行过程

在ir_cron模块中主要有三个主要的方法分别为：_callback、_process_job、_acquire_job ，在server.py文件中有如下的Python代码：

def cron_thread(self, number):
        while True:
            time.sleep(SLEEP_INTERVAL + number)     # Steve Reich timing style
            registries = openerp.modules.registry.RegistryManager.registries
            _logger.debug('cron%d polling for jobs', number)
            for db_name, registry in registries.items():
                while True and registry.ready:
                    acquired = openerp.addons.base.ir.ir_cron.ir_cron._acquire_job(db_name)
                    if not acquired:
                        break

到此调用过程就清楚了，server先调用_acquire_job 方法，_acquire_job 会根据dbname获取任务执行的相关数据、例如获取数据操作cr对象，要执行的jobs等，例如：

 db = openerp.sql_db.db_connect(db_name)
 threading.current_thread().dbname = db_name
 cr = db.cursor()

,这个代码又帮我们了解到了如何获取数据库的cr对象。_acquire_job获取相关数据之后，然后交给_process_job方法，该方法会去更新任务的下一次执行时间等数据，然后交由_callback 方法，有兴趣的可以去读一下ir_cron和server的源码。