本次学习将按照事例代码run.py的主要运行过程,进行初步学习。
事例run.py的代码如下:
首先是第一行代码:
前往create_qapp()的源代码,主要是创建一个ui界面,具体细节暂略。
然后,是主文件run.py中的两段代码:
我们首先去了解其中的第一段:event_engine = EventEngine():,前往EventEgine模块所在的源文件。
在该源文件中,主要有两大类,Event 和 EventEngine。
Event类:
定义了事件应该具备基本的属性type和data。
EventEngine类:
主其中主要的是线程的创建过程中,涉及到的两个对象:self._run与self._run_timer.
以下说明其功能:
self.run:
当事件引擎启动(即self._active = True),从self.queue这个队列对象中取出一个事件,当事件的身份(Event的属性type)在self._handlers中有被登记时,运行这个事件。(具体如何运行的,暂时还未看出来)
self._run_timer:
当事件引擎运行时休息 self._interval 时间,之后产生一个type值为"eTimer"的event对象,并放入self.queue这个队列对象中。
注意:self._thread 和 self._timer 都是线程对象,在MainEngine中会同时使用到它们。
由于主文件中有:
接下来分析第二段代码,需要跳转到MainEngine相关代码模块,故需对MainEngine的初始化函数内容进行分析:
在上一图中,我们已经创建了事件引擎,所以下面一步是去了解其中的event_engine.start():
其作用是:启动引擎(通过启动线程的方式)
代码如下:
图中涉及了Event类的三个属性,其中:
self._active在EventEngine类的__init__中已经定义过了。其用于判断事件引擎的状态。
self._thread.start() 在EventEngine类的__init__中出现过self._thread,此处是为了启动它。
self._timer.start() 同理,也是线程对象。
然后,通过了解MainEngine的其它属性:由self.gateways,self.engines,self.apps, self.exchanges ,我们可以猜测,MainEngine大概是起到了组装模块的作用。它涉及到了接口,引擎,应用和交易所等信息。
注:上图中的最后两段代码,其一是切换工作路径,其二是初始化一些功能引擎。在后续其它引擎创建时常会用到。
回到主程序run的代码下一行:
代码中先在主引擎中增加了数据接口,回到MainEngine中查看add_gateway。如下:
然后进入run代码的下一行:
查看MainEngine中的add_app:
前往查看添加的引擎,得知为CtaEngine,其继承了一个抽象类BaseEngine,前往了解:
得知内部定义了其运行需要基于MainEngine 和 EventEngine,说明其同时具有组织内部模块和启动引擎的功能。
再按老一套回去看子类CtaEngine的初始化函数,其中主要去了解的是如下内容:
其中的get_database()作用:
当数据库中已经有数据 就返回数据库,否则 按照 设置里的内容 重新导入数据库,若是没有被设置,就默认导入 系统默认的 数据库SQLite数据库。
get_datafeed()作用:
当数据接口中已经有数据 就返回数据接口,否则 按照 设置里的内容 重新导入数据接口,若是没有被设置,就默认导入 系统默认的 接口RQData。
至此,开始执行CtaEgine中的引擎初始化,其中主要的函数是:
self.init_datafeed()、self.register_event()
首先是self.init_datafeed():(以XTP接口举例)
这个函数的作用:运行相应接口的__init__函数,下图是Xtp接口的__init__函数:
然后是self.register_event():