数据中心同步

2026-01-05 10:16:20 +08:00
parent 0457528dd0
commit ba0ebcf273
98 changed files with 28583 additions and 0 deletions
--- a/Moncter/app/service/DataSource/DataSourceAdapterInterface.php
+++ b/Moncter/app/service/DataSource/DataSourceAdapterInterface.php
@@ -0,0 +1,73 @@
+<?php
+
+namespace app\service\DataSource;
+
+/**
+ * 数据源适配器接口
+ * 
+ * 职责：
+ * - 定义统一的数据源访问接口
+ * - 支持多种数据库类型（MySQL、PostgreSQL、MongoDB 等）
+ * - 提供基础查询能力
+ */
+interface DataSourceAdapterInterface
+{
+    /**
+     * 建立数据库连接
+     * 
+     * @param array<string, mixed> $config 数据源配置
+     * @return bool 是否连接成功
+     */
+    public function connect(array $config): bool;
+
+    /**
+     * 关闭数据库连接
+     * 
+     * @return void
+     */
+    public function disconnect(): void;
+
+    /**
+     * 测试连接是否有效
+     * 
+     * @return bool 连接是否有效
+     */
+    public function isConnected(): bool;
+
+    /**
+     * 执行查询（返回多条记录）
+     * 
+     * @param string $sql SQL 查询语句（或 MongoDB 查询条件）
+     * @param array<string, mixed> $params 查询参数（绑定参数或 MongoDB 查询选项）
+     * @return array<array<string, mixed>> 查询结果数组
+     */
+    public function query(string $sql, array $params = []): array;
+
+    /**
+     * 执行查询（返回单条记录）
+     * 
+     * @param string $sql SQL 查询语句（或 MongoDB 查询条件）
+     * @param array<string, mixed> $params 查询参数
+     * @return array<string, mixed>|null 查询结果（单条记录）或 null
+     */
+    public function queryOne(string $sql, array $params = []): ?array;
+
+    /**
+     * 批量查询（分页查询，用于大数据量场景）
+     * 
+     * @param string $sql SQL 查询语句
+     * @param array<string, mixed> $params 查询参数
+     * @param int $offset 偏移量
+     * @param int $limit 每页数量
+     * @return array<array<string, mixed>> 查询结果数组
+     */
+    public function queryBatch(string $sql, array $params = [], int $offset = 0, int $limit = 1000): array;
+
+    /**
+     * 获取数据源类型
+     * 
+     * @return string 数据源类型（mysql、postgresql、mongodb 等）
+     */
+    public function getType(): string;
+}
+