Skip to content

数据库连接、DAO 与旧插件兼容 ​

UI/ColorVision.Database/ 提供 MySQL 连接配置、业务 DAO、实体驱动的通用查询,以及 SQLite 正文存储、迁移与维护。

LocalTemplateStore 管理当前用户 ApplicationData/ColorVision/Config/ColorVision.Local.db,SQLite 引擎随应用提供,无需安装数据库服务。首次使用自动建库;local_templates 按 kind 区分配置类型,保存名称、业务 schema 版本、完整 JSON、顺序和可空的 created_utc。新建文档记录 UTC 创建时间,更新、重命名及交换顺序不改变该时间;旧库自动新增可空列,已有记录保留未知日期,不按迁移时刻回填。当前接入 POI、流程、设备资源与许可证配置,后续类型由各 owner 定义 payload;该库只保存配置,不保存图片、检测结果、运行日志或执行记录。POI 及其全部点位作为一个文档原子保存,点位保留小数坐标;流程保存完整 STN 与稳定身份,并通过条件更新防止并发覆盖。读取失败和不支持的业务版本必须报错,不能当成空模板。

POI 的 PoiTemplateStorage 在 MySQL 未连接或列表查询失败时自动使用本地库,不主动调用 MySqlControl.Connect()。ImageView 底部模板下拉框的右键菜单提供保存、编辑、管理和刷新。管理器打开时选中当前模板,标题和下拉框提示标识当前存储。新建、编辑、重命名、复制、删除、排序和 .cfg 导入导出均走该存储入口。文件导入及导出不要求宿主 Solution 初始化。

POI 本地 ID 使用小于 -1 的值,-1 保留为空模板;MySQL ID 保持正数,两库同名模板独立,不自动同步。已经打开的本地模板即使 MySQL 恢复也继续读写本地;重新打开/刷新模板列表重新判定可用后端。POI 服务器保存失败时,只有已完整加载明细的模板才能保留为新的本地副本,并显示本地保存提示,不能拿服务器 ID 覆盖本地同号记录。未加载明细的服务器模板断线后禁止保存不完整副本,重新打开列表即可使用本地模板。流程按其所属存储保存,服务器流程断线时保留失败,不自动生成本地副本;其本地管理、STN 导入与运行限制见流程模板主题。其他 DAO、服务算法和 MySQL 表结构保持原有契约。

DatabaseCleanupWindow 虽使用同一命名空间,源码实际属于 Engine,是独立的多数据源维护宿主。

BaseTableDao 的同步保存及 ARVR 批次创建/回写通过 DatabaseCommandTiming 区分连接取得与命令执行。仅失败或总耗时达到 100 ms 时输出同名 INFO 事件:OpenConnectionMs 包含打开连接或连接池等待,ExecuteMs 包含客户端 SQL 调用、服务端自动提交及命令自身的连接处理,TotalMs 为两阶段总耗时。它不拆分 MySQL 服务端执行与刷盘,不额外执行 SQL,也不新增事务。Operation 标识调用,插入成功时 Result 是返回的记录 ID,ARVR 额外携带流程 Code 作为 CorrelationId;失败保留阶段并继续向原调用方抛出。日志不记录 SQL、参数或连接字符串。

设备资源、分组关联及相机/光谱仪许可证通过 LocalConfigurationDao<T> 的显式接入使用本地存储,见设备配置。按本地 ID 读取只检查目标类型与文档,缺失返回 null,目标文档损坏或版本不支持仍报错;LocalTemplateStore.Find 仅在缺失时返回 null,Read 保持缺失抛错。这不是把 BaseTableDao<T> 全部切到 SQLite:普通算法、JSON、校正及第三方模板仍有 MySQL 依赖,见模板存储边界。历史结果查询、服务端图像、SQL 维护和远程服务初始化的连接检查仍然有效,不应为了开放配置按钮一并删除。

已发布插件的注册兼容 ​

旧版 ARVR、LUX、Spectrum 等插件会在结果管理器初始化时调用 new SqliteDatabaseBrowserProvider(...) 和 DatabaseBrowserProviderRegistry.Register(IDatabaseBrowserProvider)。直接删除这些公开类型,会让仍在运行的旧插件在启动时出现类型或方法缺失。

Compatibility/LegacyDatabaseBrowserRegistration.cs 仅保留这组已发布签名:空的 IDatabaseBrowserProvider 接口、四参数 SQLite Provider 构造函数和静态 Register。它们均标记为过时;构造和注册不读取路径、不调用或持有 client factory、不保存 Provider、不连接数据库,也不贡献工具入口。这个兼容文件不提供原浏览器的查询、CRUD 或扩展能力,不能作为新增数据源接口使用。

打开连接会访问数据库,业务写入、批 SQL、迁移和清理仍会改变真实数据。只读排障不授权执行这些操作;数据归属和备份范围见数据责任地图。

MySQL 连接配置与副作用 ​

