[笨蛋熊] 【源码解析】从零开始教你开发自己的脚本框架（二） [复制链接]

上一节我们讲了整个数据的结构设计，并通过数据可视化的步骤，把数据变成了我们展示的界面。
这就体现了我之前一直强调的，编程的本质，就是处理数据，所有程序都是为了处理数据而生的，计算机也是为了这个目的被制造出来的，我们写代码，核心一定要围绕着数据来，其他东西，都是给数据管理打辅助的。



接下来让我们把视角放在源代码视图：



这里源代码只有1000多行，和很多高阶的作者比，这个代码量绝对算是小儿科了。

当然，这并不是 xTask 全部的源代码，因为按键精灵2014的代码编辑器很卡，代码量一旦上了几千行之后，敲代码都卡卡的，所以我一般在这里写代码的时候，都会刻意控制代码数量。



为了方便大家阅读和改写，我当初在开源时已经对代码做好了分类和注释，在代码中，可以看到很多这样的注释：





这些注释把1000多行代码拆成了10个功能块，每个功能块的所有函数都只干一件事情：



程序加载初始化代码：

窗口加载时执行的代码，它会初始化环境，创建数据模型，引入基础运行库，然后加载存储在数据库中的 task 列表，以及调用项目管理的功能，扫描 project 目录下的工程，将工程添加到列表。



项目管理相关功能：

负责扫描项目列表，将列表更新到界面上，以及事件响应（切换项目时的界面动作）



项目 七日留存 相关功能：

就是控制项目注册的角色，7天时间内不断流失注册用户的数据模拟功能，这部分和原始需求有关，反倒不需要大家去深入理解。

这一部分主要负责的也是界面的响应。



项目 数据库管理 相关功能：

项目数据库管理界面相关的功能响应。



帐号导入导出 接口代码：

账号导入和账号导出两个界面的功能响应。



任务管理相关功能：

任务计划界面的事件响应，也负责一些基本逻辑的实现，比如创建、删除、修改任务等。



程序设置 热键设置 相关功能：

比较简单的设置界面，可以像按键一样按某个键启动和结束计划任务。



任务监控界面和整体调度功能：

这是比较核心的功能，任务的具体执行从这里开始，任务界面的响应代码也都在这里，之后我们会详细讲解。



任务线程创建：

也是比较核心的功能，任务的每一个线程都从这里开始创建，WorkThread 函数是框架内所有任务子线程的统一入口。



全局数据监控：

这里的代码用于刷新全局数据界面，来把与框架运行有关的所有核心数据都给展示出来。





全局数据：

代码看完了，接下来我们看全局数据部分，我们的框架只使用了非常少的变量，因为我们又折叠数据成结构的方法，这个一会再讲，全局变量的定义如下：我比较喜欢吧所有用到的变量都显式定义一下，基本上数据就这么多了。

可以看到第一行定义的变量都以 _Ptr 结尾，这是指针的意思，可以理解为是一个对象的指针，这个对象里，就以结构化存储着我们所需要的全部数据。

G_Atom_Global_Ptr 是全局数据
G_Atom_Thread_Ptr 是线程列表数据
G_Atom_Task_Ptr 是计划任务列表数据
G_Atom_Proj_Ptr 是子项目列表数据
G_Atom_Context_Ptr 是上下文数据，上下文数据是传递给线程用的，我们每次创建线程的时候，都会把这个线程需要的数据用这个对象传送过去，然后线程就能很方便的访问这些数据了。

然后第二行，是一些普通的全局数据：

G_Index_Proj 当前选择的项目（QUI使用的）
G_Index_Task 当前选择的计划任务（QUI使用的）
G_Lock_Thread 线程锁，创建线程的时候用的，xTask每次创建线程，都会用锁把数据保护起来，就算创建 10000 个线程，也不会出现数据错乱的情况。
G_Path_Root 程序根目录

线程锁的功能，由我编写的DLL实现（所以解析这东西的源代码，也是希望能给大家带来一些有趣的玩意，这里用到的不少东西，都是值得单独拿出来玩的）：到这里代码就分类的差不多了，接下来我们详细讲解一下，当小精灵启动的瞬间，我们的框架都干了些什么。



窗口创建事件代码解析：

代码如下：嗯，代码量并不多，而且注释很丰富，应该不难理解吧？

【重置全局数据】 就是把全局数据都给清0了，避免QUI读取数据设置界面属性的时候出现误判，任何情况下，我们都应该养成这样的好习惯，很多时候BUG就是这么来的。

