将事件驱动引擎的变量改为私有，同时添加put方法

vn.event/eventEngine.py

@@ -16,6 +16,17 @@ class EventEngine:
     """
     事件驱动引擎
 
+    事件驱动引擎中所有的变量都设置为了私有，这是为了防止不小心
+    从外部修改了这些变量的值或状态，导致bug。
+    
+    变量说明
+    __queue：私有变量，事件队列
+    __active：私有变量，事件引擎开关
+    __thread：私有变量，事件处理线程
+    __timer：私有变量，计时器
+    __handlers：私有变量，事件处理函数字典
+    
+    
     方法说明
     __run: 私有方法，事件处理线程连续运行用
     __process: 私有方法，处理事件，调用注册在引擎中的监听函数
@@ -24,12 +35,13 @@ class EventEngine:
     stop：公共方法，停止引擎
     register：公共方法，向引擎中注册监听函数
     unregister：公共方法，向引擎中注销监听函数
+    put：公共方法，向事件队列中存入新的事件
     
     事件监听函数必须定义为输入参数仅为一个event对象，即：
     
     函数
     def func(event)
-        ....
+        ...
     
     对象方法
     def method(self, event)
@@ -41,28 +53,28 @@ class EventEngine:
     def __init__(self):
         """初始化事件引擎"""
         # 事件队列
-        self.queue = Queue()
+        self.__queue = Queue()
         
         # 事件引擎开关
-        self.active = False
+        self.__active = False
         
         # 事件处理线程
-        self.thread = Thread(target = self.__run)
+        self.__thread = Thread(target = self.__run)
         
         # 计时器，用于触发计时器事件
-        self.timer = QTimer()
-        self.timer.timeout.connect(self.__onTimer)
+        self.__timer = QTimer()
+        self.__timer.timeout.connect(self.__onTimer)
         
-        # 这里的handlers是一个字典，用来保存对应的事件调用关系
+        # 这里的__handlers是一个字典，用来保存对应的事件调用关系
         # 其中每个键对应的值是一个列表，列表中保存了对该事件进行监听的函数功能
-        self.handlers = {}
+        self.__handlers = {}
         
     #----------------------------------------------------------------------
     def __run(self):
         """引擎运行"""
-        while self.active == True:
+        while self.__active == True:
             try:
-                event = self.queue.get(block = True, timeout = 1)  # 获取事件的阻塞时间设为1秒
+                event = self.__queue.get(block = True, timeout = 1)  # 获取事件的阻塞时间设为1秒
                 self.__process(event)
             except Empty:
                 pass
@@ -71,10 +83,13 @@ class EventEngine:
     def __process(self, event):
         """处理事件"""
         # 检查是否存在对该事件进行监听的处理函数
-        if event.type_ in self.handlers:
+        if event.type_ in self.__handlers:
             # 若存在，则按顺序将事件传递给处理函数执行
-            for handler in self.handlers[event.type_]:
-                handler(event)    
+            [handler(event) for handler in self.__handlers[event.type_]]
+            
+            # 以上语句为Python列表解析方式的写法，对应的常规循环写法为：
+            #for handler in self.__handlers[event.type_]:
+                #handler(event)    
                
     #----------------------------------------------------------------------
     def __onTimer(self):
@@ -83,41 +98,41 @@ class EventEngine:
         event = Event(type_=EVENT_TIMER)
         
         # 向队列中存入计时器事件
-        self.queue.put(event)    
+        self.put(event)    
 
     #----------------------------------------------------------------------
     def start(self):
         """引擎启动"""
         # 将引擎设为启动
-        self.active = True
+        self.__active = True
         
         # 启动事件处理线程
-        self.thread.start()
+        self.__thread.start()
         
         # 启动计时器，计时器事件间隔默认设定为1秒
-        self.timer.start(1000)
+        self.__timer.start(1000)
     
     #----------------------------------------------------------------------
     def stop(self):
         """停止引擎"""
         # 将引擎设为停止
-        self.active = False
+        self.__active = False
         
         # 停止计时器
-        self.timer.stop()
+        self.__timer.stop()
         
         # 等待事件处理线程退出
-        self.thread.join()
+        self.__thread.join()
             
     #----------------------------------------------------------------------
     def register(self, type_, handler):
         """注册事件处理函数监听"""
         # 尝试获取该事件类型对应的处理函数列表，若无则创建
         try:
-            handlerList = self.handlers[type_]
+            handlerList = self.__handlers[type_]
         except KeyError:
             handlerList = []
-            self.handlers[type_] = handlerList
+            self.__handlers[type_] = handlerList
         
         # 若要注册的处理器不在该事件的处理器列表中，则注册该事件
         if handler not in handlerList:
@@ -140,7 +155,10 @@ class EventEngine:
         except KeyError:
             pass     
         
-
+    #----------------------------------------------------------------------
+    def put(self, event):
+        """向事件队列中存入事件"""
+        self.__queue.put(event)
 
 
 ########################################################################
@@ -162,7 +180,7 @@ def test():
     from PyQt4.QtCore import QCoreApplication
     
     def simpletest(event):
-        print str(datetime.now())
+        print u'处理每秒触发的计时器事件：%s' % str(datetime.now())
     
     app = QCoreApplication(sys.argv)