Qt 项目架构之一：全局类说明

这里讲解一些全局类，一般都放在 Util 这个文件夹内。Util 是工具的意思，一般来说，常常用来描述和业务逻辑没有关系的数据处理。

一、全局配置文件

全局配置文件管理类 AppConfig 用来读写对应项目的配置文件。格式可以是 ini、xml、json 等，小项目建议 ini，怎么方便怎么来，相当于将配置文件的值映射到全局变量。

配置文件如果配置项较多建议分组存储方便查找，而不是全部放在一个大分组中。读配置文件的时候可以判断配置文件是否存在、配置项是否缺失等情况，有问题则重新生成配置文件，避免恶意删除配置文件导致程序运行异常。

读配置文件的时候可以填入默认值（Qt 配置文件类 QSettings 的 value 方法的第二个参数，set.value(“Hardware”, App::Hardware)），避免初始时候读取不到节点而导致配置项值不符合预期值类型。

读配置文件完成后可以重新判断配置项的值是否符合要求，对值进行过滤和矫正，防止人为打开配置文件修改后填入了异常的值，比如定时器的间隔为 0，要重新纠正设定为合法的值。

带中文的初始值用QString::fromUtf8包起来，比如QString::fromUtf8(“管理员”)。带中文的配置项要设置配置文件编码为utf-8，比如set.setIniCodec(“utf-8”)。

二、全局变量

全局变量管理类 AppData 用来设置项目中用到的所有全局变量。比如当前用户/系统是否锁定等，这样可以在任意的编码位置使用该变量进行判断处理。可以将 UI 界面中的导航栏宽高、按钮大小、图标大小等变量放在这，系统启动后判断分辨率等来设定不同的值。

三、全局事件中转处理

全局事件中转处理类 AppEvent 用来中转系统中各种跨多个 UI 以及多个类的事件。此类必须是全局单例类，便于全局统一使用。

比如类 a 的父类是 b，类 b 的父类是 c，现在有个信号要发给类 d，在没有事件中转处理的情况下的做法是将 a 信号发给 b，b 再发给 c，c 再发给 d，如果父类嵌套层级越多越复杂，代码越难管理。

将类 a 的信号发给 appEvent 类，然后类 d 直接关联 appEvent 类进行处理就行。项目越大，会越发现信号中转处理的必要性，代码清晰，管理方便。

四、全局程序初始化

全局程序初始化类 AppInit 用来做一些程序启动后的初始化处理。

• 设置全局样式表，建议先读取通用的样式表，然后将额外的样式表内容加到后面一起设置。

• 设置翻译文件，可以加载多个，包括 qt 内置的qt_zh_CN.qm，用户自己的翻译文件等。

• 启动日志输出类用来启动日志服务。

• 读取配置文件。

• 设置全局字体。

• 设置项目编码。

• 初始化随机数种子。

• 新建项目中需要的目录，防止没有目录无法保存文件到目录。

• 初始化数据库，包括打开数据库，载入基础数据比如用户表、设备表等。

• 启动运行时间记录类用来记录每次软件运行开始时间和结束时间。

• 关联全局事件过滤器处理自定义无边框UI拖动、全局按键处理等。

五、全局通用类

• 全局通用类 AppCommon，定义一些例如 delay 等常用函数。

• 调试日志输出类 SaveLog 用来启动日志服务，可以将日志输出到文件或者网络打印输出。

• 运行时间记录类 SaveRuntime 用来记录每次软件运行开始时间和结束时间。

• 图形字体类 IconFont 用来设置图形字体图标。