【重定向工作目录】 读取 option.ini 的 setup 小节的 work 数据，然后把 {$root} 替换成程序所在目录。
这是为了啥？因为我做的这个东西，正常来说它是做成小精灵单独运行的，但我在开发它的时候经常需要在按键精灵环境下运行，如果我要在两个地方都运行，那数据就得整两份，我不想这样，所以加入了这个根目录重定向功能，可以在按键精灵环境下，把根目录重定向到小精灵的目录里，这样我在两个地方运行脚本，环境都是统一的了。
最后我们计算好的根目录，会赋值给 G_Path_Root，以后我们只会通过这个变量作为我们的工作目录了。

【注册运行库】调用了 RegeditRtl 函数，它的代码是这样子的，就是把大漠插件啊，DWX插件啊什么的都给注册到系统里面，顺便检查一下MD5值，因为有段时间感染型病毒挺多的，我怕把dm.dll 感染了，回头运行的时候出错又找不到原因，小心驶得万年船：【创建系统运行环境（加载各种支持库）】 调用了 LoadLibrary 函数，代码很简单，长这样：这段代码咱需要好好说道说道了，前面不是说这1000多行代码不是全部代码嘛，因为很多代码被我以VBS的形式写在外面了。
这段代码其实就是创建一个 fso 对象，读取 library 目录下的 System_Task.vbs，然后把这个 vbs 在按键环境里运行一下，于是这个文件里的函数，按键就都能用了。
这些做完之后，我还调用了 xTask_System_Create 函数，代码也很简单，它长这样：它又调用了一大堆 include 函数，这东西实际上就是上一个函数的翻版，只不过可以自定义导入的文件了，它长这样：好嘞，也就是说，这边一行代码，实际上整个library目录下的VBS文件，基本都进来了，这些 vbs 也有个几千行代码了，这也是xTask为什么源代码如此少的原因。
当然，到这一步我们还没有调用任何东西，所以不用太担心它的复杂度。

【创建全局Atom对象】 这部分代码就是把我们全局变量里定义的那些 _Ptr 的数据给创建出来，它调用了 CreateAtom 函数，代码很简单，长这样：其中 G_Atom_Global 创建为字典，G_Atom_Thread、G_Atom_Task 和 G_Atom_Proj 创建为数组，创建完了之后，把他们的指针保存起来备用，然后创建全局线程锁对象。
这里用到了 xVarDict 和 xVarList 函数，我们在源代码里搜索找不到，实际上这俩函数在 library 目录的 Rtl_xTask_lib.vbs 文件内，它和它的兄弟们长这样：xAtom 相关的功能都写在这个文件里，这是一个我定义的类，VBS支持类的特性，还支持 default 调用，封装一下用起来很爽。
xAtom 这个名字取意原子，就是说这个类下面的所有操作都自带原子特性，不管是一个最简单的数值，还是字符串，还是结构化数据，都带线程锁，多线程同时读写小意思，不会出问题。
是为了 xTask 专门开发的库，感兴趣的兄弟可以看一下源代码，不感兴趣的兄弟，会用就行了，关于这个类的用法，我整理了帮助文档，在 二次开发资料 目录下的 xTask Library 帮助文档.chm 里。

【系统初始化】 它调用了 xTask_System_Init 函数，在按键里是搜不到这个函数的，实际上这个函数在 library 的 System_Task.vbs 里，长这样：也就是读一些配置，没什么稀奇的，这里可以注意一下，G_Atom_Global 和我们按键里定义的 G_Atom_Global_Ptr 是一个意思，它其实是一个类，但是定义了 default 特性，而 default 定义给了一个属性，所以可以这么用，等价于这种写法：G_Atom_Global.List("RT_Start", 0)
但是这个写法看起来好像在访问一个 Table 一样，很优雅，这也是为啥这些功能我要用 VBS 实现的原因。

【设置运行停止热键】 这里没什么稀奇的了，就是读配置，然后设置热键。

【加载任务计划选项】读配置，改界面。

