力控dbcomm接口说明讲述.doc

DB接口模块设计 DbComm设计 DbComm通讯机制 通讯架构 DbComm为Db通讯组件的核心模块，其他模块实现如DbApi和DbOcx，DbSdk都是在此核心模块基础上的二次封装，DbComm采用静态库的方式提供。 DbComm和Db进行通讯，分为两种模式： 本地模式：采用窗口消息机制（COPYDATA）与本地DB进行通讯 远程模式：采用TCP方式与远程NetServer进行通讯 同一时刻只能运行于一种模式，本地或者远程 不论本地还是远程模式，处理模块内部都将开辟两个线程： 数据处理线程：负责连接DB，初始化DB，数据包的解析等工作 回调函数线程：负责按照需求进行回调（连接状态变化回调，数据变化回调） 所有调用函数都采用同步机制实现，发送给DB相应的请求以后将等待一个超时时间，如果DB返回数据，调用函数成功，如果超时，调用函数失败。为了防止交换数据过大，网络速率引起的时间延误，DBCOMM在收到正确的数据包后将刷新超时时间，超时时间按照接收到最后一个正确的数据包计算，但最大时间不超过超时时间的10倍。 数据流程 与DB通讯流程（本地模式和远程模式的差别只是在于通讯链路的区别，通讯机制是相同的） DB初始化：只有DB初始化完成以后，向DB发送各种命令才有意义 当客户端注册数据通知以后，注册的数据点在获取数据时，默认从DbComm的内部缓存中读取数据（也可以强制从DB读取数据），以加快数据的获取速度 对于注册点，内部采用计数机制，每一个数据点内部都有一个计数器，代表这个数据点的注册次数，注销的时候只有在计数为0时，才真正注销计数。典型的应用为，有A、B两任务，A任务使用Tag1-10，10个点的数据，B任务使用Tag5-15，10个点的数据，两任务有5个点的交叉，这样一个任务不用去分辨那些点和其他任务交叉，主需要注册10个点即可，在DbComm内部会保存，Tag5-10的注册计数为2，只有调用两次注销函数，才会真正将点从缓存中去掉，这样会简化各个任务的处理机制。 客户端注册数据时，可以动态增加或者删除注册点，以保证DbComm的灵活性，客户端注册数据成功后，可以调用函数读取所有注册点的数据 客户端注册数据后，变化通知或者读取数据都按照序号的形式读取，以加快数据解析速度，也提供其他的方式读取数据（按照点名等） DbComm不再使用Variant数据类型，采用自定义的数据结构来存储Db数据库中的三种数据类型（整形，浮点，字符串） 数据变化通知机制 DB的变化通知机制是，当数据变化是将变化数据保存于DB内部，外部程序例如DBCOMM周期的访问DB的变化数据。为了最大程度保证变化数据不丢失，又不占用太大内存，DBCOMM在DB内部开辟了一个单向列表来保存变化数据。 DB为所有的注册点开辟一个统一的缓存区（按照类型分为两种缓存，字符串型和浮点型），缓存区的大小等于注册点个数（最小开辟200），这样保证每个点都有一个位置来保存自己的变化数据，又不至于太浪费内存 每一个注册点都保存一份数据信息，包括有多少个变化数据，第一个变化数据在缓存中的位置，最后一个变化数据在缓存中的位置 初始状态时缓存是有个有序的单向链表 变化数据都按照先后顺序填入链表中，当缓存区全部用完以后，取出数据个数最多的一个点，例如Tag2.pv,将它的数据缓存区占用一个，用于保存必威体育精装版的变化数据，这样保证最大程度的利用缓存，又保证每个点的数据变化不会因为缓存长度的限制被丢失。  DbComm接口 内存管理 DbCommMallocMem 语法：char* DbCommMallocMem(unsigned long Len); 说明： 参数：返回值备注：FreeMem 语法：void DbCommFreeMem(char* pBuf); 说明： 参数：返回值备注：new_DbComm 语法：CDbComm* new_DbComm (int nType); 说明： 参数：返回值备注：语法：void delete_DbComm (CDbComm* pDbComm); 说明： 参数：返回值备注：SetCallerPtr方法 语法：void SetCallerPtr(unsigned long ptr); 说明： 参数：ptr调用者指针 返回值备注：SetStatusChangeFunc方法 语法：void SetStatusChangeFunc (STATUS_CHANGE_FUNC hFunc); 说明： 参数：hFunc回调函数指针指针 返回值备注：typedef void (*STATUS_CHANGE_FUNC)(unsigned long ptr1, //ptr1指向本对象的指针unsigned long ptr2, //ptr2指向调用者的指针