连接来源是 MySqlSetting.Instance.MySqlConfig(通过 ConfigService 管理),只保留当前一份配置,主机、端口、账号、密码和数据库名均可编辑。旧配置中的 MySqlConfigs 列表不读取、不迁移,重新保存的当前设置不再包含该列表;当前连接及其加密密码继续保留。软件配置的保存与重载见配置契约。修改配置不会自动重建所有业务模块已持有的连接,需核对各自的连接生命周期。

MySqlControl.GetConnectionString 使用配置中的 Host/Port/UserName/UserPwd/Database,统一 utf8mb4,默认连接超时 1 秒,测试连接使用 2 秒;这不是查询执行超时。当前字符串明确 SSL Mode=None、开启连接池及本地 infile 选项,不能宣传成默认加密连接。配置保存使用 IConfigSecure 的密码加解密钩子,不是外部凭据保险库,连接字符串和配置导出仍应视为敏感数据。

默认连接窗口和状态栏入口由 Engine 宿主,源码位于 Engine/ColorVision.Engine/Mysql/MySqlConnect.xaml 与 MySqlSettingProvider.cs;Database 只保留共享配置、连接状态和 DAO 能力。窗口暂时保留 ColorVision.Database.MySqlConnect 类型名,供现有 Engine 及插件源码继续使用,不代表窗口仍由 Database 程序集实现。

几个容易混淆的入口要分开:

  • TestConnect(config) 真实联网打开连接,再用参数化查询检查库是否存在;成功不验证全部表权限或业务读写,也不会调用全局 local_infile 修改。
  • Connect() 不只是探活:打开连接后查询 @@global.local_infile,为 0 时尝试 SET GLOBAL local_infile = 1;随后才设 IsConnect 并通知订阅者。它需要额外数据库权限,可能改变服务器全局设置并触发宿主后续装配,不应为文档或只读诊断随意调用。
  • MySqlConnect 窗口编辑当前配置的独立副本;测试连接使用草稿快照,取消或普通关窗不修改共享配置。确认将草稿复制到当前配置对象,启动后台 Connect 后关闭,不等待连接完成,也不直接调用配置服务落盘。服务管理器另外管理安装维护所需的 root 凭据,桌面端不再保存额外的 root 连接项。

IsConnect 是一次 Connect 流程维护的状态,不是每条 SQL 的健康证明。业务 DAO 和直接创建的 client 仍须分别核对连接门禁。

“初始化表”按 IInitTables 实体逐表补齐或创建结构,一张表失败后继续其它表并汇总失败;不会在启动时自动执行。该入口使用独立 client,将 SqlSugar 生成的独立 ALTER TABLE ... ALTER COLUMN ... SET DEFAULT (CURRENT_TIMESTAMP) 改为兼容 MySQL 5.7 的无外层括号写法,保留时间精度,不改业务 SQL 或字符串默认值。旧库出现 nd_port、version 等缺列时,需要在确认目标库和备份后手动执行初始化表;本地代码检查不代表现场迁移已完成。

业务 DAO 与批 SQL ​

BaseTableDao<T> 的业务方法主要由扩展类提供,依赖 IEntity、业务实体及 SqlSugar 映射,与实体驱动的通用查询窗口分别维护调用契约。这些扩展先检查 MySqlControl.IsConnect,不少读取失败返回空集合、null、false 或 0,写入失败返回 -1 并记录日志;因此 DAO 的“空结果”可能是连接未就绪或被吞掉的异常。具体调用者仍须核对方法返回语义,不把基类封装当成事务、重试或业务成功保证。

MySqlControl.BatchExecuteNonQuery 是直接执行批 SQL 的通道。它在一个 executor 上 BeginTransaction,逐项执行并 Commit,提交成功才返回累加影响行数;失败尝试 Rollback,并抛出含阶段、非空语句序号和错误类型/代码的 BatchExecuteNonQueryException。回滚失败保留原故障,提交后 Dispose 失败只记清理警告,不改成“未提交”。

该批入口仅按分号切分,不是理解引号、注释或存储过程的 SQL 解析器;传入的是 SQL 文本,不是通用参数化接口。MySQL DDL/隐式提交语句不能因包装了事务就声称可回滚。执行、迁移、恢复和建表必须走各自授权与恢复契约,不把这个函数作为任意 SQL 都可回滚的保证。

验证入口与缺口 ​

  • 用真实 MySQL 与设备确认现场权限及采集。
  • 单独核对目标数据库的 DDL 回滚能力。
  • 使用匹配版本的旧插件核对加载与数据库副作用。兼容层仅保留旧插件启动所需的接口。
  • 现场验收须核对账号权限、连接生命周期、恢复和数据完整性。 维护窗口契约

目标框架和依赖以 ColorVision.Database.csproj 为准:当前 WPF 多目标 net8.0-windows7.0;net10.0-windows7.0,依赖 SqlSugar、SQLite runtime、Newtonsoft.Json、log4net 和 ColorVision.UI。缺 DLL、连接失败、真实库结构不符以及业务结果未完成应分别定位;该模块本身不安装数据库服务。

基于 MIT License 发布。