【刷新项目列表】调用了 ScanProjList 函数，长这样：这里调用了 xProj_LoadAll 函数，这个函数保存在 library 目录下的 SysRtl_Project.vbs 里，长这样：原理也很简单，就是 fso 对象扫文件夹，然后扫到的所有子文件夹调用 xProj_Load 函数加载，这个函数也在同一个文件里，长这样：xTask 允许不同编程语言来实现不同的工程，即可以用VBS，也可以用能写DLL的语言做个DLL，或者你自己高兴的话，在这里写一个加载器，也可以用你写的语言来弄，大同小异了，这只是一个路由函数，最终的活其实是 xProj_Load_VBS 干的，它也在这个文件里：代码并不复杂把，就是读数据，填数据而已，很多朋友可能会好奇，我下载的 xTask 开发包为啥一运行起来就弹个对话框呢？有问题吗？其实没问题，就是在这里弹的，这个工程加载器肯定不会随便弹个窗口出来，但是他加载的工程会呀，你看他是会读取项目代码的，然后运行！
运行的是 Sys_Init 函数，通过 xProj_CallProc 来调用，这个函数就是用来调用工程内指定函数的，代码非常简单：这一段代码有点长征的意味了把，一层套着一层的，但实际追溯下来，其实也不算复杂，就是把目录扫描一遍，把配置文件都给读出来，存在我们自己的结构化数据里面，然后脚本加载上，调用一下 Sys_Init 函数，说简单点，就是我们用按键精灵又做了一个按键精灵，我们自己的 xTask 当然也有按键精灵的启动事件咯。

到这里我先休息一下，再次强调一个问题

不知道你发现了没有，当我们对数据的掌控达到这样的程度之后，似乎一切东西管理起来，也就那么回事了。
所以说呀，数据，数据，数据，数据才是编程的核心，别特么学几条别人封装好的指令觉得自己是大神了到处扯淡，很幼稚。
好好的，把数据管理的基本功给练好了先。

休息完毕，接着说代码

【刷新任务列表】 这里和上一个部分大同小异了，从几个文件跳来跳去的，不过这个比项目可简单多了，我觉得你能读懂项目加载那部分，那这里也不成问题：调用了 xTask_LoadAll 加载任务列表，调用了 RefreshtTaskGrid 刷新QUI，刷新QUI的代码就在 xTask 按键工程里，这里看一下 xTask_LoadAll 吧，这个代码在 library 的 SysRtl_Task.vbs 里：这里我们创建了 DB 变量，作为 tz_TextDataBase 类的实例，tz_TextDataBase 类是一种文本数据库，性能很低，但是用起来比较方便，我闲着没啥事的时候写的。
代码就在同目录的 Rtl_xdb.vbs 里，感兴趣的话就研究一下吧，为啥不用 Access？因为这玩意有些系统破坏了驱动，运行不起来，我可不希望我写的破玩意还挑系统。
为啥不用 SQLite3？因为 SQLite3 想用 VBS 调用的话，得安装一个 ODBC 驱动，我可不希望我写的破玩意还得安装个别的东西才能用，所以，凑活一下咯，我这个数据库也不是完全没有优点，比如弄字段的时候，就挺方便的，也正是因为这个优点，所以我这个 xTask 框架的灵活性也提升了不少。
剩下的代码就马马虎虎了，都是数据操作，没什么稀奇的，一眼就能看明白，不讲了。

【加载项目类型】 这段代码就是 QUI 操作咯。

【加载导入/导出帐号方案】 也是QUI操作，然后调用ChangeImportUserList函数触发了一个事件，就是列表改变的，不然必须切换一下界面才变，不美观，小细节了。

最后是【刷新全局数据列表 [默认页面]】

可算讲完了，卧槽，累死我了。

这里调用了 RefreshAtomListEvent 函数，这函数很简单，长这样：它调用了 RefreshAtomList 函数，就是传入一个 xAtom对象指针，然后把这个 xAtom 的数据遍历完了，显示在表格里，代码长这样：运行以后的效果长这样：



于是我们就可以开开心心的查看整个框架里所有的数据啦！

路径列就是对应的数据访问方法（直接写在代码里就行）
index 列是说这个数据相对于它的父节点的索引
数据类型就是数据类型了，字符串在这里叫做 Buffer，因为内部实现就是自增长缓冲区，速度还挺快的。
数据内容就是它的实际值，然后引用计数，是用于自动释放的机制，这个数据引用一下就 +1，释放一次就 -1，懂引用计数机制的人应该知道啥意思，不懂耶没影响，不管他就是了。



一个程序的窗口加载就讲了这么多，下一小节我们接着讲吧，先讲讲 library 目录内的这一大堆文件是怎么分类的，在见了您内~