From 10b24c996509eed488cab98237f14b46f11b91d0 Mon Sep 17 00:00:00 2001 From: MarvelTiter_yaoqinglin Date: Sun, 8 Nov 2026 17:20:29 +0800 Subject: [PATCH 01/10] =?UTF-8?q?feat:=20=E6=96=B0=E5=A2=9E=E9=85=8D?= =?UTF-8?q?=E7=BD=AE=E9=A9=B1=E5=8A=A8=E7=9A=84=E6=95=B0=E6=8D=AE=E5=BA=93?= =?UTF-8?q?=E6=B3=A8=E5=86=8C=E6=9C=BA=E5=88=B6=EF=BC=88=E5=86=85=E6=A0=B8?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - `DbBaseType` 作为方言身份,新增 `IDatabaseRegistry` 可选能力接口, `RegisterDatabase` 以扩展方法挂在 `IExpressionContextSetup` 上, 不破坏第三方实现。 - `ExpressionSqlOptions` 拆为平台无关(Shared)与实例两部分, 便于后续按 TFM 差异化实现。 - 注册表(customDatabases / databaseHandlers / databaseCreators) 统一改为大小写不敏感;新增 `RegisterCreator` / `TryGetCreator` / `ApplyDatabase` / `RemoveDatabase`,支持同名键覆盖与删除。 - 新增 `DatabaseOptions` / `DatabaseDefinition` 配置模型与 `DatabaseConnectionString.Build` 通用连接串拼装: 已有连接串为底、分散字段覆盖,无分散字段时原样返回不归一化。 --- .../ExpressionSql/ExpressionSqlBuilder.cs | 158 +++--------------- .../ExpressionSqlOptions.Shared.cs | 142 ++++++++++++++++ .../ExpressionSql/ExpressionSqlOptions.cs | 70 ++++++++ src/LightORM/Interfaces/IDatabaseRegistry.cs | 18 ++ src/LightORM/LightORM.csproj | 2 +- src/LightORM/Models/DbBaseType.cs | 9 - src/LightORM/Options/DatabaseOptions.cs | 79 +++++++++ .../Options/DatabaseOptionsExtensions.cs | 137 +++++++++++++++ 8 files changed, 466 insertions(+), 149 deletions(-) create mode 100644 src/LightORM/ExpressionSql/ExpressionSqlOptions.Shared.cs create mode 100644 src/LightORM/ExpressionSql/ExpressionSqlOptions.cs create mode 100644 src/LightORM/Interfaces/IDatabaseRegistry.cs create mode 100644 src/LightORM/Options/DatabaseOptions.cs create mode 100644 src/LightORM/Options/DatabaseOptionsExtensions.cs diff --git a/src/LightORM/ExpressionSql/ExpressionSqlBuilder.cs b/src/LightORM/ExpressionSql/ExpressionSqlBuilder.cs index 30575f9b..05dd1935 100644 --- a/src/LightORM/ExpressionSql/ExpressionSqlBuilder.cs +++ b/src/LightORM/ExpressionSql/ExpressionSqlBuilder.cs @@ -1,4 +1,5 @@ using LightORM.Implements; +using LightORM.Options; using System.Collections.Concurrent; namespace LightORM; @@ -20,153 +21,26 @@ public static IExpressionContextSetup SetTableContext(this IExpressionContextSet setup.SetTableContext(createContext.Invoke()); return setup; } -} - -internal partial class ExpressionSqlOptions -{ - // 共享不可变的数据 - private readonly static ConcurrentDictionary databaseProviders = []; - private readonly static ConcurrentDictionary customDatabases = []; - private readonly static ConcurrentDictionary databaseHandlers = []; - private readonly static ConcurrentDictionary stateLessInterceptors = []; - private static int poolSize = Environment.ProcessorCount * 4; - private static int objectPoolSize = Environment.ProcessorCount * 8; - private static ILightJsonHelper? specificInstance; - - private static string? defaultDbKey; - private static bool useParameterized = true; - private static bool enableExpressionCache = true; - - static ExpressionSqlOptions() - { - Instance = new(() => new ExpressionSqlOptions()); - } - - public static void SetDatabase(string? key, DbBaseType dbBaseType, IDatabaseProvider provider) - { - var k = key ?? ConstString.Main; - if (!databaseProviders.TryGetValue(k, out _)) - { - databaseProviders.TryAdd(k, provider); - } - - if (!customDatabases.TryGetValue(dbBaseType.Name, out _)) - { - customDatabases.TryAdd(dbBaseType.Name, provider.DatabaseAdapter); - } - - if (!databaseHandlers.TryGetValue(dbBaseType.Name, out _)) - { - databaseHandlers.TryAdd(dbBaseType.Name, provider.DbHandler); - } - } - - public static void AddStateLessInterceptor(Type interceptorType, IAdoInterceptor? interceptor) - { - if (!stateLessInterceptors.TryGetValue(interceptorType, out _) && interceptor is not null) - { - stateLessInterceptors.TryAdd(interceptorType, interceptor); - } - } - - public static void SetTableContext(ITableContext context) - { - AOTSupported = true; - TableContext.StaticContext = context; - } - - public static void SetDefaultDatabase(string key) - { - defaultDbKey = key; - } - - public static void SetConnectionPoolSize(int size) - { - poolSize = size; - } - public static void SetUseParameterized(bool use) + /// + /// 登记"从配置创建 provider"的委托(key 为 ,大小写不敏感)。 + /// + /// 由各方言的空参数 UseXxx() 调用。登记只是登记,provider 的创建发生在读取配置时。 + /// + /// + public static IExpressionContextSetup RegisterDatabase(this IExpressionContextSetup setup, DbBaseType type, Func create) { - useParameterized = use; - } - - public static void SetEnableExpressionCache(bool enable) - { - enableExpressionCache = enable; - } - - public static void SetSpecificJsonHandler(ILightJsonHelper instance) - { - specificInstance = instance; - } -} - -internal partial class ExpressionSqlOptions : IJsonConfiguration -{ - public static Lazy Instance { get; } - public int PoolSize => poolSize; - public int InternalObjectPoolSize => objectPoolSize; - public bool EnableExpressionCache => enableExpressionCache; - public bool ThrowExceptionWhileMethodResolveNotMap { get; set; } - - public string DefaultDbKey - { - get - { - var d = defaultDbKey ?? ConstString.Main; - if (!DatabaseProviders.ContainsKey(d)) - { - throw new KeyNotFoundException($"数据库 '{d}' 未注册. 使用'SetDefault'设置默认值."); - } - - return d; - } - } - - public bool UseParameterized => useParameterized; - public IServiceProvider? Services { get; set; } - private readonly ICollection allInterceptors; - public ICollection Interceptors => allInterceptors; - public ConcurrentDictionary DatabaseProviders { get; } - public ConcurrentDictionary CustomDatabases { get; } - public ConcurrentDictionary DatabaseHandlers { get; } - public Func? Serializer { get; set; } - public Func? Deserializer { get; set; } - public Func? DeserializerBytes { get; set; } - - public ExpressionSqlOptions() - { - DatabaseProviders = databaseProviders; - CustomDatabases = customDatabases; - DatabaseHandlers = databaseHandlers; - allInterceptors = stateLessInterceptors.Values; - } - - public ILightJsonHelper GetJsonHandler() - { - if (specificInstance is not null) return specificInstance; - if (Serializer is null || Deserializer is null || DeserializerBytes is null) + if (setup is not IDatabaseRegistry registry) { - throw new LightOrmException("未配置ILightJsonHelper实例的情况下,Serializer和Deserializer和DeserializerBytes不能为null"); + throw new LightOrmException($"当前 IExpressionContextSetup 实现({setup?.GetType().Name ?? "null"})不支持配置驱动注册。"); } - return specificInstance ??= new DefaultJsonHelper(Serializer, Deserializer, DeserializerBytes); - } - - public ExpressionSqlOptions(IEnumerable interceptors) : this() - { - if (interceptors.Any()) - { - allInterceptors = [.. interceptors, .. stateLessInterceptors.Values]; - } - else - { - allInterceptors = stateLessInterceptors.Values; - } + registry.RegisterDatabase(type, create); + return setup; } } -internal partial class ExpressionOptionBuilder : IExpressionContextSetup +internal partial class ExpressionOptionBuilder : IExpressionContextSetup, IDatabaseRegistry { public bool ThrowExceptionWhileMethodResolveNotMap { @@ -239,4 +113,10 @@ public IExpressionContextSetup TableConfiguration(Action action) throw new NotSupportedException(); } + public void RegisterDatabase(DbBaseType type, Func create) + { + ArgumentNullException.ThrowIfNull(type); + LightOrmException.ThrowIfNull(create, "create 不能为 null"); + ExpressionSqlOptions.RegisterCreator(type.Name, create); + } } \ No newline at end of file diff --git a/src/LightORM/ExpressionSql/ExpressionSqlOptions.Shared.cs b/src/LightORM/ExpressionSql/ExpressionSqlOptions.Shared.cs new file mode 100644 index 00000000..46249e62 --- /dev/null +++ b/src/LightORM/ExpressionSql/ExpressionSqlOptions.Shared.cs @@ -0,0 +1,142 @@ +using LightORM.Implements; +using LightORM.Options; +using System.Collections.Concurrent; + +namespace LightORM; + +internal partial class ExpressionSqlOptions +{ + // 共享不可变的数据 + private readonly static ConcurrentDictionary databaseProviders = []; + private readonly static ConcurrentDictionary customDatabases = new(StringComparer.OrdinalIgnoreCase); + private readonly static ConcurrentDictionary databaseHandlers = new(StringComparer.OrdinalIgnoreCase); + private readonly static ConcurrentDictionary stateLessInterceptors = []; + private readonly static ConcurrentDictionary> databaseCreators = new(StringComparer.OrdinalIgnoreCase); + private static int poolSize = Environment.ProcessorCount * 4; + private static int objectPoolSize = Environment.ProcessorCount * 8; + private static ILightJsonHelper? specificInstance; + + private static string? defaultDbKey; + private static bool useParameterized = true; + private static bool enableExpressionCache = true; + + static ExpressionSqlOptions() + { + Instance = new(() => new ExpressionSqlOptions()); + } + + public static void RegisterCreator(string name, Func action) + { + _ = databaseCreators.GetOrAdd(name, action); + } + + /// 已登记的方言名,用于配置写错时给出可读的错误信息。 + internal static IEnumerable CreatorNames => databaseCreators.Keys; + + public static void SetDatabase(string? key, DbBaseType dbBaseType, IDatabaseProvider provider) + { + var k = key ?? ConstString.Main; + _ = databaseProviders.TryAdd(k, provider); + _ = customDatabases.TryAdd(dbBaseType.Name, provider.DatabaseAdapter); + _ = databaseHandlers.TryAdd(dbBaseType.Name, provider.DbHandler); + } + + public static void AddStateLessInterceptor(Type interceptorType, IAdoInterceptor? interceptor) + { + if (!stateLessInterceptors.TryGetValue(interceptorType, out _) && interceptor is not null) + { + stateLessInterceptors.TryAdd(interceptorType, interceptor); + } + } + + public static void SetTableContext(ITableContext context) + { + AOTSupported = true; + TableContext.StaticContext = context; + } + + public static void SetDefaultDatabase(string key) + { + defaultDbKey = key; + } + + public static void SetConnectionPoolSize(int size) + { + poolSize = size; + } + + public static void SetUseParameterized(bool use) + { + useParameterized = use; + } + + public static void SetEnableExpressionCache(bool enable) + { + enableExpressionCache = enable; + } + + public static void SetSpecificJsonHandler(ILightJsonHelper instance) + { + specificInstance = instance; + } + + internal static bool TryGetCreator(string? type, out Func? creator) + { + creator = null; + return !string.IsNullOrWhiteSpace(type) && databaseCreators.TryGetValue(type!, out creator); + } + + /// + /// 应用一个来自配置的数据库实例。 + /// + /// = true 时强制覆盖同 key 的 provider,并让 adapter / handler 跟随新的 provider; + /// 否则保持"先注册者胜"的旧语义。 + /// + /// + /// adapter / handler 按 只存一份,所以后注册的 provider 如果方言相同, + /// 必须覆盖才能让它自己的能力位(版本探测结果、标识符引用开关等)生效。 + /// + /// + internal static void ApplyDatabase(string? key, DbBaseType dbBaseType, IDatabaseProvider provider, bool replace) + { + ArgumentNullException.ThrowIfNull(dbBaseType); + LightOrmException.ThrowIfNull(provider, "provider 不能为 null"); + + var k = key ?? ConstString.Main; + if (replace) + { + databaseProviders[k] = provider; + customDatabases[dbBaseType.Name] = provider.DatabaseAdapter; + databaseHandlers[dbBaseType.Name] = provider.DbHandler; + return; + } + + _ = databaseProviders.TryAdd(k, provider); + _ = customDatabases.TryAdd(dbBaseType.Name, provider.DatabaseAdapter); + _ = databaseHandlers.TryAdd(dbBaseType.Name, provider.DbHandler); + } + + /// + /// 移除一个数据库实例;当没有其它实例复用同一方言时,一并移除它的 adapter / handler。 + /// + internal static bool RemoveDatabase(string key) + { + if (!databaseProviders.TryRemove(key, out var provider)) + { + return false; + } + + var typeName = provider.DbBaseType.Name; + foreach (var item in databaseProviders.Values) + { + if (string.Equals(item.DbBaseType.Name, typeName, StringComparison.OrdinalIgnoreCase)) + { + return true; + } + } + + _ = customDatabases.TryRemove(typeName, out _); + _ = databaseHandlers.TryRemove(typeName, out _); + return true; + } +} diff --git a/src/LightORM/ExpressionSql/ExpressionSqlOptions.cs b/src/LightORM/ExpressionSql/ExpressionSqlOptions.cs new file mode 100644 index 00000000..ebc6e0fd --- /dev/null +++ b/src/LightORM/ExpressionSql/ExpressionSqlOptions.cs @@ -0,0 +1,70 @@ +using LightORM.Implements; +using System.Collections.Concurrent; + +namespace LightORM; + +internal partial class ExpressionSqlOptions : IJsonConfiguration +{ + public static Lazy Instance { get; } + public int PoolSize => poolSize; + public int InternalObjectPoolSize => objectPoolSize; + public bool EnableExpressionCache => enableExpressionCache; + public bool ThrowExceptionWhileMethodResolveNotMap { get; set; } + public string DefaultDbKey + { + get + { + var d = defaultDbKey ?? ConstString.Main; + if (!DatabaseProviders.ContainsKey(d)) + { + throw new KeyNotFoundException($"数据库 '{d}' 未注册. 使用'SetDefault'设置默认值."); + } + + return d; + } + } + + public bool UseParameterized => useParameterized; + public IServiceProvider? Services { get; set; } + private readonly ICollection allInterceptors; + public ICollection Interceptors => allInterceptors; + public ConcurrentDictionary DatabaseProviders { get; } + public ConcurrentDictionary CustomDatabases { get; } + public ConcurrentDictionary DatabaseHandlers { get; } + public Func? Serializer { get; set; } + public Func? Deserializer { get; set; } + public Func? DeserializerBytes { get; set; } + + public ExpressionSqlOptions() + { + DatabaseProviders = databaseProviders; + CustomDatabases = customDatabases; + DatabaseHandlers = databaseHandlers; + allInterceptors = stateLessInterceptors.Values; + } + + public ILightJsonHelper GetJsonHandler() + { + if (specificInstance is not null) return specificInstance; + if (Serializer is null || Deserializer is null || DeserializerBytes is null) + { + throw new LightOrmException("未配置ILightJsonHelper实例的情况下,Serializer和Deserializer和DeserializerBytes不能为null"); + } + + return specificInstance ??= new DefaultJsonHelper(Serializer, Deserializer, DeserializerBytes); + } + + + + public ExpressionSqlOptions(IEnumerable interceptors) : this() + { + if (interceptors.Any()) + { + allInterceptors = [.. interceptors, .. stateLessInterceptors.Values]; + } + else + { + allInterceptors = stateLessInterceptors.Values; + } + } +} diff --git a/src/LightORM/Interfaces/IDatabaseRegistry.cs b/src/LightORM/Interfaces/IDatabaseRegistry.cs new file mode 100644 index 00000000..32243158 --- /dev/null +++ b/src/LightORM/Interfaces/IDatabaseRegistry.cs @@ -0,0 +1,18 @@ +using LightORM.Options; + +namespace LightORM.Interfaces; + +/// +/// 可选的扩展能力:支持"从配置创建 provider"的注册。 +/// +/// 单独放在一个接口里而不是塞进 ,是为了不给第三方实现增加破坏性变更; +/// 使用方请调用扩展方法 IExpressionContextSetupEx.RegisterDatabase(...),它会做能力检测。 +/// +/// +public interface IDatabaseRegistry +{ + /// + /// 登记某种方言的 provider 工厂, 的 用于匹配配置文件里的 Type(大小写不敏感)。 + /// + void RegisterDatabase(DbBaseType type, Func create); +} diff --git a/src/LightORM/LightORM.csproj b/src/LightORM/LightORM.csproj index 980f0f9e..76cc7042 100644 --- a/src/LightORM/LightORM.csproj +++ b/src/LightORM/LightORM.csproj @@ -1,5 +1,5 @@  - + net462;netstandard2.0;net8.0;net10.0; MT.LightORM diff --git a/src/LightORM/Models/DbBaseType.cs b/src/LightORM/Models/DbBaseType.cs index 95476906..65df1d6c 100644 --- a/src/LightORM/Models/DbBaseType.cs +++ b/src/LightORM/Models/DbBaseType.cs @@ -1,12 +1,4 @@ namespace LightORM; -//public enum DbBaseType -//{ -// SqlServer = 0, -// SqlServer2012 = 1, -// Oracle = 2, -// MySql = 3, -// Sqlite = 4, -//} public record DbBaseType(string Name) { @@ -15,5 +7,4 @@ public record DbBaseType(string Name) public static DbBaseType Oracle { get; } = new DbBaseType("Oracle"); public static DbBaseType SqlServer { get; } = new DbBaseType("SqlServer"); public static DbBaseType PostgreSQL { get; } = new DbBaseType("PostgreSQL"); - //public static DbBaseType Dameng { get; } = new DbBaseType("Dameng"); } diff --git a/src/LightORM/Options/DatabaseOptions.cs b/src/LightORM/Options/DatabaseOptions.cs new file mode 100644 index 00000000..a3c708a8 --- /dev/null +++ b/src/LightORM/Options/DatabaseOptions.cs @@ -0,0 +1,79 @@ +namespace LightORM.Options; + +/// +/// 配置文件里的一个数据库实例。 +/// +/// 与代码路径的 DataBaseOption<T> 是两套模型: +/// 这里只放"能跨方言表达"的字段,方言私有配置走 , +/// 由各自 provider 自己解释。不要试图在这里穷举所有 provider 的选项。 +/// +/// +public class DatabaseOptions +{ + /// 实例名,同时是 DatabaseProviders 的 key;为空时落到 MainDb。 + public string? Key { get; set; } + + /// 连接定义。缺失时该条目被忽略(并给出告警)。 + public DatabaseDefinition? Option { get; set; } +} + +/// +/// 通用连接定义。 与"分散字段"同时存在时, +/// 以连接串为底、分散字段逐项覆盖。 +/// +public class DatabaseDefinition +{ + /// 方言标识,必须与 一致(大小写不敏感)。 + public string? Type { get; set; } + + /// 完整连接串。可缺省,此时由 / 等字段拼装。 + public string? ConnectionString { get; set; } + + public string? UserId { get; set; } + public string? Password { get; set; } + public string? Server { get; set; } + public int? Port { get; set; } + public string? Database { get; set; } + + /// + /// 完整的数据源标识,优先级高于 : + /// Oracle 的 TNS 别名 / EZ Connect 串、Sqlite 的库文件路径、SqlServer 的 Data Source。 + /// + public string? DataSource { get; set; } + + /// Oracle 服务名。与 (+ )组合成 host:port/service。 + public string? ServiceName { get; set; } + + /// Oracle SID。与 (+ )组合成完整连接描述符;与 二选一。 + public string? Sid { get; set; } + + /// 从库连接串(读写分离)。 + public string[]? SlaveConnectionStrings { get; set; } + + /// 是否引用标识符("Name")。null 表示由方言默认值决定。 + public bool? IsUseIdentifierQuote { get; set; } + + /// 显式指定服务端版本(如 "8.0")。有值时不发起版本探测;ToSql 纯生成场景应填。 + public string? SpecificVersion { get; set; } + + /// 是否允许构造期后台探测版本。null 表示用基类默认(true)。 + public bool? DetectVersion { get; set; } + + /// 默认字符串长度(字符数)。null 表示用基类默认。 + public int? DefaultStringLength { get; set; } + + /// + /// 方言私有配置。键名由各 provider 自己定义,例如达梦的 TableSpace / GenerateUserId。 + /// + public Dictionary? Settings { get; set; } + + /// 取一个方言私有配置值。 + public string? GetSetting(string name) + => Settings is not null && Settings.TryGetValue(name, out var value) ? value : null; +} + +/// 配置文件的根对象。 +public class DatabaseList +{ + public List LightOrmDatabases { get; set; } = []; +} diff --git a/src/LightORM/Options/DatabaseOptionsExtensions.cs b/src/LightORM/Options/DatabaseOptionsExtensions.cs new file mode 100644 index 00000000..274f4a76 --- /dev/null +++ b/src/LightORM/Options/DatabaseOptionsExtensions.cs @@ -0,0 +1,137 @@ +using LightORM.Models; +using System.Data.Common; + +namespace LightORM.Options; + +/// +/// 配置模型 → 代码模型 DataBaseOption<T> 的通用搬运。 +/// +/// 方言的 Create(DatabaseOptions) 只需要拼好连接串,剩下的通用字段(从库、标识符引用、 +/// 版本相关)由这里统一处理,不要在各方言里各抄一遍。 +/// +/// +public static class DatabaseOptionsExtensions +{ + /// + /// 把配置项转换成代码路径的 。 + /// + /// 配置项。 + /// 已由方言拼装好的主库连接串。 + public static DataBaseOption ToDbOption(this DatabaseOptions database, string connectionString) + where T : TableOptions, new() + { + LightOrmException.ThrowIfNull(database, "数据库配置不能为 null"); + var definition = database.Option + ?? throw new LightOrmException($"数据库 '{database.Key}' 缺少 Option 配置。"); + + var dbOption = new DataBaseOption + { + DbKey = database.Key, + MasterConnectionString = connectionString, + SalveConnectionStrings = definition.SlaveConnectionStrings, + }; + + if (definition.IsUseIdentifierQuote is { } useQuote) + { + _ = dbOption.UseIdentifierQuote(useQuote); + } + + definition.ApplyTo(dbOption.GenerateOption); + return dbOption; + } + + /// + /// 把与方言无关的通用选项(显式版本 / 是否探测 / 默认字符串长度)写到 。 + /// + public static void ApplyTo(this DatabaseDefinition definition, TableOptions options) + { + ArgumentNullException.ThrowIfNull(definition); + LightOrmException.ThrowIfNull(options, "options 不能为 null"); + + if (!string.IsNullOrWhiteSpace(definition.SpecificVersion)) + { + if (!Version.TryParse(definition.SpecificVersion, out var version)) + { + throw new LightOrmException($"SpecificVersion '{definition.SpecificVersion}' 不是合法版本号。"); + } + + options.SpecificVersion = version; + } + + if (definition.DetectVersion is { } detectVersion) + { + options.DetectVersion = detectVersion; + } + + if (definition.DefaultStringLength is { } stringLength) + { + options.DefaultStringLength = stringLength; + } + } + + /// + /// 是否提供了"连接串之外"的分散字段。统一在这里判断,方言不用各写一遍 + /// (新增字段时只改这一处,避免某个方言悄悄漏掉)。 + /// + public static bool HasSplitConnectionFields(this DatabaseDefinition definition) + { + ArgumentNullException.ThrowIfNull(definition); + + return definition.Server is not null + || definition.Port is not null + || definition.UserId is not null + || definition.Password is not null + || definition.Database is not null + || definition.DataSource is not null + || definition.ServiceName is not null + || definition.Sid is not null; + } +} + +/// +/// 连接串拼装的通用外壳:ConnectionString 为底 + 分散字段逐项覆盖。 +/// +/// 各方言的差异只有"字段 → builder 属性"的映射(键名 / 有的方言没有某些字段), +/// 由调用方通过 applyFields 表达;overlay 与空值校验在这里统一做。 +/// +/// +public static class DatabaseConnectionString +{ + /// + /// 构建连接串。 + /// + /// 配置项名,仅用于异常信息。 + /// 连接定义。 + /// 方言的 builder 工厂;参数非 null 时用它作为底。 + /// 把分散字段写到 builder 上;只覆盖有值的字段。 + public static string Build( + string? key, + DatabaseDefinition definition, + Func factory, + Action applyFields) + where T : DbConnectionStringBuilder + { + ArgumentNullException.ThrowIfNull(definition); + ArgumentNullException.ThrowIfNull(factory); + ArgumentNullException.ThrowIfNull(applyFields); + + var existing = string.IsNullOrWhiteSpace(definition.ConnectionString) ? null : definition.ConnectionString; + + // 没有分散字段就别让 builder 重新归一化连接串(键名大小写/顺序都会变) + if (existing is not null && !definition.HasSplitConnectionFields()) + { + return existing; + } + + var builder = factory(existing); + applyFields(builder, definition); + + if (builder.Count == 0) + { + throw new LightOrmException( + $"数据库 '{key}' 既没有 ConnectionString,也没有可用于拼装的字段(Server / DataSource / ServiceName / UserId / Database ...)。"); + } + + return builder.ConnectionString; + } +} From 03614bee553b9833caefd4b6303eff1f41de398a Mon Sep 17 00:00:00 2001 From: MarvelTiter_yaoqinglin Date: Sun, 8 Nov 2026 17:20:34 +0800 Subject: [PATCH 02/10] =?UTF-8?q?feat:=20DI=20=E6=89=A9=E5=B1=95=E6=94=AF?= =?UTF-8?q?=E6=8C=81=E4=BB=8E=20IConfiguration=20=E6=B3=A8=E5=86=8C?= =?UTF-8?q?=E6=95=B0=E6=8D=AE=E5=BA=93=E5=B9=B6=E7=83=AD=E9=87=8D=E8=BD=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - `AddLightOrm` 增加可选 `IConfiguration` 参数:配置节 `LightOrmDatabases` 经 AOT 友好的手写绑定(`BindingExtensions`)映射为 `DatabaseList`。 - 新增 `DatabaseListReloader`:构造期同步一次 `CurrentValue`(修复此前 "初始配置永不生效"),随后订阅 `OnChange`;重载在 try/catch 内执行并 记录日志,避免文件监听线程被异常打断。 - 重载支持覆盖同名键、以及删除配置中已消失的库(按 key 差集调用 `RemoveDatabase`);`Type` 找不到登记过的创建器时抛出可读异常并列出 已支持方言名。 - 移除 `AddLightOrm` 内的静态 `reloadToken` / `initialLoaded`,订阅生命周期 交给容器,随 provider 释放。 --- .../BindingExtensions.cs | 242 ++++++++++++++++++ .../DatabaseListReloader.cs | 95 +++++++ .../IoCExtensions.cs | 51 ++-- ...tORM.Extensions.DependencyInjection.csproj | 4 +- 4 files changed, 376 insertions(+), 16 deletions(-) create mode 100644 src/LightORM.Extensions.DependencyInjection/BindingExtensions.cs create mode 100644 src/LightORM.Extensions.DependencyInjection/DatabaseListReloader.cs diff --git a/src/LightORM.Extensions.DependencyInjection/BindingExtensions.cs b/src/LightORM.Extensions.DependencyInjection/BindingExtensions.cs new file mode 100644 index 00000000..86054a0d --- /dev/null +++ b/src/LightORM.Extensions.DependencyInjection/BindingExtensions.cs @@ -0,0 +1,242 @@ +using LightORM.Options; +using Microsoft.Extensions.Configuration; +using System.Globalization; + +namespace LightORM; + +/// +/// 手写的配置绑定器(等价于 EnableConfigurationBindingGenerator 的产物,但收窄到本库需要的类型)。 +/// +/// 为什么不用反射版 Binder:services.Configure<T>(IConfiguration) 走的是反射绑定,AOT/裁剪下会失效。 +/// 这个绑定器只认下列类型 —— 给 / 加属性时, +/// 必须同步改这里,否则新属性会被静默忽略。 +/// +/// +internal static class BindingExtensions +{ + #region 入口 + /// 把配置绑定到 (节名 LightOrmDatabases)。 + public static void Bind_DatabaseList(this IConfiguration configuration, DatabaseList instance) + { + ArgumentNullException.ThrowIfNull(configuration); + ArgumentNullException.ThrowIfNull(instance); + + BindCore(configuration, ref instance, defaultValueIfNotFound: false, binderOptions: null); + } + #endregion + + #region 核心绑定 + private readonly static Lazy> s_configKeys_DatabaseDefinition = new(() => new HashSet(StringComparer.OrdinalIgnoreCase) + { + "Type", "ConnectionString", "UserId", "Password", "Server", "Port", "Database", + "DataSource", "ServiceName", "Sid", + "SlaveConnectionStrings", "IsUseIdentifierQuote", "SpecificVersion", "DetectVersion", "DefaultStringLength", "Settings" + }); + private readonly static Lazy> s_configKeys_DatabaseOptions = new(() => new HashSet(StringComparer.OrdinalIgnoreCase) { "Key", "Option" }); + private readonly static Lazy> s_configKeys_DatabaseList = new(() => new HashSet(StringComparer.OrdinalIgnoreCase) { "LightOrmDatabases" }); + + public static void BindCore(IConfiguration configuration, ref DatabaseDefinition instance, bool defaultValueIfNotFound, BinderOptions? binderOptions) + { + ValidateConfigurationKeys(typeof(DatabaseDefinition), s_configKeys_DatabaseDefinition, configuration, binderOptions); + + var target = instance; + + // 字符串 + BindString(configuration, "Type", value => target.Type = value); + BindString(configuration, "ConnectionString", value => target.ConnectionString = value); + BindString(configuration, "UserId", value => target.UserId = value); + BindString(configuration, "Password", value => target.Password = value); + BindString(configuration, "Server", value => target.Server = value); + BindString(configuration, "Database", value => target.Database = value); + BindString(configuration, "DataSource", value => target.DataSource = value); + BindString(configuration, "ServiceName", value => target.ServiceName = value); + BindString(configuration, "Sid", value => target.Sid = value); + BindString(configuration, "SpecificVersion", value => target.SpecificVersion = value); + + // 整数 + BindInt(configuration, "Port", value => target.Port = value); + BindInt(configuration, "DefaultStringLength", value => target.DefaultStringLength = value); + + // 布尔 + BindBool(configuration, "IsUseIdentifierQuote", value => target.IsUseIdentifierQuote = value); + BindBool(configuration, "DetectVersion", value => target.DetectVersion = value); + + var slaveSection = configuration.GetSection("SlaveConnectionStrings"); + if (HasChildren(slaveSection)) + { + var slaves = new List(); + foreach (var item in slaveSection.GetChildren()) + { + if (item.Value is { } value) + { + slaves.Add(value); + } + } + + target.SlaveConnectionStrings = [.. slaves]; + } + + var settingsSection = configuration.GetSection("Settings"); + if (HasChildren(settingsSection)) + { + var settings = target.Settings ?? []; + foreach (var item in settingsSection.GetChildren()) + { + // 只支持一层:值是字符串。嵌套结构请用强类型替代表达 + settings[item.Key] = item.Value ?? string.Empty; + } + + target.Settings = settings; + } + + instance = target; + } + + public static void BindCore(IConfiguration configuration, ref DatabaseOptions instance, bool defaultValueIfNotFound, BinderOptions? binderOptions) + { + ValidateConfigurationKeys(typeof(DatabaseOptions), s_configKeys_DatabaseOptions, configuration, binderOptions); + + if (TryGetConfigurationValue(configuration, "Key", out var key)) + { + instance.Key = key; + } + + var optionSection = configuration.GetSection("Option"); + if (HasChildren(optionSection)) + { + var definition = instance.Option ?? new DatabaseDefinition(); + BindCore(optionSection, ref definition, defaultValueIfNotFound: false, binderOptions); + instance.Option = definition; + } + } + + public static void BindCore(IConfiguration configuration, ref List instance, bool defaultValueIfNotFound, BinderOptions? binderOptions) + { + foreach (var section in configuration.GetChildren()) + { + // 跳过标量节点,避免把 key: value 形式的杂项当成数据库条目 + if (!string.IsNullOrEmpty(section.Value) && !section.GetChildren().Any()) + { + continue; + } + + var value = new DatabaseOptions(); + BindCore(section, ref value, defaultValueIfNotFound: false, binderOptions); + instance.Add(value); + } + } + + public static void BindCore(IConfiguration configuration, ref DatabaseList instance, bool defaultValueIfNotFound, BinderOptions? binderOptions) + { + ValidateConfigurationKeys(typeof(DatabaseList), s_configKeys_DatabaseList, configuration, binderOptions); + + var section = configuration.GetSection("LightOrmDatabases"); + if (HasChildren(section)) + { + // options 每次重建时 instance 都是新建的,这里直接绑到新列表, + // 不要在已有列表上追加(否则会累积出重复条目)。 + var list = new List(); + BindCore(section, ref list, defaultValueIfNotFound: false, binderOptions); + instance.LightOrmDatabases = list; + } + } + #endregion + + #region 基础设施 + public static bool TryGetConfigurationValue(IConfiguration configuration, string key, out string? value) + { + if (configuration is ConfigurationSection section) + { + return section.TryGetValue(key, out value); + } + + value = configuration[key]; + return value is not null; + } + + private static bool HasChildren(IConfigurationSection section) + { + foreach (var _ in section.GetChildren()) + { + return true; + } + + return false; + } + + private static void BindString(IConfiguration configuration, string key, Action set) + { + if (TryGetConfigurationValue(configuration, key, out var value)) + { + set(value); + } + } + + private static void BindInt(IConfiguration configuration, string key, Action set) + { + if (!TryGetConfigurationValue(configuration, key, out var value)) + { + return; + } + + set(string.IsNullOrEmpty(value) ? null : ParseInt(value, configuration.GetSection(key).Path)); + } + + private static void BindBool(IConfiguration configuration, string key, Action set) + { + if (!TryGetConfigurationValue(configuration, key, out var value)) + { + return; + } + + set(string.IsNullOrEmpty(value) ? null : ParseBool(value, configuration.GetSection(key).Path)); + } + + public static void ValidateConfigurationKeys(Type type, Lazy> keys, IConfiguration configuration, BinderOptions? binderOptions) + { + if (binderOptions?.ErrorOnUnknownConfiguration is not true) + { + return; + } + + List? unknown = null; + foreach (var section in configuration.GetChildren()) + { + if (!keys.Value.Contains(section.Key)) + { + (unknown ??= []).Add($"'{section.Key}'"); + } + } + + if (unknown is not null) + { + throw new InvalidOperationException( + $"'ErrorOnUnknownConfiguration' was set on the provided BinderOptions, but the following properties were not found on the instance of {type}: {string.Join(", ", unknown)}"); + } + } + + public static int ParseInt(string value, string? path) + { + try + { + return int.Parse(value, NumberStyles.Integer, CultureInfo.InvariantCulture); + } + catch (Exception exception) + { + throw new InvalidOperationException($"Failed to convert configuration value '{value}' at '{path}' to type '{typeof(int)}'.", exception); + } + } + + public static bool ParseBool(string value, string? path) + { + try + { + return bool.Parse(value); + } + catch (Exception exception) + { + throw new InvalidOperationException($"Failed to convert configuration value '{value}' at '{path}' to type '{typeof(bool)}'.", exception); + } + } + #endregion +} diff --git a/src/LightORM.Extensions.DependencyInjection/DatabaseListReloader.cs b/src/LightORM.Extensions.DependencyInjection/DatabaseListReloader.cs new file mode 100644 index 00000000..1161605e --- /dev/null +++ b/src/LightORM.Extensions.DependencyInjection/DatabaseListReloader.cs @@ -0,0 +1,95 @@ +using LightORM.Options; +using Microsoft.Extensions.DependencyInjection; +using Microsoft.Extensions.Logging; +using Microsoft.Extensions.Options; + +namespace LightORM; + +/// +/// 把配置文件里的数据库条目同步到 LightORM 的全局注册表。 +/// +/// 生命周期跟随容器:构造时完成首次加载并订阅 , +/// 容器 dispose 时退订。不要把这个订阅做成 static 字段 —— 多容器 / 多宿主会互相顶掉,且永不释放。 +/// +/// +/// 语义:配置是权威来源。配置项覆盖同 key 的既有 provider(所以改连接串会生效), +/// 配置里被删掉的 key 会被移除;由代码显式 SetDatabase 注册、但不出现在配置里的库不动。 +/// +/// +internal sealed class DatabaseListReloader : IDisposable +{ + private readonly IOptionsMonitor monitor; + private readonly ILogger? logger; + private readonly IDisposable? subscription; + private readonly object gate = new(); + private HashSet configuredKeys = new(StringComparer.Ordinal); + + public DatabaseListReloader(IOptionsMonitor monitor, IServiceProvider services) + { + this.monitor = monitor; + logger = services.GetService>(); + + // 首次加载:配置写错在这里就暴露,而不是等到第一次查库 + Sync(this.monitor.CurrentValue); + + subscription = monitor.OnChange(list => + { + try + { + Sync(list); + } + catch (Exception ex) + { + // 热重载发生在文件监听线程,不能让异常把它带崩;记录后沿用当前内存状态 + logger?.LogError(ex, "重新加载 LightORM 数据库配置失败,沿用当前已注册的数据库。"); + } + }); + } + + private void Sync(DatabaseList list) + { + lock (gate) + { + var next = new HashSet(StringComparer.Ordinal); + foreach (var item in list.LightOrmDatabases) + { + var definition = item.Option; + if (definition is null) + { + logger?.LogWarning("数据库配置项 '{Key}' 缺少 Option,已跳过。", item.Key); + continue; + } + + if (string.IsNullOrWhiteSpace(definition.Type)) + { + logger?.LogWarning("数据库配置项 '{Key}' 缺少 Type,已跳过。", item.Key); + continue; + } + + if (!ExpressionSqlOptions.TryGetCreator(definition.Type, out var create)) + { + throw new LightOrmException( + $"数据库 '{item.Key}' 的 Type '{definition.Type}' 没有注册创建器。" + + $"请先在 AddLightOrm 中调用对应方言的 UseXxx()。已注册:{string.Join(", ", ExpressionSqlOptions.CreatorNames)}"); + } + + // 创建失败(缺连接串等)直接抛:初始加载时让宿主启动失败,比运行期 KeyNotFound 好查 + var provider = create!.Invoke(item); + ExpressionSqlOptions.ApplyDatabase(item.Key, provider.DbBaseType, provider, replace: true); + _ = next.Add(item.Key ?? ConstString.Main); + } + + foreach (var stale in configuredKeys) + { + if (!next.Contains(stale)) + { + _ = ExpressionSqlOptions.RemoveDatabase(stale); + } + } + + configuredKeys = next; + } + } + + public void Dispose() => subscription?.Dispose(); +} diff --git a/src/LightORM.Extensions.DependencyInjection/IoCExtensions.cs b/src/LightORM.Extensions.DependencyInjection/IoCExtensions.cs index 637fa4b3..f0e8ff89 100644 --- a/src/LightORM.Extensions.DependencyInjection/IoCExtensions.cs +++ b/src/LightORM.Extensions.DependencyInjection/IoCExtensions.cs @@ -1,8 +1,12 @@ using LightORM.ExpressionSql; using LightORM.Implements; using LightORM.Interfaces; +using LightORM.Options; using LightORM.Repository; +using Microsoft.Extensions.Configuration; using Microsoft.Extensions.DependencyInjection; +using Microsoft.Extensions.DependencyInjection.Extensions; +using Microsoft.Extensions.Options; using System.Diagnostics.CodeAnalysis; namespace LightORM; @@ -11,18 +15,37 @@ public static class IoCExtensions { internal static WeakReference? WeakServices { get; set; } - public static IServiceCollection AddLightOrm(this IServiceCollection services, Action options) + /// + /// 注册 LightORM。 + /// + /// 服务集合。 + /// 代码方式的配置(优先级低于配置文件:配置文件里的同 key 条目会覆盖它)。 + /// + /// 提供 LightOrmDatabases 节的配置。传入后会: + /// ① 在首次解析 时按配置注册数据库; + /// ② 订阅文件变更,配置变化后覆盖/新增/移除对应的库(连接串改动会生效)。 + /// + public static IServiceCollection AddLightOrm(this IServiceCollection services, Action options, IConfiguration? configuration = null) { - var builder = new ExpressionOptionBuilder - { - }; + var builder = new ExpressionOptionBuilder(); WeakServices = new(services); options(builder); - services.AddScoped(provider => + + if (configuration is not null) { - var option = Build(provider); - return option; - }); + services.TryAddSingleton(configuration); + // AOT 友好的手写绑定(BindingExtensions.cs)。用 lambda 而不是 method group, + // 这样 DatabaseList 类型变化时是编译期错误而不是运行期 InvalidCastException。 + services.Configure(list => configuration.Bind_DatabaseList(list)); + // IOptionsMonitor 依赖 change token 才会在文件变更时重算。 + // 显式注册,不要靠"再 Configure 一次"的副作用来拿 token。 + services.AddSingleton>( + new ConfigurationChangeTokenSource(configuration)); + // 单例:首次构造时做初始加载并订阅变更,容器 dispose 时退订。 + services.AddSingleton(); + } + + services.AddScoped(Build); services.AddScoped(typeof(ILightOrmRepository<>), typeof(DefaultRepository<>)); services.AddScoped(); return services; @@ -30,12 +53,10 @@ public static IServiceCollection AddLightOrm(this IServiceCollection services, A private static ExpressionSqlOptions Build(IServiceProvider provider) { - if (provider is not null) - { - var interceptor = provider.GetServices(); - return new(interceptor); - } - return new(); + // 触发单例构造:初始加载 + 订阅变更都在 DatabaseListReloader 里完成。 + // 没传 configuration 时它没被注册,GetService 返回 null,行为与以前一致。 + _ = provider.GetService(); + return new(provider.GetServices()); } } @@ -66,6 +87,6 @@ public IExpressionContextSetup UseInterceptor() return setup; } - + } } diff --git a/src/LightORM.Extensions.DependencyInjection/LightORM.Extensions.DependencyInjection.csproj b/src/LightORM.Extensions.DependencyInjection/LightORM.Extensions.DependencyInjection.csproj index d284c470..6c996b88 100644 --- a/src/LightORM.Extensions.DependencyInjection/LightORM.Extensions.DependencyInjection.csproj +++ b/src/LightORM.Extensions.DependencyInjection/LightORM.Extensions.DependencyInjection.csproj @@ -1,5 +1,5 @@  - + net462;netstandard2.0;net8.0;net10.0; enable @@ -9,8 +9,10 @@ + + From ff90fd77cd5a99e2bccb6851bf088fc27daaa02d Mon Sep 17 00:00:00 2001 From: MarvelTiter_yaoqinglin Date: Sun, 8 Nov 2026 17:20:45 +0800 Subject: [PATCH 03/10] =?UTF-8?q?feat:=20=E4=B8=83=E4=B8=AA=E6=96=B9?= =?UTF-8?q?=E8=A8=80=E6=8E=A5=E5=85=A5=E9=85=8D=E7=BD=AE=E9=A9=B1=E5=8A=A8?= =?UTF-8?q?=E7=9A=84=E6=95=B0=E6=8D=AE=E5=BA=93=E6=B3=A8=E5=86=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 每个 provider 新增 `Create(DatabaseOptions)` 与无参 `UseXxx()` 重载, 后者只需登记 `RegisterDatabase(DbBaseType.Xxx, d => XxxProvider.Create(d))`。 字段映射(只覆盖"拼出可用连接串必需"的字段,超时/连接池等调优项不收): - Dameng:`DataSource` 优先,否则 `Server`+`Port`(默认 5236)+`UserId`/`Password`。 - PostgreSQL / KingbaseES:`DataSource`→`Host`(回退 `Server`)、`Port`、 `UserId`→`Username`;`Settings["TableSpace"]`。 - SqlServer:`Server`→`Data Source`;`SqlConnectionStringBuilder` 无 Port, 端口折进 `Data Source=host,port`,Server 已含 `,`/`\` 时再给 Port 直接报错。 - MySql:`Port` 转 `uint`;顺手把构造期用正则提取库名的写法换成 `MySqlConnectionStringBuilder(cs).Database`(原正则只认字母下划线, 库名带数字会误判为需要换库)。 - Sqlite:`DataSource` 优先,其次 `Database` 当库文件路径。 - Oracle:`DataSource`(TNS 别名 / 描述符 / EZ Connect)原样透传 → `ServiceName` 拼 `host:port/service` → `Sid` 拼完整描述符 → 裸 `Server` 当 TNS 别名。`Sid` 不用 `host:port/SID`:Oracle 语法里该位置 是 service_name,只在 service 与 SID 同名时"看起来能用",RAC 下必失败; 同时禁止 `Server`+`Port` 却无 ServiceName/Sid(拼出的 `host:port` 既不匹配别名也不是合法 EZ Connect)。 --- .../DamengProvider.cs | 69 +++++++++++++- .../Extensions/IoCExtension.cs | 13 ++- .../Extensions/IoCExtension.cs | 9 ++ .../KingbaseESProvider.cs | 35 +++++++ .../Extensions/IoCExtension.cs | 9 ++ .../LightORM.Providers.MySql/MySqlProvider.cs | 42 ++++++++- .../Extensions/IoCExtension.cs | 9 ++ .../OracleProvider.cs | 91 +++++++++++++++++++ .../Extensions/IoCExtension.cs | 9 ++ .../PostgresSQLProvider.cs | 43 +++++++++ .../Extensions/IoCExtension.cs | 9 ++ .../SqlServerProvider.cs | 59 ++++++++++++ .../Extensions/IoCExtension.cs | 9 ++ .../SqliteProvider.cs | 36 ++++++++ 14 files changed, 433 insertions(+), 9 deletions(-) diff --git a/src/Providers/LightORM.Providers.Dameng/DamengProvider.cs b/src/Providers/LightORM.Providers.Dameng/DamengProvider.cs index aff77857..0a26bb07 100644 --- a/src/Providers/LightORM.Providers.Dameng/DamengProvider.cs +++ b/src/Providers/LightORM.Providers.Dameng/DamengProvider.cs @@ -1,15 +1,16 @@ using Dm; +using LightORM.Implements; using LightORM.Interfaces; +using LightORM.Models; +using LightORM.Options; using System.Data; using System.Data.Common; -using LightORM.Implements; -using LightORM.Models; namespace LightORM.Providers.Dameng; public sealed class DamengProvider : BaseDatabaseProvider { - public static readonly DbBaseType Dameng = new ("Dameng"); + public static readonly DbBaseType Dameng = new("Dameng"); public static DamengProvider Create(DataBaseOption option) => new(option); public static DamengProvider Create(Action> setting) { @@ -22,6 +23,66 @@ public static DamengProvider Create(Action> s return Create(dbOption); } + /// + /// 从配置文件创建(由 UseDameng() 空参重载登记)。 + /// + /// 语义: 为底,分散字段逐项覆盖; + /// 没有连接串时用 Server / Port / UserId / Password 拼装。 + /// + /// + public static DamengProvider Create(DatabaseOptions database) + { + LightOrmException.ThrowIfNull(database, "数据库配置不能为 null"); + var definition = database.Option + ?? throw new LightOrmException($"数据库 '{database.Key}' 缺少 Option 配置。"); + + var dbOption = database.ToDbOption(BuildConnectionString(database.Key, definition)); + + var generate = dbOption.GenerateOption; + + // 方言私有配置:键名归 Dameng provider 自己定义,不进通用模型 + if (definition.GetSetting("TableSpace") is { Length: > 0 } tableSpace) + { + generate.TableSpace = tableSpace; + } + + if (definition.GetSetting("GenerateUserId") is { Length: > 0 } generateUserId) + { + generate.UserId = generateUserId; + } + + return Create(dbOption); + } + + private static string BuildConnectionString(string? key, DatabaseDefinition definition) + { + return DatabaseConnectionString.Build(key, definition, + connectionString => connectionString is null + ? new DmConnectionStringBuilder() + : new DmConnectionStringBuilder(connectionString), + (builder, def) => + { + if (def.DataSource is { Length: > 0 } dataSource) + { + builder.Server = dataSource; + if (def.Port is { } dataSourcePort) builder.Port = dataSourcePort; + } + else if (def.Server is { Length: > 0 } server) + { + builder.Server = server; + builder.Port = def.Port ?? 5236; + } + else if (def.Port is { } port) + { + builder.Port = port; + } + + if (def.UserId is { Length: > 0 } userId) builder.User = userId; + if (def.Password is { } password) builder.Password = password; + if (def.Database is { Length: > 0 } databaseName) builder.Database = databaseName; + }); + } + private DamengProvider(DataBaseOption option) : base(option.MasterConnectionString!, option.SalveConnectionStrings) { DbHandler = new DamengTableHandler(option.GenerateOption); @@ -32,7 +93,7 @@ private DamengProvider(DataBaseOption option) : base(option. DatabaseAdapter.UseIdentifierQuote = option.IsUseIdentifierQuote ?? true; DbProviderFactory = option.NewFactory ?? DmClientFactory.Instance; } - + public override DbBaseType DbBaseType => Dameng; public override IDatabaseAdapter DatabaseAdapter { get; } diff --git a/src/Providers/LightORM.Providers.Dameng/Extensions/IoCExtension.cs b/src/Providers/LightORM.Providers.Dameng/Extensions/IoCExtension.cs index 33e17d45..d236d9bb 100644 --- a/src/Providers/LightORM.Providers.Dameng/Extensions/IoCExtension.cs +++ b/src/Providers/LightORM.Providers.Dameng/Extensions/IoCExtension.cs @@ -1,5 +1,7 @@ -using LightORM.Interfaces; +using Dm; +using LightORM.Interfaces; using LightORM.Models; +using LightORM.Options; namespace LightORM.Providers.Dameng.Extensions; public static class IoCExtension @@ -30,6 +32,15 @@ public void UseDameng(Action setting) var provider = DamengProvider.Create(dbOption); options.SetDatabase(dbOption.DbKey ?? "MainDb", DamengProvider.Dameng, provider); } + + /// + /// 只登记"从配置创建 Dameng provider"的工厂,不注册任何实例。 + /// 配合 AddLightOrm(..., IConfiguration) 使用:配置里 Type = "Dameng" 的条目才会被创建。 + /// + public void UseDameng() + { + options.RegisterDatabase(DamengProvider.Dameng, DamengProvider.Create); + } } extension(IDbOption option) diff --git a/src/Providers/LightORM.Providers.KingbaseES/Extensions/IoCExtension.cs b/src/Providers/LightORM.Providers.KingbaseES/Extensions/IoCExtension.cs index b1cb16ba..2f853509 100644 --- a/src/Providers/LightORM.Providers.KingbaseES/Extensions/IoCExtension.cs +++ b/src/Providers/LightORM.Providers.KingbaseES/Extensions/IoCExtension.cs @@ -29,6 +29,15 @@ public void UseKingbaseES(Action setting) var provider = KingbaseESProvider.Create(dbOption); options.SetDatabase(dbOption.DbKey ?? "MainDb", KingbaseESProvider.KingbaseEs, provider); } + + /// + /// 只登记"从配置创建 KingbaseES provider"的工厂,不注册任何实例。 + /// 配合 AddLightOrm(..., IConfiguration) 使用:配置里 Type = "KingbaseES" 的条目才会被创建。 + /// + public void UseKingbaseES() + { + options.RegisterDatabase(KingbaseESProvider.KingbaseEs, database => KingbaseESProvider.Create(database)); + } } extension(IDbOption option) diff --git a/src/Providers/LightORM.Providers.KingbaseES/KingbaseESProvider.cs b/src/Providers/LightORM.Providers.KingbaseES/KingbaseESProvider.cs index 593d9673..29161568 100644 --- a/src/Providers/LightORM.Providers.KingbaseES/KingbaseESProvider.cs +++ b/src/Providers/LightORM.Providers.KingbaseES/KingbaseESProvider.cs @@ -1,6 +1,7 @@ using LightORM.Implements; using LightORM.Interfaces; using LightORM.Models; +using LightORM.Options; using System.Data; using System.Data.Common; @@ -21,6 +22,40 @@ public static KingbaseESProvider Create(Action + /// 从配置文件创建(由 UseKingbaseES() 空参重载登记)。 + /// + /// 为底,分散字段逐项覆盖; + /// 没有连接串时用 Host(Server/DataSource)/ Port / Username / Password / Database 拼装。 + /// + /// + public static KingbaseESProvider Create(DatabaseOptions database) + { + LightOrmException.ThrowIfNull(database, "数据库配置不能为 null"); + var definition = database.Option + ?? throw new LightOrmException($"数据库 '{database.Key}' 缺少 Option 配置。"); + + return Create(database.ToDbOption(BuildConnectionString(database.Key, definition))); + } + + private static string BuildConnectionString(string? key, DatabaseDefinition definition) + { + return DatabaseConnectionString.Build(key, definition, + connectionString => connectionString is null + ? new Kdbndp.KdbndpConnectionStringBuilder() + : new Kdbndp.KdbndpConnectionStringBuilder(connectionString), + (builder, def) => + { + if (def.DataSource is { Length: > 0 } dataSource) builder.Host = dataSource; + else if (def.Server is { Length: > 0 } host) builder.Host = host; + + if (def.Port is { } port) builder.Port = port; + if (def.UserId is { Length: > 0 } userName) builder.Username = userName; + if (def.Password is { } password) builder.Password = password; + if (def.Database is { Length: > 0 } databaseName) builder.Database = databaseName; + }); + } + private KingbaseESProvider(DataBaseOption option) : base(option.MasterConnectionString!, option.SalveConnectionStrings) { DbHandler = new KingbaseESTableHandler(option.GenerateOption); diff --git a/src/Providers/LightORM.Providers.MySql/Extensions/IoCExtension.cs b/src/Providers/LightORM.Providers.MySql/Extensions/IoCExtension.cs index 32b2ea52..c31ba5c6 100644 --- a/src/Providers/LightORM.Providers.MySql/Extensions/IoCExtension.cs +++ b/src/Providers/LightORM.Providers.MySql/Extensions/IoCExtension.cs @@ -30,6 +30,15 @@ public void UseMySql(Action setting) var provider = MySqlProvider.Create(dbOption); options.SetDatabase(dbOption.DbKey ?? "MainDb", DbBaseType.MySql, provider); } + + /// + /// 只登记"从配置创建 MySql provider"的工厂,不注册任何实例。 + /// 配合 AddLightOrm(..., IConfiguration) 使用:配置里 Type = "MySql" 的条目才会被创建。 + /// + public void UseMySql() + { + options.RegisterDatabase(DbBaseType.MySql, database => MySqlProvider.Create(database)); + } } extension(IDbOption option) diff --git a/src/Providers/LightORM.Providers.MySql/MySqlProvider.cs b/src/Providers/LightORM.Providers.MySql/MySqlProvider.cs index c30d6fb1..9a5a80dd 100644 --- a/src/Providers/LightORM.Providers.MySql/MySqlProvider.cs +++ b/src/Providers/LightORM.Providers.MySql/MySqlProvider.cs @@ -2,9 +2,9 @@ using MySqlConnector; using System.Data; using System.Data.Common; -using System.Text.RegularExpressions; using LightORM.Implements; using LightORM.Models; +using LightORM.Options; namespace LightORM.Providers.MySql; @@ -23,13 +23,47 @@ public static MySqlProvider Create(Action> set return Create(dbOption); } + /// + /// 从配置文件创建(由 UseMySql() 空参重载登记)。 + /// + /// 为底,分散字段逐项覆盖; + /// 没有连接串时用 Server / Port / UserId / Password / Database 拼装。 + /// + /// + public static MySqlProvider Create(DatabaseOptions database) + { + LightOrmException.ThrowIfNull(database, "数据库配置不能为 null"); + var definition = database.Option + ?? throw new LightOrmException($"数据库 '{database.Key}' 缺少 Option 配置。"); + + return Create(database.ToDbOption(BuildConnectionString(database.Key, definition))); + } + + private static string BuildConnectionString(string? key, DatabaseDefinition definition) + { + return DatabaseConnectionString.Build(key, definition, + connectionString => connectionString is null + ? new MySqlConnectionStringBuilder() + : new MySqlConnectionStringBuilder(connectionString), + (builder, def) => + { + if (def.DataSource is { Length: > 0 } dataSource) builder.Server = dataSource; + else if (def.Server is { Length: > 0 } server) builder.Server = server; + + if (def.Port is { } port) builder.Port = (uint)port; + if (def.UserId is { Length: > 0 } userId) builder.UserID = userId; + if (def.Password is { } password) builder.Password = password; + if (def.Database is { Length: > 0 } databaseName) builder.Database = databaseName; + }); + } + private MySqlProvider(DataBaseOption option) : base(option.MasterConnectionString!, option.SalveConnectionStrings) { var master = option.MasterConnectionString!; - var match = Regex.Match(master, @"(?<=Database\=)([A-Z|a-z|_]+)", RegexOptions.IgnoreCase); - if (!match.Success) + // 用强类型 builder 取库名:原来的正则只认字母下划线,库名带数字/中文会误判为"未发现数据库" + if (string.IsNullOrEmpty(new MySqlConnectionStringBuilder(master).Database)) { - throw new Exception("未能在连接字符串中发现目标数据库!"); + throw new LightOrmException("连接字符串中缺少 Database(库名不能为空)。"); } var generate = option.GenerateOption; var factory = option.NewFactory ?? MySqlConnectorFactory.Instance; diff --git a/src/Providers/LightORM.Providers.Oracle/Extensions/IoCExtension.cs b/src/Providers/LightORM.Providers.Oracle/Extensions/IoCExtension.cs index d270979d..c7aaed08 100644 --- a/src/Providers/LightORM.Providers.Oracle/Extensions/IoCExtension.cs +++ b/src/Providers/LightORM.Providers.Oracle/Extensions/IoCExtension.cs @@ -30,6 +30,15 @@ public void UseOracle(Action setting) var provider = OracleProvider.Create(dbOption); options.SetDatabase(dbOption.DbKey ?? "MainDb", DbBaseType.Oracle, provider); } + + /// + /// 只登记"从配置创建 Oracle provider"的工厂,不注册任何实例。 + /// 配合 AddLightOrm(..., IConfiguration) 使用:配置里 Type = "Oracle" 的条目才会被创建。 + /// + public void UseOracle() + { + options.RegisterDatabase(DbBaseType.Oracle, database => OracleProvider.Create(database)); + } } extension(IDbOption option) diff --git a/src/Providers/LightORM.Providers.Oracle/OracleProvider.cs b/src/Providers/LightORM.Providers.Oracle/OracleProvider.cs index 2d290dab..58305d02 100644 --- a/src/Providers/LightORM.Providers.Oracle/OracleProvider.cs +++ b/src/Providers/LightORM.Providers.Oracle/OracleProvider.cs @@ -4,6 +4,7 @@ using System.Data.Common; using LightORM.Implements; using LightORM.Models; +using LightORM.Options; namespace LightORM.Providers.Oracle; @@ -20,6 +21,96 @@ public static OracleProvider Create(Action> s } return Create(dbOption); } + /// + /// 从配置文件创建(由 UseOracle() 空参重载登记)。 + /// + /// 优先(TNS 别名 / 完整描述符 / EZ Connect); + /// 否则按 ServiceName / Sid + Server(+Port) 组装;只给 Server 时当作 TNS 别名。 + /// + /// + public static OracleProvider Create(DatabaseOptions database) + { + LightOrmException.ThrowIfNull(database, "数据库配置不能为 null"); + var definition = database.Option + ?? throw new LightOrmException($"数据库 '{database.Key}' 缺少 Option 配置。"); + + return Create(database.ToDbOption(BuildConnectionString(database.Key, definition))); + } + + private static string BuildConnectionString(string? key, DatabaseDefinition definition) + { + return DatabaseConnectionString.Build(key, definition, + connectionString => connectionString is null + ? new OracleConnectionStringBuilder() + : new OracleConnectionStringBuilder(connectionString), + (builder, def) => + { + if (ResolveDataSource(key, def) is { Length: > 0 } dataSource) + { + builder.DataSource = dataSource; + } + + if (def.UserId is { Length: > 0 } userId) builder.UserID = userId; + if (def.Password is { } password) builder.Password = password; + }); + } + + /// + /// Oracle 的 DataSource 组装:显式 → ServiceName → Sid → 裸 Server(当作 TNS 别名)。 + /// + private static string? ResolveDataSource(string? key, DatabaseDefinition definition) + { + if (definition.DataSource is { Length: > 0 } explicitDataSource) + { + return explicitDataSource; + } + + if (definition.ServiceName is { Length: > 0 } && definition.Sid is { Length: > 0 }) + { + throw new LightOrmException($"数据库 '{key}':ServiceName 与 Sid 只能二选一。"); + } + + var hasServer = definition.Server is { Length: > 0 }; + + if (definition.ServiceName is { Length: > 0 } serviceName) + { + if (!hasServer) + { + throw new LightOrmException($"数据库 '{key}':配置了 ServiceName 就必须同时配置 Server。"); + } + + // EZ Connect:host:port/service + return $"{definition.Server}:{definition.Port ?? 1521}/{serviceName}"; + } + + if (definition.Sid is { Length: > 0 } sid) + { + if (!hasServer) + { + throw new LightOrmException($"数据库 '{key}':配置了 Sid 就必须同时配置 Server。"); + } + + // SID 不能用 EZ Connect 表达:host:port/xxx 里的 xxx 在 Oracle 语法里是 service_name, + // 只有单实例且 service_name 恰好等于 SID 时才"看起来能用",RAC(SID=ORCL1,service=ORCL)必失败。 + return $"(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST={definition.Server})(PORT={definition.Port ?? 1521}))(CONNECT_DATA=(SID={sid})))"; + } + + if (definition.Server is { Length: > 0 } tnsAlias) + { + // 裸 Server 当 TNS 别名(整串精确匹配 tnsnames.ora)。 + // 但一旦给了 Port,就不再是别名,而 host:port 缺少 service_name 也无法定位到库, + // 与其拼出 "RACE:1521" 这种既不解析别名、又连不到具体服务的串,不如直接报错。 + if (definition.Port is { } port) + { + throw new LightOrmException($"数据库 '{key}':配置了 Server 和 Port 时,必须再配置 ServiceName 或 Sid(EZ Connect 的 host:port 后面必须跟 service_name,不能只给主机端口)。只连 TNS 别名请去掉 Port。"); + } + + return tnsAlias; + } + + return null; + } + private OracleProvider(DataBaseOption option) : base(option.MasterConnectionString!, option.SalveConnectionStrings) { var generate = option.GenerateOption; diff --git a/src/Providers/LightORM.Providers.PostgreSQL/Extensions/IoCExtension.cs b/src/Providers/LightORM.Providers.PostgreSQL/Extensions/IoCExtension.cs index 3d1e27e3..cd035d50 100644 --- a/src/Providers/LightORM.Providers.PostgreSQL/Extensions/IoCExtension.cs +++ b/src/Providers/LightORM.Providers.PostgreSQL/Extensions/IoCExtension.cs @@ -31,6 +31,15 @@ public void UsePostgreSQL(Action setting) var provider = PostgreSQLProvider.Create(dbOption); options.SetDatabase(dbOption.DbKey ?? "MainDb", DbBaseType.PostgreSQL, provider); } + + /// + /// 只登记"从配置创建 PostgreSQL provider"的工厂,不注册任何实例。 + /// 配合 AddLightOrm(..., IConfiguration) 使用:配置里 Type = "PostgreSQL" 的条目才会被创建。 + /// + public void UsePostgreSQL() + { + options.RegisterDatabase(DbBaseType.PostgreSQL, database => PostgreSQLProvider.Create(database)); + } } extension(IDbOption option) diff --git a/src/Providers/LightORM.Providers.PostgreSQL/PostgresSQLProvider.cs b/src/Providers/LightORM.Providers.PostgreSQL/PostgresSQLProvider.cs index f8cd8dff..917dbc5c 100644 --- a/src/Providers/LightORM.Providers.PostgreSQL/PostgresSQLProvider.cs +++ b/src/Providers/LightORM.Providers.PostgreSQL/PostgresSQLProvider.cs @@ -3,6 +3,7 @@ using System.Data.Common; using LightORM.Implements; using LightORM.Models; +using LightORM.Options; namespace LightORM.Providers.PostgreSQL; @@ -21,6 +22,48 @@ public static PostgreSQLProvider Create(Action + /// 从配置文件创建(由 UsePostgreSQL() 空参重载登记)。 + /// + /// 为底,分散字段逐项覆盖; + /// 没有连接串时用 Host / Port / Username / Password / Database 拼装。 + /// + /// + public static PostgreSQLProvider Create(DatabaseOptions database) + { + LightOrmException.ThrowIfNull(database, "数据库配置不能为 null"); + var definition = database.Option + ?? throw new LightOrmException($"数据库 '{database.Key}' 缺少 Option 配置。"); + + var dbOption = database.ToDbOption(BuildConnectionString(database.Key, definition)); + + // 方言私有项走 Settings,不进通用模型 + if (definition.GetSetting("TableSpace") is { Length: > 0 } tableSpace) + { + dbOption.GenerateOption.TableSpace = tableSpace; + } + + return Create(dbOption); + } + + private static string BuildConnectionString(string? key, DatabaseDefinition definition) + { + return DatabaseConnectionString.Build(key, definition, + connectionString => connectionString is null + ? new Npgsql.NpgsqlConnectionStringBuilder() + : new Npgsql.NpgsqlConnectionStringBuilder(connectionString), + (builder, def) => + { + if (def.DataSource is { Length: > 0 } dataSource) builder.Host = dataSource; + else if (def.Server is { Length: > 0 } host) builder.Host = host; + + if (def.Port is { } port) builder.Port = port; + if (def.UserId is { Length: > 0 } userName) builder.Username = userName; + if (def.Password is { } password) builder.Password = password; + if (def.Database is { Length: > 0 } databaseName) builder.Database = databaseName; + }); + } + public override DbBaseType DbBaseType => DbBaseType.PostgreSQL; private PostgreSQLProvider(DataBaseOption option) : base(option.MasterConnectionString!, option.SalveConnectionStrings) diff --git a/src/Providers/LightORM.Providers.SqlServer/Extensions/IoCExtension.cs b/src/Providers/LightORM.Providers.SqlServer/Extensions/IoCExtension.cs index 7ec9bdd9..48db6f36 100644 --- a/src/Providers/LightORM.Providers.SqlServer/Extensions/IoCExtension.cs +++ b/src/Providers/LightORM.Providers.SqlServer/Extensions/IoCExtension.cs @@ -29,6 +29,15 @@ public void UseSqlServer(Action setting) var provider = SqlServerProvider.Create(dbOption); options.SetDatabase(dbOption.DbKey ?? "MainDb", DbBaseType.SqlServer, provider); } + + /// + /// 只登记"从配置创建 SqlServer provider"的工厂,不注册任何实例。 + /// 配合 AddLightOrm(..., IConfiguration) 使用:配置里 Type = "SqlServer" 的条目才会被创建。 + /// + public void UseSqlServer() + { + options.RegisterDatabase(DbBaseType.SqlServer, database => SqlServerProvider.Create(database)); + } } extension(IDbOption option) diff --git a/src/Providers/LightORM.Providers.SqlServer/SqlServerProvider.cs b/src/Providers/LightORM.Providers.SqlServer/SqlServerProvider.cs index ff0cbdef..f93e64e5 100644 --- a/src/Providers/LightORM.Providers.SqlServer/SqlServerProvider.cs +++ b/src/Providers/LightORM.Providers.SqlServer/SqlServerProvider.cs @@ -3,6 +3,7 @@ using System.Data.Common; using LightORM.Implements; using LightORM.Models; +using LightORM.Options; #if NET462_OR_GREATER using System.Data.SqlClient; #else @@ -25,6 +26,64 @@ public static SqlServerProvider Create(Action + /// 从配置文件创建(由 UseSqlServer() 空参重载登记)。 + /// + /// 为底,分散字段逐项覆盖。 + /// 注意 没有 Port 属性:端口写成 Data Source=host,port。 + /// + /// + public static SqlServerProvider Create(DatabaseOptions database) + { + LightOrmException.ThrowIfNull(database, "数据库配置不能为 null"); + var definition = database.Option + ?? throw new LightOrmException($"数据库 '{database.Key}' 缺少 Option 配置。"); + + return Create(database.ToDbOption(BuildConnectionString(database.Key, definition))); + } + + private static string BuildConnectionString(string? key, DatabaseDefinition definition) + { + return DatabaseConnectionString.Build(key, definition, + connectionString => connectionString is null + ? new SqlConnectionStringBuilder() + : new SqlConnectionStringBuilder(connectionString), + (builder, def) => + { + if (def.DataSource is { Length: > 0 } dataSource) + { + builder.DataSource = dataSource; + } + else if (def.Server is { Length: > 0 } server) + { + if (def.Port is { } port) + { + // 已自带端口或命名实例时再追加会拼出 host,1433,port 这种非法值 + if (server.IndexOf(',') >= 0 || server.IndexOf('\\') >= 0) + { + throw new LightOrmException( + $"数据库 '{key}':Server '{server}' 已包含端口或实例名,不要再单独配置 Port。"); + } + + builder.DataSource = $"{server},{port}"; + } + else + { + builder.DataSource = server; + } + } + else if (def.Port is not null) + { + throw new LightOrmException( + $"数据库 '{key}':SqlServer 的 Port 必须与 Server 一起配置,或直接写进连接串的 Data Source。"); + } + + if (def.UserId is { Length: > 0 } userId) builder.UserID = userId; + if (def.Password is { } password) builder.Password = password; + if (def.Database is { Length: > 0 } databaseName) builder.InitialCatalog = databaseName; + }); + } + private SqlServerProvider(DataBaseOption option) : base(option.MasterConnectionString!, option.SalveConnectionStrings) { var generate = option.GenerateOption; diff --git a/src/Providers/LightORM.Providers.Sqlite/Extensions/IoCExtension.cs b/src/Providers/LightORM.Providers.Sqlite/Extensions/IoCExtension.cs index 143b94f7..4529f9f2 100644 --- a/src/Providers/LightORM.Providers.Sqlite/Extensions/IoCExtension.cs +++ b/src/Providers/LightORM.Providers.Sqlite/Extensions/IoCExtension.cs @@ -29,6 +29,15 @@ public void UseSqlite(Action setting) var provider = SqliteProvider.Create(dbOption); options.SetDatabase(dbOption.DbKey ?? "MainDb", DbBaseType.Sqlite, provider); } + + /// + /// 只登记"从配置创建 Sqlite provider"的工厂,不注册任何实例。 + /// 配合 AddLightOrm(..., IConfiguration) 使用:配置里 Type = "Sqlite" 的条目才会被创建。 + /// + public void UseSqlite() + { + options.RegisterDatabase(DbBaseType.Sqlite, database => SqliteProvider.Create(database)); + } } extension(IDbOption option) diff --git a/src/Providers/LightORM.Providers.Sqlite/SqliteProvider.cs b/src/Providers/LightORM.Providers.Sqlite/SqliteProvider.cs index 28550a07..f6ffe3f7 100644 --- a/src/Providers/LightORM.Providers.Sqlite/SqliteProvider.cs +++ b/src/Providers/LightORM.Providers.Sqlite/SqliteProvider.cs @@ -4,6 +4,7 @@ using System.Data.SQLite; using LightORM.Implements; using LightORM.Models; +using LightORM.Options; namespace LightORM.Providers.Sqlite; @@ -22,6 +23,41 @@ public static SqliteProvider Create(Action> s return Create(dbOption); } + /// + /// 从配置文件创建(由 UseSqlite() 空参重载登记)。 + /// + /// SQLite 没有 Server / Port / 凭据概念:用 , + /// 或用 ( 视作库文件路径)。 + /// + /// + public static SqliteProvider Create(DatabaseOptions database) + { + LightOrmException.ThrowIfNull(database, "数据库配置不能为 null"); + var definition = database.Option + ?? throw new LightOrmException($"数据库 '{database.Key}' 缺少 Option 配置。"); + + return Create(database.ToDbOption(BuildConnectionString(database.Key, definition))); + } + + private static string BuildConnectionString(string? key, DatabaseDefinition definition) + { + return DatabaseConnectionString.Build(key, definition, + connectionString => connectionString is null + ? new SQLiteConnectionStringBuilder() + : new SQLiteConnectionStringBuilder(connectionString), + (builder, def) => + { + if (def.DataSource is { Length: > 0 } dataSource) builder.DataSource = dataSource; + else if (def.Database is { Length: > 0 } databaseName) builder.DataSource = databaseName; + else if (string.IsNullOrWhiteSpace(def.ConnectionString)) + { + throw new LightOrmException( + $"数据库 '{key}':SQLite 必须提供 ConnectionString 或 DataSource(库文件路径)。" + + "Server / Port / UserId / Password 对 SQLite 没有意义。"); + } + }); + } + private SqliteProvider(DataBaseOption option) : base(option.MasterConnectionString!, option.SalveConnectionStrings) { var generate = option.GenerateOption; From 79289919ba2f5ce6468ad94755846fb99eba0f88 Mon Sep 17 00:00:00 2001 From: MarvelTiter_yaoqinglin Date: Sun, 8 Nov 2026 17:20:49 +0800 Subject: [PATCH 04/10] =?UTF-8?q?test:=20=E9=85=8D=E7=BD=AE=E6=B3=A8?= =?UTF-8?q?=E5=86=8C=E7=AB=AF=E5=88=B0=E7=AB=AF=E7=94=A8=E4=BE=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 覆盖初始加载、同名键覆盖、删除条目、未知 Type 的可读报错、 Type 大小写不敏感五种场景;用临时目录 + `reloadOnChange: true` 真实走一遍文件监听,`[DoNotParallelize]` 避免静态注册表互相污染, 用完按 key 调 `RemoveDatabase` 清理。 `TestBase` 保持不消费 configuration:多注册几个库会让 `DatabaseProviders.First()` 类断言失效。 --- .../LightORMTest/DatabaseConfigurationTest.cs | 190 ++++++++++++++++++ test/LightORMTest/LightORMTest.csproj | 1 + test/LightORMTest/TestBase.cs | 3 + 3 files changed, 194 insertions(+) create mode 100644 test/LightORMTest/DatabaseConfigurationTest.cs diff --git a/test/LightORMTest/DatabaseConfigurationTest.cs b/test/LightORMTest/DatabaseConfigurationTest.cs new file mode 100644 index 00000000..cfebccc4 --- /dev/null +++ b/test/LightORMTest/DatabaseConfigurationTest.cs @@ -0,0 +1,190 @@ +using LightORM; +using LightORM.Interfaces; +using LightORM.Providers.Sqlite; +using Microsoft.Extensions.Configuration; +using Microsoft.Extensions.DependencyInjection; +using Microsoft.VisualStudio.TestTools.UnitTesting; + +namespace LightORMTest; + +/// +/// 配置驱动的数据库注册(AddLightOrm(..., IConfiguration))。 +/// +/// 用 Sqlite 当被测方言:provider 创建不连库,整个用例离线可跑。 +/// 全局注册表是 static 的,所以每个用例用唯一 key,并在 Cleanup 里移除。 +/// +/// +[TestClass] +[DoNotParallelize] +public class DatabaseConfigurationTest +{ + private const string SectionName = "LightOrmDatabases"; + + private string directory = null!; + private string configFile = null!; + private readonly List registeredKeys = []; + + [TestInitialize] + public void Initialize() + { + directory = Path.Combine(Path.GetTempPath(), "lightorm-config-" + Guid.NewGuid().ToString("N")); + _ = Directory.CreateDirectory(directory); + configFile = Path.Combine(directory, "db.json"); + } + + [TestCleanup] + public void Cleanup() + { + foreach (var key in registeredKeys) + { + _ = ExpressionSqlOptions.RemoveDatabase(key); + } + + try + { + Directory.Delete(directory, recursive: true); + } + catch + { + // 文件监听可能还握着句柄,删不掉不影响用例结论 + } + } + + [TestMethod] + public void InitialLoad_RegistersDatabasesFromConfiguration() + { + var key = NewKey("init"); + using var provider = CreateProvider(Config(key, "Data Source=:memory:")); + + var db = provider.GetRequiredService(); + + Assert.IsTrue(db.Options.DatabaseProviders.ContainsKey(key), "初始加载没有发生:配置里的数据库没有被注册"); + Assert.AreEqual("Data Source=:memory:", db.Options.DatabaseProviders[key].MasterConnectionString); + } + + [TestMethod] + public void Reload_ReplacesConnectionStringOfExistingKey() + { + var key = NewKey("reload"); + using var provider = CreateProvider(Config(key, "Data Source=a.db")); + var db = provider.GetRequiredService(); + Assert.AreEqual("Data Source=a.db", db.Options.DatabaseProviders[key].MasterConnectionString); + + File.WriteAllText(configFile, Config(key, "Data Source=b.db")); + + Assert.IsTrue( + WaitFor(() => db.Options.DatabaseProviders[key].MasterConnectionString == "Data Source=b.db"), + $"连接串没有随配置更新,当前值:{db.Options.DatabaseProviders[key].MasterConnectionString}"); + } + + [TestMethod] + public void Reload_RemovesDatabaseDeletedFromConfiguration() + { + var kept = NewKey("keep"); + var removed = NewKey("gone"); + using var provider = CreateProvider(ConfigWithTwoEntries(kept, "Data Source=:memory:", removed)); + var db = provider.GetRequiredService(); + Assert.IsTrue(db.Options.DatabaseProviders.ContainsKey(removed)); + + File.WriteAllText(configFile, Config(kept, "Data Source=:memory:")); + + Assert.IsTrue( + WaitFor(() => !db.Options.DatabaseProviders.ContainsKey(removed)), + "配置里已删除的数据库仍然留在注册表里"); + Assert.IsTrue(db.Options.DatabaseProviders.ContainsKey(kept), "保留下来的数据库不应被一起删除"); + } + + [TestMethod] + public void UnknownType_ThrowsWithReadableMessage() + { + var key = NewKey("unknown"); + using var provider = CreateProvider(Config(key, "Data Source=:memory:", type: "NoSuchDatabase")); + + LightOrmException? error = null; + try + { + _ = provider.GetRequiredService(); + } + catch (LightOrmException ex) + { + error = ex; + } + + Assert.IsNotNull(error, "未知的 Type 应该抛 LightOrmException"); + StringAssert.Contains(error.Message, "NoSuchDatabase"); + StringAssert.Contains(error.Message, "已注册"); + } + + [TestMethod] + public void TypeMatching_IsCaseInsensitive() + { + var key = NewKey("case"); + using var provider = CreateProvider(Config(key, "Data Source=:memory:", type: "sqlite")); + + var db = provider.GetRequiredService(); + + Assert.IsTrue(db.Options.DatabaseProviders.ContainsKey(key), "Type 匹配应该忽略大小写"); + } + + private string NewKey(string prefix) + { + var key = prefix + "-" + Guid.NewGuid().ToString("N")[..8]; + registeredKeys.Add(key); + return key; + } + + private static string Config(string key, string connectionString, string type = "Sqlite") + => $$""" + { + "{{SectionName}}": [ + { "Key": "{{key}}", "Option": { "Type": "{{type}}", "ConnectionString": "{{connectionString}}" } } + ] + } + """; + + private static string ConfigWithTwoEntries(string firstKey, string firstConnectionString, string secondKey) + => $$""" + { + "{{SectionName}}": [ + { "Key": "{{firstKey}}", "Option": { "Type": "Sqlite", "ConnectionString": "{{firstConnectionString}}" } }, + { "Key": "{{secondKey}}", "Option": { "Type": "Sqlite", "ConnectionString": "Data Source=:memory:" } } + ] + } + """; + + private ServiceProvider CreateProvider(string json) + { + File.WriteAllText(configFile, json); + + var configuration = new ConfigurationBuilder() + .AddJsonFile(configFile, optional: false, reloadOnChange: true) + .Build(); + + var services = new ServiceCollection(); + services.AddLightOrm(options => + { + options.SetTableContext(); + options.ConfigJsonHandler(); + options.RegisterDatabase(DbBaseType.Sqlite, database => + SqliteProvider.Create(setting => setting.MasterConnectionString = database.Option!.ConnectionString)); + }, configuration); + + return services.BuildServiceProvider(); + } + + private static bool WaitFor(Func condition, int timeoutMilliseconds = 8000) + { + var deadline = DateTime.UtcNow.AddMilliseconds(timeoutMilliseconds); + while (DateTime.UtcNow < deadline) + { + if (condition()) + { + return true; + } + + Thread.Sleep(100); + } + + return condition(); + } +} diff --git a/test/LightORMTest/LightORMTest.csproj b/test/LightORMTest/LightORMTest.csproj index dd52de06..72c4ed13 100644 --- a/test/LightORMTest/LightORMTest.csproj +++ b/test/LightORMTest/LightORMTest.csproj @@ -10,6 +10,7 @@ + diff --git a/test/LightORMTest/TestBase.cs b/test/LightORMTest/TestBase.cs index b1efdc3c..16942af5 100644 --- a/test/LightORMTest/TestBase.cs +++ b/test/LightORMTest/TestBase.cs @@ -20,6 +20,9 @@ public class TestBase protected IDatabaseProvider CurrentDefaultProvider => Db.Options.DatabaseProviders.First().Value; protected TestBase() { + // 注意:这里刻意不接配置文件 —— 各 provider 的用例都靠 Configura 显式注册库, + // 再叠一份配置会改变 DatabaseProviders 的内容/顺序,破坏既有断言。 + // 配置驱动的注册由 DatabaseConfigurationTest 单独覆盖。 IServiceCollection services = new ServiceCollection(); services.AddLightOrm(option => { From 16e6163260686ce3f239784c1a3a4b2dec8ecc7e Mon Sep 17 00:00:00 2001 From: MarvelTiter_yaoqinglin Date: Sun, 8 Nov 2026 17:20:54 +0800 Subject: [PATCH 05/10] =?UTF-8?q?feat:=20DatabaseUtils.Avalonia=20?= =?UTF-8?q?=E6=94=B9=E4=B8=BA=E4=BB=8E=20db.json=20=E6=B3=A8=E5=86=8C?= =?UTF-8?q?=E6=95=B0=E6=8D=AE=E5=BA=93?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `db.json` 随输出复制(PreserveNewest),启动时 `AddJsonFile(optional: false, reloadOnChange: true)`, 缺文件直接启动失败而不是运行期抛 `KeyNotFoundException`; `UseDameng()` 只登记创建器,实际库由配置提供。 示例配置用 `Key = "MainDb"`,否则 `DefaultDbKey` 找不到默认库。 依赖由 `Microsoft.Extensions.Hosting` 换成 `Microsoft.Extensions.Configuration.Json`,不再引入整套 Host。 --- DatabaseUtils.Avalonia/App.axaml.cs | 12 +++++++++++- .../DatabaseUtils.Avalonia.csproj | 7 +++++++ DatabaseUtils.Avalonia/db.json | 14 ++++++++++++++ 3 files changed, 32 insertions(+), 1 deletion(-) create mode 100644 DatabaseUtils.Avalonia/db.json diff --git a/DatabaseUtils.Avalonia/App.axaml.cs b/DatabaseUtils.Avalonia/App.axaml.cs index 03c58392..78ea6341 100644 --- a/DatabaseUtils.Avalonia/App.axaml.cs +++ b/DatabaseUtils.Avalonia/App.axaml.cs @@ -6,6 +6,8 @@ using DatabaseUtils.Avalonia.ViewModels; using DatabaseUtils.Avalonia.Views; using LightORM; +using LightORM.Providers.Dameng.Extensions; +using Microsoft.Extensions.Configuration; using Microsoft.Extensions.DependencyInjection; using System.Linq; @@ -27,13 +29,21 @@ public override void OnFrameworkInitializationCompleted() { if (ApplicationLifetime is IClassicDesktopStyleApplicationLifetime desktop) { + // 构建 IConfiguration,加载 db.json。 + // optional: false —— 缺文件时直接启动失败,比运行期抛 KeyNotFoundException 好查。 + var configuration = new ConfigurationBuilder() + .AddJsonFile("db.json", optional: false, reloadOnChange: true) + .Build(); // 与 Hybrid 版本保持一致的 LightORM 初始化 var services = new ServiceCollection(); + services.AddSingleton(configuration); services.AddLightOrm(option => { option.SetTableContext(); option.UseInterceptor(); - }); + // 只登记“从配置创建 Dameng provider”的工厂;实际库由 db.json 提供 + option.UseDameng(); + }, configuration); Services = services.BuildServiceProvider(); diff --git a/DatabaseUtils.Avalonia/DatabaseUtils.Avalonia.csproj b/DatabaseUtils.Avalonia/DatabaseUtils.Avalonia.csproj index ffc9651c..61a4361a 100644 --- a/DatabaseUtils.Avalonia/DatabaseUtils.Avalonia.csproj +++ b/DatabaseUtils.Avalonia/DatabaseUtils.Avalonia.csproj @@ -45,5 +45,12 @@ All + + + + + + PreserveNewest + diff --git a/DatabaseUtils.Avalonia/db.json b/DatabaseUtils.Avalonia/db.json new file mode 100644 index 00000000..2a7d78a7 --- /dev/null +++ b/DatabaseUtils.Avalonia/db.json @@ -0,0 +1,14 @@ +{ + "LightOrmDatabases": [ + { + "Key": "MainDb", + "Option": { + "Type": "Dameng", + "Server": "localhost", + "Port": 5236, + "UserId": "SYSDBA", + "Password": "SYSDBA001" + } + } + ] +} From 8382e41adc370afad29f9704defe0b5d7d608b70 Mon Sep 17 00:00:00 2001 From: MarvelTiter_yaoqinglin Date: Sun, 8 Nov 2026 17:21:00 +0800 Subject: [PATCH 06/10] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E5=B7=A5?= =?UTF-8?q?=E4=BD=9C=E5=8C=BA=E8=AE=B0=E5=BF=86?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 记录配置驱动注册的落地范围、字段取舍口径(只覆盖拼串必需字段)、 Oracle DataSource 语法结论(`host:port/xxx` 是 service_name, SID 必须完整描述符),以及沙箱下 `dotnet build` 需 `--no-restore`。 --- .workbuddy/memory/2026-11-08.md | 67 +++++++++++ .workbuddy/memory/MEMORY.md | 207 ++++++++++++++------------------ 2 files changed, 159 insertions(+), 115 deletions(-) create mode 100644 .workbuddy/memory/2026-11-08.md diff --git a/.workbuddy/memory/2026-11-08.md b/.workbuddy/memory/2026-11-08.md new file mode 100644 index 00000000..43b22c1b --- /dev/null +++ b/.workbuddy/memory/2026-11-08.md @@ -0,0 +1,67 @@ +# 2026-11-08 + +## 评审:JSON 配置驱动注册数据库(实验性,仅 Dameng) + +变更范围:`AddLightOrm(..., IConfiguration?)`、`IExpressionContextSetup.RegisterDatabase`、 +`ExpressionSqlOptions.RegisterCreator/LoadDatabases`、`src/LightORM/Options/DatabaseOptions.cs`、 +手写 AOT binder `LightORM.Extensions.DependencyInjection/BindingExtensions.cs`、 +`DamengProvider.CreateDmProvider`、`UseDameng()` 空重载、Avalonia `App.axaml.cs` + `db.json`。 + +### 实测(临时 MSTest + 内存/文件 JSON,跑完已删) +1. **启动时配置完全不生效** —— `Build()` 只 `OnChange` 订阅,从不读 `CurrentValue`;`DatabaseProviders` 为空。 +2. 文件变更后 `OnChange` 正常触发,新 key 会注册(`KEYS_AFTER_RELOAD=cfgsqlite_b|cfgsqlite`)。 +3. **改已有 key 的连接串不生效** —— `SetDatabase` 是 `TryAdd`:`CS_AFTER_FIRST=Data Source=a.db`,改成 b.db 后仍是 a.db。 + +### 其他确认 +- `services.Configure(configuration.GetSection("LightOrmDatabases"))` 是空绑定(`DatabaseList` 属性名也是 `LightOrmDatabases`),唯一作用是隐式补 change token。 +- `TestBase` 没把 configuration 传给 `AddLightOrm` ⇒ 新特性零覆盖,`test/LightORMTest/db.json` 是死文件。 +- net462/netstandard2.0 下 `ArgumentNullException.ThrowIfNull` 能编译,靠 `MT.LightORM` 的 `internal ExceptionPolyfills`(`namespace System` + C# 14 extension block)+ `InternalsVisibleTo`,不是 BCL。 + +### 建议(未实施) +- P0:`Build()` 里补 `UpdateProviders(monitor.CurrentValue)`(幂等)+ `SetOrReplaceDatabase`(adapter/handler 按 type 一起换)+ 记录上一轮 key 做移除。 +- P1:未知 `Type` 抛 `LightOrmException` 并列出已注册项;`RegisterCreator` key 用 OrdinalIgnoreCase;`SetDatabase` 用 `provider.DbBaseType`;`reloadToken` 从 static 改单例 `IDisposable`(现在只订阅第一个 ServiceProvider 且永不释放)。 +- P2:`LoadDatabases(List)` 不该在核心(配置模型渗进内核);`Func` 建议换成 `IDatabaseCreator` 接口 + `Settings` 自由字典;`CreateDmProvider` 漏了 Slave/`UseIdentifierQuote`/`GenerateOption`/`NewFactory`;`DatabaseOptions` 与既有 `DataBaseOption` 命名太近;`IExpressionContextSetup.RegisterDatabase` 是破坏性接口新增。 + +## 记忆维护 +- `MEMORY.md` 已超限(24KB)被截断 → 重写为结论+铁律版(~11KB),细节链条保留在 09-XX 日志中。 + +## 实施上述改进(同日,全部落地) +- 核心:`ExpressionSqlBuilder.cs` 增 `RegisterCreator(DbBaseType,...)` / `ApplyDatabase` / `RemoveDatabase` / `TryGetCreator` / `CreatorNames`,三个字典改 `OrdinalIgnoreCase`,删 `LoadDatabases`;新增 `Interfaces/IDatabaseRegistry.cs`;重写 `Options/DatabaseOptions.cs`(补 Slave / IsUseIdentifierQuote / SpecificVersion / DetectVersion / DefaultStringLength / Settings,去掉误用的 `[NotNull]` 和无用 using);`IExpressionContextSetup.cs` 还原(不再加成员,改为可选接口 + 扩展方法)。 +- DI:`IoCExtensions.cs` 重写(`TryAddSingleton`、显式 `ConfigurationChangeTokenSource`、单例 `DatabaseListReloader`、lambda 替代 method group);新增 `DatabaseListReloader.cs`(初始加载 + OnChange + diff 覆盖/移除 + 失败不崩监听线程);`BindingExtensions.cs` 改成强类型入口并补齐新属性绑定。 +- Dameng:`CreateDmProvider` → `Create(DatabaseOptions)` 重载,"连接串为底 + 分散字段覆盖",补齐 Slave / Quote / SpecificVersion / DetectVersion / StringLength / Settings(TableSpace、GenerateUserId),缺 Server 抛可读异常。 +- 测试:新增 `test/LightORMTest/DatabaseConfigurationTest.cs`(5 用例全过);删死文件 `test/LightORMTest/db.json`;`TestBase` 还原 `new ServiceCollection()` 并注明为何不接配置;csproj 换 `Microsoft.Extensions.Configuration.Json`。 +- Avalonia:`Microsoft.Extensions.Hosting` → `Configuration.Json`;`db.json` 改 Dameng 示例(key=MainDb);`optional:false`。 +- 移除 `EnableConfigurationBindingGenerator`(真实路径是手写 binder,留着会误导)。 + +验证:`DatabaseConfigurationTest` 5/5;Dameng 配置工厂临时用例 3/3(连接串与代码路径等价、覆盖生效、缺 Server 抛错 —— dm8 容器当时未启动,无法真连库);`LightORMTest` 全量 22 通过 3 失败(均为既有:`TestConfig` 用空连接串、`ConstantExpressionTest` 两个走纯 ExpressionResolver);`LightORM.slnx` 仅 BenchmarkTest 编译失败(固定旧 NuGet 包,`Ado` 不存在,既有)。 + +## 追加:接入 PostgreSQL 与 SqlServer +- 核心新增 `LightORM/Options/DatabaseOptionsExtensions.cs`(public,第三方 provider 可用): + - `DatabaseOptions.ToDbOption(connectionString)`:统一搬运 `SalveConnectionStrings` / `IsUseIdentifierQuote` / `SpecificVersion` / `DetectVersion` / `DefaultStringLength`。 + - `DatabaseDefinition.ApplyTo(TableOptions)`。 + - `DatabaseConnectionString.Build(key, definition, hasSplitFields, factory, applyFields)`:连接串为底 + 字段覆盖;**无分散字段时原样返回**(不归一化);拼完为空抛可读异常。 +- `PostgreSQLProvider.Create(DatabaseOptions)` + `UsePostgreSQL()`:`Host`/`Port`/`Username`/`Password`/`Database`;`Settings["TableSpace"]`。 +- `SqlServerProvider.Create(DatabaseOptions)` + `UseSqlServer()`:`Data Source`/`Initial Catalog`/`User ID`/`Password`;**`SqlConnectionStringBuilder` 没有 Port**,端口拼进 `Data Source=host,port`,Server 已含 `,`/`\` 时再给 Port 直接报错。 +- 达梦改用同一 helper,删掉自己那份 overlay 逻辑(行为不变:无 Server 时 Port 默认 5236)。 +- 验证(临时用例,跑完已删):PG 3/3 —— 分散字段拼出 `Host=localhost;Port=5432;Username=postgres;Password=pwd;Database=testdb`、overlay 只改 Port/Database 且保留 Host=otherhost、`UsePostgreSQL()` 登记后 `TryGetCreator("PostgreSQL")` 命中(含小写);SqlServer 2/2 —— `Data Source=localhost,1433;Initial Catalog=testdb;User ID=sa`、`DetectVersion=false` 时 `Capabilities.IsResolved=True`(不连库落 Baseline)、命名实例 + Port 抛可读异常。 +- 注:`LightORMTest.SqlServer` 项目没有 `InternalsVisibleTo`,端到端注册验证放不到那个项目里(PG 有)。 + +## 追加:接完 MySql / Sqlite / Oracle / KingbaseES +- 用户中途澄清口径:**"覆盖率"只指拼出可用连接串必需的字段,连接超时/命令超时/连接池/应用名这类调优项不要**。据此把已加的 6 个调优字段(ConnectionTimeout/CommandTimeout/Pooling/MaxPoolSize/MinPoolSize/ApplicationName)全部回滚,只保留 `DataSource` / `ServiceName` / `Sid`。 +- `DatabaseConnectionString.Build` 由用户改成泛型(`where T : DbConnectionStringBuilder`),我进一步去掉 `hasSplitFields` 参数,改为内部调 `definition.HasSplitConnectionFields()`(字段清单只在一处维护)。 +- 四个方言的 `Create(DatabaseOptions)` + 空参 `UseXxx()` 全部就位;字段映射: + - MySql:`Server`/`Port`(uint)/`UserID`/`Password`/`Database`;顺手把构造期那条"库名正则"换成 `MySqlConnectionStringBuilder(cs).Database`(原正则只认字母下划线,库名带数字会误判)。 + - Sqlite:`DataSource` 优先,其次 `Database` 当库文件路径;都没有且无连接串 → 抛错说明 Server/Port/凭据无意义。 + - Oracle:`DataSource`(TNS 别名/描述符/EZ Connect)→ `ServiceName`(`host:port/service`,默认 1521)→ `Sid`(完整 DESCRIPTION)→ 裸 `Server`(当别名,Port 有值才拼);ServiceName 与 Sid 同给、或给了却没 Server → 抛错。 + - KingbaseES:同 PG(`Host`/`Username`)。 +- 验证(临时用例,跑完已删):Sqlite 2/2(`data source=temp.db`、`Database` 字段也当路径);MySql 1/1(`Server=localhost;Port=3306;User ID=root;Password=pwd;Database=test_db`);Oracle 3/3(`localhost:1521/XE` / `SID=ORCL` 描述符 / TNS 别名 `MYTNS`);KingbaseES 2/2(`Host/Port/Username/Database` 正确、DataSource 优先于 Server)。全部七个 provider 多 TFM 编译通过。 + + + + +## 追加:Oracle DataSource 语法核实(用户问 "ip:port/(serviceName 或 Sid) 就可以?") +- **结论:`ip:port/xxx` 的 xxx 在 Oracle 语法里是 service_name,不是 SID。** 官方 ODP.NET 文档的 EZ Connect 形式为 `[//]host[:port][/service_name]`;Easy Connect Plus 才多出 `[:server][/instance_name]` 两个后缀位,SID 依然不在第一段。 +- 用户之所以觉得"都能用",是因为**单实例/默认安装下 service_name 通常与 SID 同名**(XE 的 SID 和 service 都是 XE);RAC 下 SID=`ORCL1`/`ORCL2` 而 service=`ORCL`,`/ORCL1` 直接 ORA-12514。所以当前 `Sid` 走完整描述符 `(DESCRIPTION=...(CONNECT_DATA=(SID=...)))` 是唯一始终正确的写法,保留。 +- 顺手修掉一个隐患:原来 `Server` 有值但无 ServiceName/Sid 时会拼 `RACE:1521` —— 既不能精确匹配 TNS 别名,也不是合法 EZ Connect(缺 service_name)。改为**抛 LightOrmException**,提示"只连 TNS 别名请去掉 Port"。`Server` 单独给仍原样当别名返回。 +- 本机 Oracle(localhost:1521)当前未启动,无法实测;结论来自 Oracle 官方文档 + 语法推导。 +- 环境注意:本次沙箱下 `dotnet build` 会因 `C:/Users/Marvel/AppData/Roaming/NuGet` 无权限而 restore 失败,**加 `--no-restore` 可正常编译**。 diff --git a/.workbuddy/memory/MEMORY.md b/.workbuddy/memory/MEMORY.md index c71d601e..bb61a189 100644 --- a/.workbuddy/memory/MEMORY.md +++ b/.workbuddy/memory/MEMORY.md @@ -1,133 +1,110 @@ # LightORM 项目长期备忘 -## 构建 / 命令环境(关键) -- bash 沙箱:**每条命令前加** `export PATH="/usr/bin:/bin:$PATH"`(初始 PATH 缺 /usr/bin,shell 状态不跨调用保留)。 +> 细节推导与实验原始记录见 `.workbuddy/memory/YYYY-MM-DD.md`;本文件只留结论与铁律。 + +## 构建 / 命令环境 +- bash 沙箱:**每条命令前加** `export PATH="/usr/bin:/bin:$PATH"`(shell 状态不跨调用保留)。 - dotnet 缺环境变量 → restore 报 `Value cannot be null (path1)`。补: - `export APPDATA="C:\Users\Marvel\AppData\Roaming" PROGRAMDATA="C:\ProgramData" && env "ProgramFiles=C:\Program Files" "ProgramFiles(x86)=C:\Program Files (x86)" dotnet ` -- dotnet 输出会被沙箱吞掉(PowerShell 工具偶尔也完全无回显)→ **重定向到文件最稳**:`dotnet test ... > out.txt 2>&1; echo "EXIT=$?"`,再 `grep -a`(中文日志必须 `-a`)。 -- `--no-build` 前必须**刚 build 过目标项目自己**(共享 LightORMTest.dll 在各 provider bin 下是独立副本)。 -- NuGet:本地源 `E:\GitRepositories\LocalNuget`;全局包目录 `E:\Nuget\.nuget\packages`。反编译 `C:\Users\Marvel\.dotnet\tools\ilspycmd.exe`。 -- **不要用 `git stash`**(本仓库会留残缺 `refs/stash`,并让 status/log/diff 因 submodule `src/GenShared` 报错);清理用 `git update-ref -d refs/stash`。submodule 本地完整副本在 `E:\GitRepositories\MT.Generators.Shared`;ssh 被沙箱拒绝,重克隆需用户本地执行。 -- 判断"文件/对象是否真的缺失"要用**第二个独立工具**(PowerShell Test-Path)交叉验证,别只信 bash 沙箱。回收站可恢复 git 对象:枚举 `$R*` → zlib 头卷积 → 解压后以 `blob `/`tree `/`commit ` 开头即为对象 → 对解压内容求 SHA-1 → 缺失则复制(只增不改)。**同一仓库同时开 SourceTree / UGit / VS 的 Git 工具是高危。** + `env "ProgramFiles=C:\Program Files" "ProgramFiles(x86)=C:\Program Files (x86)" APPDATA="C:\Users\\AppData\Roaming" PROGRAMDATA="C:\ProgramData" dotnet ` +- dotnet 输出常被沙箱吞掉 → **重定向到文件**:`dotnet test ... > out.txt 2>&1; echo "EXIT=$?"`,再 `grep -a`(中文日志必须 `-a`)。 +- `--no-build` 前必须**刚 build 过目标项目自己**(各 provider bin 下 `LightORMTest.dll` 是独立副本)。 +- NuGet:本地源 `E:\GitRepositories\LocalNuget`;全局包目录 `E:\Nuget\.nuget\packages`;反编译 `ilspycmd`。 +- **不要用 `git stash`**(留残缺 `refs/stash`,并让 status/log/diff 因 submodule `src/GenShared` 报错);清理用 `git update-ref -d refs/stash`。submodule 完整副本 `E:\GitRepositories\MT.Generators.Shared`;ssh 被沙箱拒,重克隆需用户本地执行。 +- 判断"文件/对象是否真缺失"要用**第二个独立工具**(PowerShell `Test-Path`)交叉验证。**同一仓库同时开 SourceTree / UGit / VS 的 Git 工具是高危**(回收站可恢复 git 对象:`$R*` → zlib 解压 → `blob `/`tree `/`commit ` 开头 → 求 SHA-1 → 缺失则复制)。 +- `ArgumentNullException.ThrowIfNull` 在 net462/netstandard2.0 靠 `src/LightORM/ExceptionPolyfills.cs`(`internal`,在 `namespace System` 用 C# 14 extension block)+ 各方言/DI 项目的 `InternalsVisibleTo` 解析 —— **跨程序集能用是靠 IVT**,不是 BCL。 ## 项目约定 -- 多目标框架 **net462;net8.0;net10.0**(`src/SupportedFrameworks.props`;**netstandard2.0 已移除**,别再按旧记录找它);版本号集中在 `src/versions.props`。 +- 多目标 **net462;net8.0;net10.0**(`src/SupportedFrameworks.props`;netstandard2.0 已从核心移除)。版本号集中在 `src/versions.props`。 - 源生成器:`LightOrmTableContextGenerator` + `LightOrmExtensionGenerator`;用生成器的项目必须 `enable`。 -- `AddLightOrm` 在 namespace `LightORM`(IoCExtensions.cs)。 +- `AddLightOrm` 在 namespace `LightORM`(`IoCExtensions.cs`)。 - 驱动:MySqlConnector 2.6.0、Microsoft.Data.SqlClient 7.0.1(net462 走 System.Data.SqlClient)。 -- 测试命令:`dotnet test test/LightORMTest.Sqlite/LightORMTest.Sqlite.csproj --filter "FullyQualifiedName~Update|FullyQualifiedName~Json" -l "console;verbosity=detailed"`。SqlGenerate 目录用例只 `Console.WriteLine` **不连库**(离线可跑)。 +- 测试:`dotnet test test/LightORMTest.Sqlite/... --filter "FullyQualifiedName~Json" -l "console;verbosity=detailed"`。SqlGenerate 目录用例只 `Console.WriteLine` 不连库(离线可跑)。 - DatabaseUtils(WPF) → DatabaseUtils.Avalonia 迁移:阶段一/二已完成,剩 ViewModel / View / 回归。 -## 方言能力开关现状 -| 方言 | 现有手写开关 | 位置 | 影响 | -|---|---|---|---| -| SqlServer | ~~`SqlServerVersion`(V1/Over2012/Over2017)~~ **已删除**,改由版本推导 | `SqlServerCapabilities.Features` ← provider 构造期 `Start(...)`;adapter / MethodResolver 均接收 capabilities | `OffsetFetch`(2012+) 分页、`TrimFunction`(2017+) | -| MySQL | ~~`MySqlTableOptions.Version`~~ **已删除**,改由版本推导 | `CustomMySqlAdapter` ← `MySqlCapabilities.Features` | `GroupByRollup`(8.0+):`ROLLUP()/CUBE/GROUPING SETS` vs 旧式 `WITH ROLLUP`;CUBE/GROUPING SETS 低版本交给数据库报错 | -| Oracle | ~~`OracleTableOptions.OverVersion`~~ **已删除**,改由版本推导 | `OracleTableHandler.UseIdentityColumn` ← `OracleCapabilities.Features` | 自增列 IDENTITY vs 序列+触发器 | -| Oracle | ~~DDL 写死 `JSON` / 写死 `JSON(:p)`~~ **已接能力位** | `OracleTableHandler.UseJsonNativeType` / `CustomOracleAdapter.UseJsonNativeType` ← `OracleFeatures.JsonNativeType` | 列类型 `JSON` vs `CLOB`;路径更新值 `JSON(:p)` vs `:p FORMAT JSON` | -| SQLite | ~~`JSONBackend.Binary` 无条件生效~~ **已接能力位** | `SqliteCapabilities.UseBinaryJson()` ← `SqliteFeatures.Jsonb`(3.45+) | 老版本自动降级 `jsonb_*` → `json_*`;`OpenBeforeRead => false`(**探测不建库文件,实测**) | -| PG / KingbaseES / Dameng | **不接入探测** | — | 实测没有按版本二选一的分支 ⇒ 探测结果无处可用,接入只会白搭一次连库开销 | +## 版本探测与方言能力位 +| 方言 | 能力位 | 影响 | +|---|---|---| +| SqlServer | `OffsetFetch`(2012+) / `TrimFunction`(2017+) | `OFFSET/FETCH` vs `ROW_NUMBER`;`TRIM()` vs `LTRIM(RTRIM())` | +| MySQL | `GroupByRollup`(8.0+) | `ROLLUP()/CUBE` vs 旧式 `WITH ROLLUP` | +| Oracle | `UseIdentityColumn` / `JsonNativeType`(21c+) | IDENTITY vs 序列+触发器;`JSON` 列 vs `CLOB`;`JSON(:p)` vs `:p FORMAT JSON` | +| SQLite | `Jsonb`(3.45+) | `jsonb_*` vs `json_*` | +| PG / KingbaseES / Dameng | **不接入探测** | 没有按版本二选一的分支,接入只是白搭一次连库 | + +- **未知版本基线是方言私有的、可以相反**:Oracle/MySQL 取保守(未知→`None`),因为新写法在旧库直接失败;SqlServer/**SQLite** 取乐观(未知→`Full`),因为旧写法在新库仍可跑,且能保证 `DetectVersion=false` 的 ToSql 场景**生成与引入探测前一致的 SQL**。 +- **能力位只登记"有多套写法"的能力**。单一实现(`JSON_VALUE`、`STRING_AGG`)不判版本,低版本交给数据库报错。 +- 探测三条关闭出口:`TableOptions.SpecificVersion` 有值(`Source=Explicit`,实测 0ms 不建连)/`DetectVersion=false`/连接串为空。 +- 版本在**provider 构造期烘焙**(先 `Capabilities`,再 handler / adapter / MethodResolver)。`Probe` 是 `protected`;`OpenBeforeRead` 是 `protected virtual`,**SQLite 覆盖为 false**(Open 会建出空库文件,纯 SQL 生成场景不能碰)。 +- 基类只有一层 `DbCapabilities`(`Implements/DbCapabilities.cs`)。**不要为"无能力位的方言"拆 1 参基类**(零实现的死抽象)。net462 不支持 `static abstract` ⇒ 静态工厂用 `new TDatabase()` 借空实例当元数据载体。`DbVersionProbe.None` 必须每次 `new` 而非共享单例(`Override` 改实例字段会污染 `Baseline`)。 +- 连接超时靠**方言改写连接串**(`Func`,核心只给策略,不枚举键名)。踩过的坑:ODP.NET 会把键名大写归一化;SqlServer/MySql/PG/KES 都接受 `Command Timeout` 且读回值相等 ⇒ 按键名试探无法区分语义。 +- **SqlServer 分页硬约束**:`OFFSET ... FETCH NEXT` 前必须有 `ORDER BY`。`CustomSqlServerAdapter.Paging` 在 `OrderBy.Count == 0` 时按主键补。这条路径接入探测后才第一次被真正执行。 +- **Oracle 身份列 DDL**:`GENERATED ALWAYS AS IDENTITY` 必须紧跟数据类型(写在 `NOT NULL` 后报 ORA-00907);身份列不能显式写 `NULL`(ORA-30670)。 +- **Oracle JSON 分界**:原生 `JSON` 列、`JSON()`、`JSON_TRANSFORM` 均 21c+(19c 建 JSON 列报 ORA-00902);`JSON_VALUE/JSON_QUERY` 需 12.1.0.2+ 且对 CLOB 同样有效;`FORMAT JSON` 18c 才真正生效;`CAST(... AS JSON)` 在 21.3 XE 报 ORA-00600。非原生分支**不用 `JSON_MERGEPATCH`**(整文档合并语义,会静默写错)。`SqlFn.JsonSet` 不接能力位。 +- **达梦 JSONB 实测(8.1.4.6)**:能建 `JSONB` 列,但 `JSONB_VALUE/JSONB_QUERY` 函数不存在 ⇒ `JSONBackend.Binary` 不可用,且**与版本无关**,不登记能力位,默认 `Text`。 +- **`InternalCreateTableAsync` 吞异常并 return false**(`ExpressionCoreSqlContextMethodImpl.cs:211`)→ DDL 失败不抛,只在后续以 `ORA-00942 表或视图不存在` 暴露。 -- **未知版本的基线策略是方言私有的,可以相反**:Oracle / MySQL 取**保守**(未知 → `None`:序列+触发器、CLOB、旧式 `WITH ROLLUP`),因为新写法在旧库直接失败;SqlServer / **SQLite** 取**乐观**(未知 → `Full`),因为它们的旧写法在新库仍可跑,且乐观能保证 `DetectVersion=false` 的 ToSql 场景**生成出与引入探测前一致的 SQL**(SQLite 的 `JSONBackend.Binary` 正是靠这条不变)。别把某一方的策略当通用规则。 -- **能力位只登记"有多套写法"的能力**(用户口径:只在涉及不同实现的地方才按版本判断)。SqlServer 只留 `OffsetFetch`(`OFFSET/FETCH` vs `ROW_NUMBER` 包裹)与 `TrimFunction`(`TRIM()` vs `LTRIM(RTRIM())`)。像 `JSON_VALUE`/`JSON_MODIFY`(仅 2016+)、`STRING_AGG`(仅 2017+)只有一种实现 → **不判版本**,低版本交给数据库报错("自己抛 NotSupported 和数据库报错差别不大")。 -- **SqlServer 分页的硬约束**:`OFFSET ... FETCH NEXT` 前面必须有 `ORDER BY`,否则报 `Incorrect syntax near 'OFFSET'` / `Invalid usage of the option NEXT`。`CustomSqlServerAdapter.Paging` 在 `builder.OrderBy.Count == 0` 时按主键补一个 `ORDER BY`;`SelectBuilder` 正是 `OrderBy.Count > 0` 才写 ORDER BY,故该信号精确。**注意**:这条路径以前从未被覆盖——老代码 `Paging` 只判 `== Over2012`,而测试用的是 `V1`/`Over2017`,全部走 ROW_NUMBER 分支,所以接上探测后(探测到 16.0)才第一次真正执行 `OFFSET/FETCH`。 -- **探测是可选特性**:`TableOptions.SpecificVersion` 有值 → 不探测(`ForVersion`,`Source=Explicit`);`TableOptions.DetectVersion = false`(基类,默认 true)→ 不探测;连接串为空 → 不探测。三条出口 + 探测失败,各方言按自己的基线(SqlServer=完整功能)。典型用途:ToSql 纯 SQL 生成场景(不连库)。 -- 版本在**构造期烘焙**:`SqlServerProvider` 构造里先建 `Capabilities`,再 `SqlServerTableHandler` / `SqlServerMethodResolver(Capabilities)` / `CustomSqlServerAdapter(Capabilities, …)`(MySQL/Oracle 同序:必须先取 `option.NewFactory ?? XxxFactory.Instance`,因为原来 `DbProviderFactory` 属性是在最后一行才赋值的)。 -- **进程内版本切换**:SqlServer 的 `SqlServerMethodResolver` 现在有无参构造(= `Baseline` = 完整功能),公开构造改收 `SqlServerCapabilities`。 -- **能力档案基类只有一层**(`src/LightORM/Implements/DbCapabilities.cs`):`DbCapabilities`,给 `Baseline` / `ForVersion` / `Start` / `ServerVersion` / `Version` / `Source` / `IsResolved` / `Override` / `Features`;方言给 `ProbeTarget`(抽象)+ `MapFeatures`(抽象),`PrepareProbeConnectString` / `OpenBeforeRead` 是**虚成员带默认值**(默认不改写连接串、默认先 Open)。 - - `ProbeTarget` / `PrepareProbeConnectString` / `MapFeatures` **都是实例成员**(见下条原因)。 - - **不要为"无能力位的方言"拆一个 1 参基类**:那层会变成零实现的死抽象。用户口径是"探测的唯一目的是喂能力位,没有能力位就不要探测"。若将来真出现"要探测但暂时没能力位"的方言,再补一个框架自带的空枚举 + `MapFeatures` 默认实现。 - - **net462 / netstandard2.0 不支持接口静态抽象成员**(`static abstract` 需 .NET 7+ 运行时),基类也没有抽象静态方法 ⇒ 静态工厂要拿方言信息,只能 `new TDatabase()`(`new()` 约束)借一个**空实例**当元数据载体,读出探测键/连接串改写/`OpenBeforeRead`,再把 `DbVersionProbe` 写回该实例返回(CRTP 下基类通过类型参数访问 `protected` 成员是合法的)。 - - `Probe` 是 `protected { get; set; }`(原为 `public required`);`OpenBeforeRead` 是 `protected virtual`,**SQLite 覆盖为 false**——它未 Open 即可读 `ServerVersion`,而 Open 会在文件不存在时建出空库文件(纯 SQL 生成场景绝不能碰)。 -- **实测服务端版本串**(写临时 MSTest 打印 `conn.ServerVersion`,跑完删除):Sqlite `3.46.1` / PG `16.4 (Debian 16.4-1.pgdg120+1)` / **KingbaseES `12.1`(是 PG 兼容版本号,不是 `V009R001C001B0025`)** / Dameng `8.1.4.6`。 - - 备用(PG/KES/Dameng 目前**不**接入探测,故未使用,需要时直接可用):`NpgsqlConnectionStringBuilder.Timeout`、`KdbndpConnectionStringBuilder.Timeout`、`DmConnectionStringBuilder.ConnectionTimeout` 三者都存在且已编译验证;SQLite 无需改写连接串。 -- **达梦 JSONB 实测(DM 8.1.4.6)**:`CREATE TABLE t (C1 JSONB)` 能建成功,但 `JSONB_VALUE` / `JSONB_QUERY` **函数不存在**(`JSON_VALUE` 正常)。⇒ `JSONBackend.Binary` 在达梦不可用,但**与版本无关**,属"只有一种写法",**不登记能力位**,保留默认 `Text`。 -- **`Resolve` 表达式缓存是静态且方言无关**:key = `(SqlAction, Hash, NestedLevel)`(`Utils/ExpressionResolver.cs`),无方言维度 → 同进程内不同方言/不同版本的同类 provider 会串味(**既存缺陷,非版本探测引入**)。 - - 正确键模型 = `(SqlAction, 标识符引用身份, Hash, Depth)`;身份至少含 `Emphasis` + 生效引用开关(`QuoteIdentifiers ?? UseIdentifierQuote`)。**只放 `Emphasis` 不充分**(Oracle 与 PG 都是 `""`;且同方言逐语句 `.QuoteIdentifiers()/.NoQuoteIdentifiers()` 就翻转)。 - - **参数前缀不是维度**:解析期不读 `database.Prefix`,它由 `SqlBuilder.HandleSqlParameters` 的 `AttachPrefix` 事后补。 - - **状态(09-17):该改动已整体回滚**(用户决定先不处理),`ExpressionResolver.cs` 与 HEAD 零差异;详细反例与证据留档在 `memory/2026-09-17.md`。重新捡起时**先查**"多方言同进程时 PG 输出整段是 Oracle 的"那条异常(疑点:投影段 `ResolveContext.Database` 不是当次 adapter / `TryGet` 探不到)。 -- 版本探测线**已落地**(保留中):`Models/DbServerVersion.cs`(`CapabilitySource` + 版本模型)、`Implements/DbVersionProbe.cs`(构造期后台探测:单飞 / 限时 / 永不 fault / 后台自愈,**零方言词汇**)、`Providers.Oracle/OracleCapabilities.cs`(`[Flags] OracleFeatures` + `MapFeatures`,方言语义归 provider)。核心只做机制,不认识任何方言能力名。 -- **显式版本优先于探测**:`TableOptions.SpecificVersion`(**已在基类** `DbStruct/TableGenerateOption.cs:9`)有值时,`OracleCapabilities.Start(..., specificVersion)` 走 `ForVersion` → **不发起后台 Task、不建连**(实测 0ms / `Source=Explicit`)。 - - 坑:`DbVersionProbe.None` 原为**共享单例**而 `Override` 改实例字段 → 已改为 `=> new(null)` 每次新实例,否则显式覆盖会污染 `OracleCapabilities.Baseline`。 -- **Oracle 身份列 DDL 的两条硬约束(实测 21c,必须同时满足)**:`GENERATED ALWAYS AS IDENTITY` 必须紧跟数据类型(写在 `NOT NULL` 之后报 `ORA-00907`),且身份列不能显式写 `NULL`(报 `ORA-30670`)。见 `OracleTableHandler.Writer.BuildColumn`。 -- **连接超时由方言"改写连接串"**(核心不枚举、不猜测键名):`DbVersionProbe.Start(..., Func? prepareConnectString)` —— 核心只给策略(探测必须秒级返回),表达方式是方言私有知识。Oracle 用强类型 `new OracleConnectionStringBuilder(cs){ ConnectionTimeout = seconds }`(实测改写生效:黑洞地址 5090ms → 2001ms,构造仍 1ms 不阻塞,读 Version 恰好一次超时 2014ms → Assumed)。 - - 不用"超时键名字符串"的理由:写错只能运行期发现;且实测 SqlServer/MySql/PG/KES **都接受 `Command Timeout` 且读回值相等**(映射另一属性)⇒ 按键名试探无法区分语义,"写回读校验"也兜不住。 - - 坑:ODP.NET 的 `OracleConnectionStringBuilder` 输出会**把键名大写归一化**(`CONNECTION TIMEOUT=2`),键名本身大小写不敏感,别用原文 Contains 做断言。 - - 委托 `internal static string? PrepareProbeConnectString(cs, seconds)`:返回 null / 抛异常 → 核心沿用原连接串。 -- **Oracle JSON 能力的版本分界(实测 + 官方文档)**:原生 `JSON` 列类型 / `JSON()` 构造器 / `JSON_TRANSFORM` 均 **21c+**(19c 建 `JSON` 列报 ORA-00902;`JSON_TRANSFORM` 被回移到 19c 但**仅较新 RU**:19.3 无、19.17 有 ⇒ 版本号不可靠)。`JSON_VALUE`/`JSON_QUERY` 需 **12.1.0.2+**,且**对 CLOB 文本列同样有效**(无需 `IS JSON` 约束)。`FORMAT JSON` 12.1 起语法被接受但**18c 才真正生效**(12c 文档标注"仅为语义清晰",含该子句会不稳定地影响输出)。`CAST('...' AS JSON)` 在 21.3 XE 上报 **ORA-00600 内部错误**,别用。 - - 非原生分支用 `:p FORMAT JSON` 而非 `JSON_MERGEPATCH`:后者是**整文档合并**语义,等价不了"设置某路径"(对象会合并、数组下标无法设),会静默写错数据。 - - `SqlFn.JsonSet` 口子**不接能力位**:它的值是用户手写的 SQL 表达式(PG 侧要写 `'"NewName"'`),套 `FORMAT JSON` 会把 `'test'` 变成非法 JSON 文本。 -- **`InternalCreateTableAsync` 吞异常并 return false**(`ExpressionCoreSqlContextMethodImpl.cs:211`)→ DDL 失败不抛,只在后续操作以 `ORA-00942 表或视图不存在` 暴露。排查 ORA-00942 先怀疑建表静默失败。 -- `ExpressionSqlOptions.SetDatabase` 只保留每个 `DbBaseType.Name` 的**第一个** adapter(`customDatabases`),`ResolveContext.Create(DbBaseType)` 走它;且 `databaseProviders/customDatabases/defaultDbKey` **全是 static 全局**,同名 key 走 `TryAdd` = **先注册者胜、后来者静默丢弃**(多方言 A/B 必须用具名 key + `SetDefault` 切换)。 -- `Builder/AdapterCapability.TryGet` 已存在:穿透 `ScopedDatabaseAdapter` 探测能力接口 → 新增能力不必改 `IDatabaseAdapter`(不破坏第三方实现)。 +## 全局静态状态(已知缺陷源) +- `ExpressionSqlOptions` 的 `databaseProviders / customDatabases / databaseHandlers / defaultDbKey` **全是 static**,且 `SetDatabase` 用 `TryAdd` = **先注册者胜、后来者静默丢弃**。`customDatabases` 按 `DbBaseType.Name` 只留第一个 adapter,而能力位是烘焙在 adapter 实例里的 ⇒ **同一方言多实例(不同版本/不同 UseIdentifierQuote)会串味**。多方言 A/B 必须用具名 key + `SetDefault` 切换。 +- `Resolve` 表达式缓存 key 只有 `(SqlAction, Hash, NestedLevel)`,**无方言维度** ⇒ 同进程跨方言串味(既存缺陷)。正确键还需标识符引用身份(`Emphasis` + 生效引用开关);参数前缀不是维度(解析期不读 `database.Prefix`)。09-17 整体回滚,重拾前先查"多方言同进程 PG 输出整段是 Oracle 的"。 +- `Builder/AdapterCapability.TryGet` 可穿透 `ScopedDatabaseAdapter` 取能力接口 → 新增能力不必改 `IDatabaseAdapter`。 -## 反向读表结构(`GetTablesSql` / `GetTableStructSql` / `ParseDataType`) -- 现状(2026-09-18):**七个方言全部实现**,不再有 `NotImplementedException`。 -- 达梦实现(`src/Providers/LightORM.Providers.Dameng/DamengTableHandler.cs`)——**坑最多,动手前先看这几条**: - - 列表:`SELECT TABLE_NAME AS TableName FROM USER_TABLES ORDER BY TABLE_NAME`。 - - 结构主表 `USER_TAB_COLUMNS`(Oracle 风格),另需三张辅助对象(全部 `LEFT JOIN`,挂不上只会让该列退化为 `NO`/空串): - `USER_COL_COMMENTS`(注释)、`USER_CONSTRAINTS`+`USER_CONS_COLUMNS`(主键)、 - **`SYSCOLUMNS`**(经 `SYSOBJECTS.NAME=tc.TABLE_NAME AND TYPE$='SCHOBJ' AND SUBTYPE$='UTAB'` 定位)。 - - **`USER_TAB_COLUMNS` 没有 `IDENTITY_COLUMN` 列**(实测报"无效的列名"),IDENTITY 列的 `DATA_DEFAULT` 也是空的 ⇒ 自增只能从 `SYSCOLUMNS.INFO2` 的 bit0 判:`(NVL(s.INFO2,0) & 1) = 1`。实测 IDENTITY 列 `INFO2=1`、普通列 `0`。 - - **`USER_TAB_COLUMNS.DATA_LENGTH` 对 `NVARCHAR2` 是字节数**:`NVARCHAR2(64)` 给 128,且 `CHAR_LENGTH=0`。 - **`SYSCOLUMNS.LENGTH$` 才是字符数**(给 64)⇒ Length 一律取 `s.LENGTH$`。这条最容易踩。 - - **JSON / JSONB 物理存成 `BLOB`**(`DATA_TYPE='BLOB'`),与真 BLOB 无法靠类型名区分。 - 判别特征:`SYSCOLUMNS.SCALE = 16384`(达梦给 JSON 的 BLOB 打的内部子类型标记,普通 BLOB 为 0)。 - SQL 里改写成 `CASE WHEN DATA_TYPE='BLOB' AND s.SCALE=16384 THEN 'JSON' ELSE DATA_TYPE END`。 - 另有官方视图 `USER_JSON_COLUMNS(TABLE_NAME,COLUMN_NAME,FORMAT,DATA_TYPE)` 可用,但它是随 JSON 特性附带引入的, - 用 `SYSCOLUMNS` 少一层"视图是否存在"依赖(失败模式也更温和:读成 byte[] 而非整条 SQL 报错)。 - - **`DATA_SCALE` 不是纯小数位**:非数值类型也占它 —— JSON/JSONB=16384、`NVARCHAR2`/`NVARCHAR`=7、`NCHAR`=8、`TIMESTAMP`=6。 - 所以数值分支要 `WHEN s.TYPE$ IN ('DECIMAL','NUMERIC','NUMBER','DEC') AND s.LENGTH$ > 0` 双重限定。 - - Length 表达式:LOB 类(TEXT/CLOB/BLOB/IMAGE/LONGVARCHAR/LONGVARBINARY)给 `''`;数值类给 `"精度,标度"`(标度 0 时只给精度);其余 `s.LENGTH$ > 0` 才给 `TO_CHAR(s.LENGTH$)`,否则 `''`。 - - `ParseDataType`:`DATA_TYPE` 是**不带括号的纯类型名**(`VARCHAR2`/`DECIMAL`/`CHAR`),所以定点细分只能靠 `column.Length`(`"18,2"` / `"9"`)。 - `NumericType` 分档:带逗号 → decimal;无精度信息 → **decimal**(达梦裸 `NUMBER` 是浮点语义,给 int 遇小数会炸)。 - - 类型事实(实测 DM 8.1.4.6):**`BOOLEAN` 和 `UUID` 不能建列**("无效的数据类型" / "非法的基类名"); - `NCLOB`/`XMLTYPE` 被归一化成 `TEXT`;`BINARY_DOUBLE`→`DOUBLE`; - **`FLOAT` 是 8 字节双精度、`REAL` 才是 4 字节单精度**(所以 `ParseDataType` 里 FLOAT→double、REAL→float,与 writer 的 `Single→FLOAT` 刻意不对称)。 - - 与 writer 不对称是刻意的:`bool` 写 `CHAR(1)`、`Guid` 写 `CHAR(36)`,读回都只能给 `string`(真 `CHAR(1)` 多存 `'Y'`/`'N'`,猜 bool 会反序列化失败)。口径同 SQLite:**不做 writer 私有约定的逆向猜测**。 - - 达梦支持 `DROP TABLE IF EXISTS`(探针用得上)。表名精确匹配(`WHERE tc.TABLE_NAME = '{t}'`),不做 `UPPER()` 模糊,避免大小写不同的同名表混在一起。 -- 探针方法(本次全程这么干的,以后摸新方言照此办理):写临时 MSTest 类 + `DmConnection` 直连, - 先**逐类型 `CREATE TABLE ("C1" )`** 打出支持/不支持,再建一张"全类型表"用 `SELECT * FROM USER_TAB_COLUMNS` / - `SYSCOLUMNS` 打印**每个列的元数据**(DATA_TYPE/DATA_LENGTH/DATA_PRECISION/DATA_SCALE/CHAR_LENGTH/LENGTH$/SCALE/INFO2), - 最后把**最终 SQL 原样预演一遍**。比反复改 C# 跑测试快一个数量级。 -- SQLite 实现(`src/Providers/LightORM.Providers.Sqlite/SqliteTableHandler.cs`): - - 列表:`sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite\_%' ESCAPE '\'`(排除引擎内部表)。 - - 结构:用**表值函数 `pragma_table_info('t')`**,**不能**用 `PRAGMA table_info(t)` 命令 —— 命令不能出现在 SELECT/子查询里,而"是不是 rowid 别名"要数同表主键列个数。 - - `IsIdentity`:`pk>0 AND upper(trim(type))='INTEGER' AND (SELECT COUNT(*) ... pk>0)=1`。 - - `Nullable`:`notnull=1 OR pk>0` → `'NO'`;`Comments` 恒 `''`(SQLite 无列注释);`Length` 从声明类型括号里切。 - - 表名要塞进字符串字面量 ⇒ 必须 `Replace("'", "''")`(带单引号的表名否则把查询拆坏)。 - - `ParseDataType`:先剥 `(len)` 再 `ToUpperInvariant()` 精确匹配;未命中按 **SQLite 官方亲和性顺序**兜底(INT → CHAR/CLOB/TEXT → BLOB → REAL/FLOA/DOUB),都不中 → `object?` 且 `return false`(NUMERIC 兜底桶不猜)。**顺序不可改**:`FLOATING POINT` 里 `POINT` 含 `INT` ⇒ 引擎判定它是 INTEGER 亲和性。 - - net462 无 `System.Range`/`System.Index` ⇒ 用 `Substring(0, paren)`,不能写 `declared[..paren]`。 - - 写/读**不一一对应**:写出去 byte/sbyte/short/ushort/int/uint/long/ulong/bool 全落 `INTEGER`,float/double/decimal 全落 `REAL`,读回只能取 `int` / `double`;要精确类型得显式声明(`BIGINT`、`DECIMAL(18,2)`)。 -- 验证方式(**曾用的测试文件已被用户主动删除、未入库**):`test/LightORMTest.Sqlite/SchemaReadTest.cs`(5 用例,5/5 通过) - 与 `test/LightORMTest.Dameng/SchemaReadTest.cs`(4 用例,4/4 通过)曾用于验证这两处实现,提交前由用户移除 ⇒ - **不要把"反向读表有回归测试"当既成事实**。将来补这类用例时要表自建自删,且不要继承 InitData 重建 - (达梦单次 init ≈5s,别挂到共享 ExecutionTest 下)。 +## 反向读表结构(七方言已全部实现) +- **达梦坑最多**(`Providers.Dameng/DamengTableHandler.cs`): + - 主表 `USER_TAB_COLUMNS` + `LEFT JOIN` `USER_COL_COMMENTS` / `USER_CONSTRAINTS`+`USER_CONS_COLUMNS` / `SYSCOLUMNS`(经 `SYSOBJECTS.NAME=tc.TABLE_NAME AND TYPE$='SCHOBJ' AND SUBTYPE$='UTAB'` 定位)。 + - **`USER_TAB_COLUMNS` 没有 `IDENTITY_COLUMN` 列** ⇒ 自增只能判 `SYSCOLUMNS.INFO2 & 1 = 1`。 + - **`DATA_LENGTH` 对 `NVARCHAR2` 是字节数**(64 字符给 128);**Length 一律取 `SYSCOLUMNS.LENGTH$`**。 + - **JSON/JSONB 物理是 `BLOB`**,靠 `SYSCOLUMNS.SCALE=16384` 区分(普通 BLOB 为 0)。 + - **`DATA_SCALE` 不是纯小数位**(NVARCHAR2=7、NCHAR=8、TIMESTAMP=6)⇒ 数值分支要加 `TYPE$ IN (...)` 双重限定。 + - 裸 `NUMBER` 给 **decimal**(达梦是浮点语义,给 int 遇小数会炸)。`FLOAT`=8 字节双精度、`REAL`=4 字节单精度。 + - **`BOOLEAN`/`UUID` 不能建列**;`bool` 写 `CHAR(1)`、`Guid` 写 `CHAR(36)`,读回只给 `string`(不做 writer 私有约定的逆向猜测,同 SQLite 口径)。 + - 支持 `DROP TABLE IF EXISTS`;表名精确匹配,不做 `UPPER()`。 +- **SQLite**:列表排除 `sqlite_%`;结构必须用**表值函数 `pragma_table_info('t')`**(`PRAGMA table_info` 不能进 SELECT)。表名需 `Replace("'", "''")`。`ParseDataType` 未命中按**官方亲和性顺序**兜底(顺序不可改:`FLOATING POINT` 里 `POINT` 含 `INT`)。net462 无 `System.Range` ⇒ 用 `Substring`。 +- 探针方法论:写临时 MSTest 直连,先逐类型 `CREATE TABLE ("C1" )` 探支持度,再建全类型表打印**每列元数据**,最后把最终 SQL 原样预演。比改 C# 跑测试快一个数量级。 +- 反向读表的回归测试(SchemaReadTest)**已被用户删除、未入库**,别当既成事实。 -## JSON 列与方言约定 -架构:序列化下沉到 `IDatabaseParameterBinder.BindParameter`;`DbParameterValue` 携带原始 CLR 值;`CustomDatabaseAdapter` 给默认 json 绑定。`src/LightORM/Utils/JsonParameterHelper.cs`:`Serialize` + `IsCompositeJsonValue`(标量白名单:string/char/数值/Guid/DateTime/TimeSpan/byte[]/Uri/Version/object)+ `IsCompositeJsonLeaf(JsonColumnContext)`。 -**缓存约束**:SQL 侧"形状分支"只能由表达式结构(成员类型)决定,不能用运行时值。 +## JSON 列约定 +- 序列化下沉到 `IDatabaseParameterBinder.BindParameter`;`DbParameterValue` 携带原始 CLR 值;`Utils/JsonParameterHelper.cs` 提供标量白名单与 `IsCompositeJsonLeaf`。 +- **缓存约束**:SQL 侧形状分支只能由表达式结构决定,不能用运行时值。 -| 方言 | 路径更新值参数 | 读末级标量 / 复合 | +| 方言 | 路径更新值 | 读末级标量/复合 | |---|---|---| -| PG / KingbaseES | `@p::JSONB` | `(col->>'p')::T` / 同左(数组 `col->N`) | -| SQLite | `JSON(@p)` | `json_extract` / 同左 | -| SqlServer | 复合 `JSON_QUERY(@p)`;标量传原生值 | `JSON_VALUE` / `JSON_QUERY`(已修,未实测) | -| MySQL | `CAST(?p AS JSON)`(5.7.44 实测通过) | `col->>'$.p'` / 同左 | -| Dameng | `CAST(:p AS JSON)`(实测一律正确) | `JSON_VALUE`(Binary 起 `JSONB_VALUE`)/ **未验证** | -| Oracle | 21c+ `JSON(:p)`;≤19c `:p FORMAT JSON`(均在 JSON_TRANSFORM 内) | `JSON_VALUE` / `JSON_QUERY`(21c XE 通过) | +| PG / KingbaseES | `@p::JSONB` | `(col->>'p')::T` / 数组 `col->N` | +| SQLite | `JSON(@p)` | `json_extract` | +| SqlServer | 复合 `JSON_QUERY(@p)`;标量传原生值 | `JSON_VALUE` / `JSON_QUERY` | +| MySQL | `CAST(?p AS JSON)` | `col->>'$.p'` | +| Dameng | `CAST(:p AS JSON)` | `JSON_VALUE` | +| Oracle | 21c+ `JSON(:p)`;≤19c `:p FORMAT JSON` | `JSON_VALUE` / `JSON_QUERY` | -- **整列更新一律 `col = @p`**(无路径成员时)。MySQL `JSON_SET` 首参 NULL → 整体 NULL(静默丢值);KingbaseES `JSONB_SET` 空路径不能替换整文档。 -- 例外:`SqlFn.JsonSet(path,value)` 走 `XxxMethodResolver`,值参数**不序列化**;PG 侧用户自传 JSON 文本(`"\"NewName\""`)。MySQL 侧传原始 CLR 值。 -- MySQL 受影响行数:`ON DUPLICATE KEY UPDATE` 插入 1 / 更新 2 → 断言按 DbType 分支。 -- `DbBaseType` 是 record(按 Name 相等),Kingbase 的 Name 是 `"KingbaseES"` → 写 `DbType.Name is "PostgreSQL" or "KingbaseES"`。 -- 达梦列类型默认 `JSON`(>320000 走 CLOB);`JSONBackend.Binary` 在本机 DM8 不可用,用默认 `Text`。 -- 定位 json 问题先写**方言语义探针**(Python sqlite3 / sqlcmd / DmCommand)验证函数行为,比反复改 C# 跑测试快。 +- 整列更新一律 `col = @p`(MySQL `JSON_SET` 首参 NULL 会整体置 NULL;KingbaseES `JSONB_SET` 空路径不能替换整文档)。 +- MySQL `ON DUPLICATE KEY UPDATE` 受影响行数 1/2 分叉,断言按 DbType 分支。`DbBaseType` 是 record(按 Name),Kingbase 的 Name 是 `"KingbaseES"`。 ## 测试基础设施 -- 容器常驻:`dm8` 5236 / `kes` 54321 / `oracle21xe` 1521(`localhost:1521/XE`,lightorm_test) / `mysql` 3306(**本机 MySQL 5.7.44**:无 CTE/窗口函数,CUBE 抛 NotSupported,MySql 全量 144/155,失败 11 个全部由此而来)/ `pgsql` 5432 / `mssql` 1433。 +- 容器:`dm8` 5236 / `kes` 54321 / `oracle21xe` 1521(`localhost:1521/XE`) / `mysql` 3306(**本机 5.7.44**:无 CTE/窗口函数,CUBE 抛 NotSupported)/ `pgsql` 5432 / `mssql` 1433。 - 用例数:Dameng 270 / Oracle 194 / Sqlite 168 / KingbaseES 100。 -- **Sqlite 全量别想一次跑完**:单用例含 20s 级底噪,全量 >15min 会被工具超时打断(要用 `--filter` 收窄,如 `~Json`)。收窄跑时看到 `Group_Cube_Test` 因 `no such function: CUBE` 失败——SQLite 本就不支持 `CUBE`(MySQL 侧早就改成"交给数据库报错",这个用例在 Sqlite 上注定失败),与版本能力位无关。 -- 每个用例前 `ExecutionTest.InitData.cs` 的 `[TestInitialize]` 重建整个 schema(10 表 DROP+CREATE + 8 表清空重插)→ 每个用例都有几秒底噪,MSTest 耗时含它。 -- 达梦慢的真原因:① DDL 单条约 25ms/条且每条自带提交,单次 init ≈4.8s(Kingbase 同项 0.57s);② `DamengTableHandler.Writer` 把 CREATE/COMMENT/INDEX 各 yield 一次(10 表 = 131 条语句 = 131 次往返),PG/Kingbase 每表 yield 一次。**批量化已实测不可行**(`;` 多语句被拒;匿名块慢 7 倍)→ 只能减少 DDL 条数/次数。 -- 重复测试类:Dameng / PostgreSQL / SqlServer 项目里 `ResultTest/ExecutionTest.cs` 与 `SelectResult.cs` 都继承共享 `ExecutionTest`(100 用例) → 共享套件跑两遍。 +- **Sqlite 全量跑不完**:单用例 20s 级底噪,全量 >15min 会被工具超时打断,用 `--filter` 收窄。`Group_Cube_Test` 在 Sqlite 注定失败(本就不支持 CUBE)。 +- `ExecutionTest.InitData` 的 `[TestInitialize]` 每用例重建整个 schema → 每个用例几秒底噪。 +- 达梦慢的原因:DDL 单条 ~25ms 且自带提交,单次 init ≈4.8s(Kingbase 0.57s);`DamengTableHandler.Writer` 每表 yield CREATE/COMMENT/INDEX 多次(10 表=131 条)。**批量化实测不可行**(`;` 多语句被拒,匿名块慢 7 倍)。 +- Dameng/PostgreSQL/SqlServer 项目里 `ResultTest/ExecutionTest.cs` 与 `SelectResult.cs` 都继承共享 `ExecutionTest`(100 用例) → 同一套件跑两遍。 + +## JSON 配置驱动注册数据库(2026-11-08 已落地,七方言全覆盖) +- 链路:`AddLightOrm(options, configuration)` → `option.UseXxx()` 空参重载 → `IDatabaseRegistry.RegisterDatabase` → `RegisterCreator(DbBaseType, Func)`;首次 resolve `IExpressionContext` 时 `DatabaseListReloader`(DI 单例)做初始加载并订阅 `IOptionsMonitor.OnChange`。 +- **新方言接入只需两处**(核心/DI 不动):① `XxxProvider.Create(DatabaseOptions)`;② `public void UseXxx() => options.RegisterDatabase(XxxProvider.Xxx, d => XxxProvider.Create(d));`。已接:Dameng / PostgreSQL / SqlServer / MySql / Sqlite / Oracle / KingbaseES。 +- 核心 helper(`LightORM/Options/DatabaseOptionsExtensions.cs`,public,第三方 provider 可用): + - `database.ToDbOption(connectionString)`:统一搬 `SlaveConnectionStrings` / `IsUseIdentifierQuote` / 版本字段,方言只管自己私有的(如 `TableSpace` 走 `Settings`)。 + - `definition.HasSplitConnectionFields()`:**字段清单只在这里维护**,加字段只改一处。 + - `DatabaseConnectionString.Build(key, definition, factory, applyFields)`:**泛型**(`where T : DbConnectionStringBuilder`),`hasSplitFields` 由内部算、不用传;无分散字段时原样返回连接串(不归一化);拼完为空抛可读异常。 +- **字段范围的口径(用户明确定过)**:只收"拼出可用连接串"必需的字段 —— `ConnectionString` / `Server` / `Port` / `UserId` / `Password` / `Database` / `DataSource` / `ServiceName` / `Sid`。**连接超时、命令超时、连接池、应用名这类调优项不进模型**,需要就写进 `ConnectionString`。 +- 各方言构建连接串的坑: + - **SqlServer**:`SqlConnectionStringBuilder` 没有 Port → 写成 `Data Source=host,port`;Server 含 `,`/`\` 时再给 Port 直接报错;`Database` → `InitialCatalog`。 + - **PG / KingbaseES**:键是 `Host`/`Username`/`Port`/`Database`(不是 Server/UserId)。 + - **MySql**:`Server`/`Port`(uint)/`UserID`/`Database`;构造期校验库名前,原来那条正则只认字母下划线(库名带数字会误判"未发现数据库"),已换成 `MySqlConnectionStringBuilder(cs).Database`。 + - **Sqlite**:只有 `DataSource`;`DataSource` 优先,其次把 `Database` 当库文件路径,都没有且无连接串时抛错并说明 Server/Port/凭据无意义。 + - **Oracle**:只有 `DataSource`,组装优先级 = 显式 `DataSource`(TNS 别名/描述符/EZ Connect)→ `ServiceName`(`host:port/service`,默认端口 1521)→ `Sid`(完整 `(DESCRIPTION=(ADDRESS=...)(CONNECT_DATA=(SID=...)))`)→ 裸 `Server`(当 TNS 别名,`Port` 有值才拼 `host:port`)。ServiceName 与 Sid 同时给、或给了 ServiceName/Sid 却没 Server → 抛可读异常。 +- `IsUseIdentifierQuote` 默认值不定死:PG 构造期 `?? false`,SqlServer/Dameng 等 `?? true` —— 配置不填就沿用方言默认。 +- `DetectVersion=false` 在配置里可表达(ToSql 场景不建连);SqlServer 不探测时 `Capabilities.IsResolved == true`(落 Baseline)。 +- `IExpressionContextSetup` **不再加成员**:新增可选接口 `IDatabaseRegistry`,调用方走扩展方法 `setup.RegisterDatabase(...)`(判 `is not IDatabaseRegistry` 抛可读异常),第三方实现不会被破坏。 +- `databaseCreators` / `customDatabases` / `databaseHandlers` 均 `OrdinalIgnoreCase`;配置里的 `Type` 与 `DbBaseType.Name` 大小写不敏感匹配,注册时用 `provider.DbBaseType`。 +- 覆盖/移除语义:配置项 `ApplyDatabase(replace:true)` 覆盖同 key 的 provider(adapter/handler 跟着换);配置里删掉的 key 走 `RemoveDatabase`;代码里 `SetDatabase` 注册、配置里没有的库不动。 +- `BindingExtensions.cs` 是**手写**的 AOT 绑定器(`EnableConfigurationBindingGenerator` 已删)→ 给 `DatabaseOptions` / `DatabaseDefinition` 加属性必须同步改它。内部用 `BindString/BindInt/BindBool` 三个小 helper,每个字段一行。 +- 测试:`test/LightORMTest/DatabaseConfigurationTest.cs`(5 用例,全过)。**`TestBase` 刻意不接配置**(否则会给所有 provider 用例叠加额外库、改变 `DatabaseProviders.First()` 的断言),原来的 `db.json` 已删除。构造真实连接串的验证一直是临时用例(各 provider 项目里写、跑完删),**没有常驻回归**。 +- 既有失败(与本线无关,别当回归):`SwitchDatabaseTest.TestConfig`(`UseSqlite("db1","")` 空串本来就抛)、`ConstantExpressionTest` 两个用例(不走 AddLightOrm,纯 `ExpressionResolver` 静态缓存串味)、`BenchmarkTest` 编译失败(固定旧 NuGet 包,`Ado` 不存在)。 + From 33d056d711fed850e414daf5d0abaf6dac29c5ea Mon Sep 17 00:00:00 2001 From: MarvelTiter_yaoqinglin Date: Sun, 8 Nov 2026 17:23:27 +0800 Subject: [PATCH 07/10] =?UTF-8?q?push:=20=E4=BF=AE=E6=94=B9=E7=89=88?= =?UTF-8?q?=E6=9C=AC=E5=8F=B7?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...tORM.Extensions.DependencyInjection.csproj | 1 - src/versions.props | 34 +++++++++---------- 2 files changed, 17 insertions(+), 18 deletions(-) diff --git a/src/LightORM.Extensions.DependencyInjection/LightORM.Extensions.DependencyInjection.csproj b/src/LightORM.Extensions.DependencyInjection/LightORM.Extensions.DependencyInjection.csproj index 6c996b88..35dbd876 100644 --- a/src/LightORM.Extensions.DependencyInjection/LightORM.Extensions.DependencyInjection.csproj +++ b/src/LightORM.Extensions.DependencyInjection/LightORM.Extensions.DependencyInjection.csproj @@ -9,7 +9,6 @@ - diff --git a/src/versions.props b/src/versions.props index 41367e1b..42c74ef4 100644 --- a/src/versions.props +++ b/src/versions.props @@ -1,46 +1,46 @@  - 2026.09.18.1 + 2026.11.08.1 - 2026.09.18.1 + 2026.11.08.1 - 2026.09.18.1 + 2026.11.08.1 - 2026.09.18.1 + 2026.11.08.1 - 2026.09.18.1 + 2026.11.08.1 - 2026.09.18.1 + 2026.11.08.1 - 2026.09.18.1 + 2026.11.08.1 - 2026.09.18.1 + 2026.11.08.1 - 2026.09.18.1 + 2026.11.08.1 - 2026.09.18.1 + 2026.11.08.1 - 2026.09.18.1 + 2026.11.08.1 - 2026.09.18.1 + 2026.11.08.1 - 2026.09.18.1 + 2026.11.08.1 - 2026.09.18.1 + 2026.11.08.1 - 2026.09.18.1 + 2026.11.08.1 - 2026.09.18.1 + 2026.11.08.1 - 2026.09.18.1 + 2026.11.08.1 \ No newline at end of file From 46086843451dbf2e5d82b722666567605ba32dcc Mon Sep 17 00:00:00 2001 From: MarvelTiter_yaoqinglin Date: Sun, 8 Nov 2026 17:31:39 +0800 Subject: [PATCH 08/10] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=E9=85=8D?= =?UTF-8?q?=E7=BD=AE=E9=A9=B1=E5=8A=A8=E6=B3=A8=E5=86=8C=E7=9A=84=E6=96=87?= =?UTF-8?q?=E6=A1=A3=E4=B8=8E=20API=20=E6=B3=A8=E9=87=8A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - README:新增「从配置文件注册数据库(可选)」小节,给出 db.json 与 `AddLightOrm(..., configuration)` 的最小示例、Key/Type/覆盖规则说明; 「简单配置」与「关键 API 入口」补指针,「核心库内部结构」补 `Options/` 目录。 - examples.md:新增「从配置文件注册数据库」章节,含完整字段表、 各方言拼串规则、优先级与热重载、以及两条易踩的坑 (Type 未登记会报错并列出可选值;键名拼错会被静默忽略)。 - 版本日志:补 v2026.11.08 条目。 - `AddLightOrm` 的 XML summary 内嵌 LightOrmDatabases 的 JSON 结构, 逐字段标注含义与默认值,IDE 悬浮即可查,不必翻文档。 --- README.md | 55 +++++++++ ...10\346\234\254\346\227\245\345\277\227.md" | 13 +++ examples.md | 109 ++++++++++++++++++ .../IoCExtensions.cs | 42 ++++++- 4 files changed, 218 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 429883c4..16b5ca8d 100644 --- a/README.md +++ b/README.md @@ -29,6 +29,8 @@ services.AddLightOrm(option => { IExpressionContext Db = ExpSqlFactory.GetContext(); ``` +> 连接串不想写死在代码里?把 `IConfiguration` 传给 `AddLightOrm` 的第二个参数即可,见「[从配置文件注册数据库](#从配置文件注册数据库可选)」。 + ### 📦 功能齐全 | 功能特性 | 支持情况 | 说明 | @@ -84,6 +86,7 @@ LightORM.slnx | `DbEntity/` | 实体模型 | | `Performances/` | 性能相关(`StringBuilderPool` 等) | | `Models/` | 上下文模型(`JsonColumnContext`、`UpsertContext` 等) | +| `Options/` | 配置模型(`DatabaseOptions` / `DatabaseDefinition`)与连接串拼装 | | `Utils/` | 工具类与访问器(`Vistors/` 表达式访问器) | ### 核心设计理念 @@ -169,6 +172,55 @@ var result = db.Select() .ToList(); ``` +### 从配置文件注册数据库(可选) + +数据库描述放配置文件,代码里只登记「该方言如何创建」: + +```csharp +// db.json 需随输出复制(PreserveNewest) +var configuration = new ConfigurationBuilder() + .AddJsonFile("db.json", optional: false, reloadOnChange: true) + .Build(); + +services.AddLightOrm(option => +{ + option.SetTableContext(new TestTableContext()); + option.UseSqlite(); // 只登记创建器,不注册实例 +}, configuration); +``` + +```json +{ + "LightOrmDatabases": [ + { + "Key": "MainDb", + "Option": { + "Type": "Sqlite", + "DataSource": "test.db" + } + }, + { + "Key": "Report", + "Option": { + "Type": "PostgreSQL", + "Server": "localhost", + "Port": 5432, + "UserId": "postgres", + "Password": "pwd", + "Database": "report" + } + } + ] +} +``` + +- `Key` 是注册名,不写视为 `MainDb`(`DefaultDbKey` 默认就取它)。 +- `Type` 必须与代码里某个空参 `UseXxx()` 登记的方言名一致,大小写不敏感。可选值: + `Sqlite` / `MySql` / `SqlServer` / `PostgreSQL` / `Oracle` / `Dameng` / `KingbaseES`。 +- `Option.ConnectionString` 可直接给整串;同时给分散字段时,字段**覆盖**连接串里的同名项。 +- `reloadOnChange: true` 下改连接串、加库、删库都会即时生效,删掉的条目会一并移除对应 provider。 +- 字段清单见 [完整示例 - 从配置文件注册数据库](./examples.md#从配置文件注册数据库)。 + ### 仓储模式 ```csharp @@ -452,6 +504,9 @@ IExpressionContext Db = ExpSqlFactory.GetContext(); // DI 场景 services.AddLightOrm(option => option.UseMySql(connStr)); + +// DI + 配置文件(连接串放配置里,代码只登记方言创建器) +services.AddLightOrm(option => option.UseMySql(), configuration); ``` **核心接口层级:** diff --git "a/doc/\347\211\210\346\234\254\346\227\245\345\277\227.md" "b/doc/\347\211\210\346\234\254\346\227\245\345\277\227.md" index 4a1994ca..28e3e4fd 100644 --- "a/doc/\347\211\210\346\234\254\346\227\245\345\277\227.md" +++ "b/doc/\347\211\210\346\234\254\346\227\245\345\277\227.md" @@ -1,5 +1,18 @@ # 版本功能更新记录 +## v2026.11.08 +- 🛠 **新增配置驱动的数据库注册**:`AddLightOrm(services, options, IConfiguration)` 多了可选的 `IConfiguration` 参数,数据库改由配置节 `LightOrmDatabases` 描述(`Key` + `Option { Type, ConnectionString/Server/Port/UserId/... }`)。代码侧只需调用无参 `UseXxx()` 登记「该方言如何创建」,不再传连接串;用法见 `README.md`「从配置文件注册数据库」与 `examples.md` 对应章节 +- 🛠 七个方言全部接入:`Dameng` / `PostgreSQL` / `KingbaseES` / `SqlServer` / `MySql` / `Sqlite` / `Oracle` 各新增 `Create(DatabaseOptions)` 与无参 `UseXxx()` 重载。字段映射只覆盖「拼出可用连接串必需」的项(`DataSource` / `Server` / `Port` / `UserId` / `Password` / `Database` / `ServiceName` / `Sid` 等),连接超时、命令超时、连接池这类调优项不收,请写在 `ConnectionString` 里 +- 🛠 新增 `DatabaseConnectionString.Build`:以已有 `ConnectionString` 为底、分散字段覆盖其中的同名项;没有分散字段时原样返回,不重新归一化(避免改写用户手写的串);拼完为空则抛可读异常指明缺哪些字段 +- 🛠 热重载:配置文件 `reloadOnChange: true` 后,改连接串 / 新增库 / 删除库都即时生效。`DatabaseListReloader` 在构造期先同步一次当前值(修复此前「初始配置永不生效」),订阅回调包在 try/catch + 日志内,避免文件监听线程被异常打断;删除的条目按 key 差集移除对应 provider +- 🛠 注册表(`customDatabases` / `databaseHandlers` / `databaseCreators`)统一改为**大小写不敏感**;新增 `RegisterCreator` / `TryGetCreator` / `ApplyDatabase(replace)` / `RemoveDatabase`。原来的 `TryAdd` 会让"同名 key 覆盖"静默失效,现支持覆盖与移除 +- 🛠 新增可选能力接口 `IDatabaseRegistry`,`RegisterDatabase` 以扩展方法挂在 `IExpressionContextSetup` 上(不改接口成员,第三方实现不会编译失败);未实现该接口的 setup 会抛出指明类型名的异常。`ExpressionSqlOptions` 拆为平台无关(`Shared`)与实例两部分 +- 🛠 DI 扩展改为 **AOT 友好的手写配置绑定**(`BindingExtensions`),不用 `services.Configure(IConfiguration)` 的反射绑定;相应移除了 `Microsoft.Extensions.Configuration.Binder` 依赖 +- 🐞 修复 MySQL 构造期用正则 `(?<=Database=)([A-Z|a-z|_]+)` 提取库名的写法:库名含数字或非 ASCII 字符时会被误判为"需要切库",改用 `MySqlConnectionStringBuilder(cs).Database` +- 📌 Oracle `DataSource` 组装规则:`DataSource` 原样透传(TNS 别名 / 完整描述符 / EZ Connect)→ `ServiceName` 拼 `host:port/service` → `Sid` 拼完整描述符 → 裸 `Server` 当 TNS 别名。**`Sid` 不会写成 `host:port/SID`**:该位置在 Oracle 语法里是 service_name,只有单实例且 service 与 SID 同名时才"看起来能用",RAC 下(SID=`ORCL1`、service=`ORCL`)必失败;只给 `Server` + `Port` 而不给 `ServiceName`/`Sid` 会直接报错(拼出的 `host:port` 既不能精确匹配 TNS 别名,也不是合法 EZ Connect) +- ✅ 新增 `DatabaseConfigurationTest`(5 用例):初始加载、同名键覆盖连接串、删除条目、未知 `Type` 的可读报错、`Type` 大小写不敏感;用临时目录 + `reloadOnChange: true` 真实走一遍文件监听 +- 🛠 `DatabaseUtils.Avalonia` 示例改为从 `db.json` 注册(`CopyToOutputDirectory=PreserveNewest`,`AddJsonFile(optional: false)` —— 缺文件时启动即失败,好过运行期抛 `KeyNotFoundException`),依赖由 `Microsoft.Extensions.Hosting` 换成 `Microsoft.Extensions.Configuration.Json` + ## v2026.09.11 - 🛠 批量更新支持 json 列:`UpdateBuilder.CreateUpdateBatchSql` 不再排除 json 列(原为 `// TODO 批量更新对JSON列处理`)。批量场景下 json 列不存在路径表达式,值与普通列一致按 `col = CASE WHEN 主键 = @p THEN @val ... END` 整列赋值;此前 json 列被排除后,若实体只有主键 + json 列,还会生成 `SET` 子句为空的畸形 SQL - 🛠 批量参数收集(`BatchSqlInfoExtensions.ToDictionaryParameters`)对 json 列先序列化为 JSON 文本,再以携带列元数据的 `DbParameterValue` 下发,由方言 `IDatabaseParameterBinder` 类型化(PG → `jsonb`),与单条 Insert/Update 的取值/序列化/绑定链路保持一致 diff --git a/examples.md b/examples.md index 57cfc66b..a586d154 100644 --- a/examples.md +++ b/examples.md @@ -75,6 +75,115 @@ ExpSqlFactory.Configuration(option => IExpressionContext Db = ExpSqlFactory.GetContext(); ``` +# 从配置文件注册数据库 + +依赖 `LightORM.Extensions.DependencyInjection`。把 `IConfiguration` 传给 `AddLightOrm` 的第二个参数, +数据库改由配置节 `LightOrmDatabases` 描述;代码里只调用无参 `UseXxx()` 登记「该方言如何创建」, +不再传连接串。 + +```csharp +var configuration = new ConfigurationBuilder() + .AddJsonFile("db.json", optional: false, reloadOnChange: true) + .Build(); + +services.AddLightOrm(option => +{ + option.SetTableContext(new TestTableContext()); + // 只登记创建器:配置里出现 Type = "Sqlite" / "Dameng" 才会真正建 provider + option.UseSqlite(); + option.UseDameng(); +}, configuration); +``` + +```json +{ + "LightOrmDatabases": [ + { + "Key": "MainDb", + "Option": { + "Type": "Sqlite", + "DataSource": "test.db" + } + }, + { + "Key": "Report", + "Option": { + "Type": "Dameng", + "Server": "localhost", + "Port": 5236, + "UserId": "SYSDBA", + "Password": "SYSDBA001" + } + } + ] +} +``` + +## 配置结构 + +`LightOrmDatabases` 是数组,每个元素对应一个注册的库: + +| 字段 | 类型 | 说明 | +|------|------|------| +| `Key` | string | 注册名(多库时用它切换)。省略则视为 `MainDb`,`DefaultDbKey` 默认也取 `MainDb` | +| `Option` | object | 库定义,缺了这条会被跳过并记一条警告日志 | +| `Option.Type` | string | **必填**,方言名。取值须与调用过的空参 `UseXxx()` 一致,大小写不敏感 | +| `Option.ConnectionString` | string | 完整连接串。同时给了分散字段时,它作为基底被覆盖 | +| `Option.DataSource` | string | Sqlite 的文件路径;Oracle 的 TNS 别名 / 完整描述符 / EZ Connect;其余方言视作主机或数据源 | +| `Option.Server` | string | 主机名。Oracle 在没有 `ServiceName` / `Sid` 时按 TNS 别名原样使用 | +| `Option.Port` | int | 端口,省略用方言默认(Oracle 1521、达梦 5236 等) | +| `Option.UserId` / `Option.Password` | string | 凭据 | +| `Option.Database` | string | 库名;Sqlite 在无 `DataSource` 时把它当文件路径 | +| `Option.ServiceName` | string | Oracle 专用,拼成 `host:port/service` | +| `Option.Sid` | string | Oracle 专用,拼成 `(DESCRIPTION=...(CONNECT_DATA=(SID=...)))`;与 `ServiceName` 二选一 | +| `Option.SlaveConnectionStrings` | string[] | 从库连接串(读写分离用) | +| `Option.IsUseIdentifierQuote` | bool | 是否引用标识符 | +| `Option.SpecificVersion` | string | 指定服务端版本;给了就不再连库探测 | +| `Option.DetectVersion` | bool | `false` 时不探测版本,直接用方言基线能力 | +| `Option.DefaultStringLength` | int | 默认字符串长度 | +| `Option.Settings` | object | 方言私有开关,只支持一层字符串键值,如 PG 的 `"TableSpace": "pg_default"` | + +> 只收录「拼出可用连接串必需」的字段。连接超时、命令超时、连接池大小这类调优项请写在 +> `ConnectionString` 里,或走代码方式配置。 + +`Option.Type` 的规范写法(大小写不敏感,但建议照抄): +`Sqlite` / `MySql` / `SqlServer` / `PostgreSQL` / `Oracle` / `Dameng` / `KingbaseES`, +分别对应代码里的 `UseSqlite()` / `UseMySql()` / `UseSqlServer()` / `UsePostgreSQL()` / +`UseOracle()` / `UseDameng()` / `UseKingbaseES()`。 + +## 各方言拼串规则 + +| 方言 | 规则 | +|------|------| +| `Sqlite` | `DataSource` → 否则 `Database` 当文件路径;两者都没有且无 `ConnectionString` 则抛错 | +| `MySql` | `Server` / `Port` / `UserId` / `Password` / `Database` | +| `SqlServer` | `Server` 作 `Data Source`;端口折进 `Data Source=host,port`。`Server` 已含 `,` 或 `\`(命名实例)时再给 `Port` 会直接报错 | +| `PostgreSQL` / `KingbaseES` | `DataSource`(回退 `Server`)作 `Host`、`UserId` 作 `Username`、`Port` / `Password` / `Database` | +| `Dameng` | `DataSource` 优先,否则 `Server` + `Port`(默认 5236)+ 凭据 | +| `Oracle` | `DataSource` 原样透传 → `ServiceName` 拼 EZ Connect → `Sid` 拼完整描述符 → 裸 `Server` 当 TNS 别名 | + +Oracle 补充:`Sid` 不会写成 `host:port/SID`。该位置在 Oracle 语法里是 **service_name**, +只有单实例且 service 恰好与 SID 同名时才「看起来能用」,RAC 下(SID=`ORCL1`、service=`ORCL`)必失败。 +另外只给 `Server` + `Port` 而不给 `ServiceName` / `Sid` 会报错 —— 拼出的 `host:port` 既不能精确匹配 +TNS 别名,也不是合法的 EZ Connect。 + +## 优先级与热重载 + +1. 代码里 `UseXxx(connStr)` 先登记实例; +2. 配置文件里**同 `Key`** 的条目随后覆盖它(连接串、选项都按配置走); +3. 配置里有、代码里没登记的 `Key` 会被新增; +4. 配置里删掉的 `Key` 会在重载时移除对应 provider。 + +`reloadOnChange: true` 时,改连接串、加库、删库都会在文件保存后生效,无需重启。 +`AddLightOrm` 不传 `configuration` 时整条链路跳过,行为与旧版本一致。 + +## 注意 + +- `Option.Type` 写了一个没登记过的方言名,会在加载时抛异常并列出当前已支持的方言名。 +- 配置键名目前**不做严格校验**:拼错的键(如 `"UsrId"`)会被静默忽略, + 症状是「明明写了却连不上」。遇到这种情况先核对键名拼写。 +- 手写绑定器 `BindingExtensions` 是唯一入口,新增配置字段必须同步改它,否则字段会被忽略。 + # 使用生成器(可选) ## 用途 diff --git a/src/LightORM.Extensions.DependencyInjection/IoCExtensions.cs b/src/LightORM.Extensions.DependencyInjection/IoCExtensions.cs index f0e8ff89..edd2e6bc 100644 --- a/src/LightORM.Extensions.DependencyInjection/IoCExtensions.cs +++ b/src/LightORM.Extensions.DependencyInjection/IoCExtensions.cs @@ -17,13 +17,53 @@ public static class IoCExtensions /// /// 注册 LightORM。 + /// + /// 传入 后,数据库可由配置节 LightOrmDatabases 描述, + /// 结构如下(数组,每个元素 = 一个注册的库): + /// + /// + /// { + /// "LightOrmDatabases": [ + /// { + /// "Key": "MainDb", // 注册名,不写则视为 "MainDb" + /// "Option": { + /// "Type": "PostgreSQL", // 必填,须与某个空参 UseXxx() 登记的方言名一致(大小写不敏感) + /// "ConnectionString": string, // 可直接给整串;下面的分散字段会覆盖其中的同名项 + /// "DataSource": string, // 别名/描述符:Oracle 的 TNS 或 EZ Connect、Sqlite 的文件路径 + /// "Server": string, + /// "Port": int, // 不写则用方言默认端口(如 Oracle 1521 / Dameng 5236) + /// "UserId": string, + /// "Password": string, + /// "Database": string, + /// "ServiceName": string, // Oracle 专用,与 Sid 二选一 + /// "Sid": string, // Oracle 专用 + /// "SlaveConnectionStrings": string[], // 从库 + /// "IsUseIdentifierQuote": bool, // 标识符引用 + /// "SpecificVersion": string, // 指定服务端版本,给了就不再探测 + /// "DetectVersion": bool, // false 时不探测版本 + /// "DefaultStringLength": int, + /// "Settings": { } // 方言私有开关,如 PG 的 TableSpace + /// } + /// } + /// ] + /// } + /// + /// + /// Option.Type 的可选值取决于代码里调用过哪些空参重载 + /// (UseSqlite() / UseMySql() / UseSqlServer() / UsePostgreSQL() / + /// UseOracle() / UseDameng() / UseKingbaseES());未登记的类型会抛异常并列出已支持的方言名。 + /// /// /// 服务集合。 - /// 代码方式的配置(优先级低于配置文件:配置文件里的同 key 条目会覆盖它)。 + /// + /// 代码方式的配置。与配置文件可共存:代码里 UseXxx(connStr) 先登记实例, + /// 配置文件中同 Key 的条目随后覆盖它。 + /// /// /// 提供 LightOrmDatabases 节的配置。传入后会: /// ① 在首次解析 时按配置注册数据库; /// ② 订阅文件变更,配置变化后覆盖/新增/移除对应的库(连接串改动会生效)。 + /// 为 null 时整条链路跳过,行为与不使用配置的版本完全一致。 /// public static IServiceCollection AddLightOrm(this IServiceCollection services, Action options, IConfiguration? configuration = null) { From 34249ec7a090d4088f47b34a2c034e273763fb85 Mon Sep 17 00:00:00 2001 From: MarvelTiter_yaoqinglin Date: Sun, 8 Nov 2026 17:31:44 +0800 Subject: [PATCH 09/10] =?UTF-8?q?fix:=20=E6=B6=88=E9=99=A4=E6=89=8B?= =?UTF-8?q?=E5=86=99=E7=BB=91=E5=AE=9A=E5=99=A8=E7=9A=84=20CS8604=20?= =?UTF-8?q?=E5=8F=AF=E7=A9=BA=E5=BC=95=E7=94=A8=E8=AD=A6=E5=91=8A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit net462 / netstandard2.0 的 BCL 不带 `[NotNullWhen]` 注解, `string.IsNullOrEmpty` 之后编译器仍认为值可能为 null, `ParseInt` / `ParseBool` 的调用补 `!` 断言。仅消除警告,行为不变。 --- .../BindingExtensions.cs | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/src/LightORM.Extensions.DependencyInjection/BindingExtensions.cs b/src/LightORM.Extensions.DependencyInjection/BindingExtensions.cs index 86054a0d..045c93f3 100644 --- a/src/LightORM.Extensions.DependencyInjection/BindingExtensions.cs +++ b/src/LightORM.Extensions.DependencyInjection/BindingExtensions.cs @@ -179,7 +179,8 @@ private static void BindInt(IConfiguration configuration, string key, Action set) @@ -189,7 +190,7 @@ private static void BindBool(IConfiguration configuration, string key, Action> keys, IConfiguration configuration, BinderOptions? binderOptions) From b3102c356447d92d5f6fb48aa7106c904187a7fd Mon Sep 17 00:00:00 2001 From: MarvelTiter_yaoqinglin Date: Sun, 8 Nov 2026 17:31:54 +0800 Subject: [PATCH 10/10] =?UTF-8?q?docs:=20=E8=A1=A5=E8=AE=B0=E6=96=87?= =?UTF-8?q?=E6=A1=A3=E8=A1=A5=E9=BD=90=E4=B8=8E=E9=85=8D=E7=BD=AE=E7=BB=91?= =?UTF-8?q?=E5=AE=9A=E7=9A=84=E4=B8=A4=E4=B8=AA=E6=98=93=E8=B8=A9=E5=9D=91?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .workbuddy/memory/2026-11-08.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/.workbuddy/memory/2026-11-08.md b/.workbuddy/memory/2026-11-08.md index 43b22c1b..4ba1fb38 100644 --- a/.workbuddy/memory/2026-11-08.md +++ b/.workbuddy/memory/2026-11-08.md @@ -65,3 +65,12 @@ - 顺手修掉一个隐患:原来 `Server` 有值但无 ServiceName/Sid 时会拼 `RACE:1521` —— 既不能精确匹配 TNS 别名,也不是合法 EZ Connect(缺 service_name)。改为**抛 LightOrmException**,提示"只连 TNS 别名请去掉 Port"。`Server` 单独给仍原样当别名返回。 - 本机 Oracle(localhost:1521)当前未启动,无法实测;结论来自 Oracle 官方文档 + 语法推导。 - 环境注意:本次沙箱下 `dotnet build` 会因 `C:/Users/Marvel/AppData/Roaming/NuGet` 无权限而 restore 失败,**加 `--no-restore` 可正常编译**。 + +## 追加:文档补齐 + 提交 +- 分支 `json-config` 相对 `origin/master` 的改动已分 8 批落本地:内核 → DI → 7 provider → 测试 → Avalonia 示例 → 记忆 → 文档 → 警告修复。 +- 文档三处:`README.md`「从配置文件注册数据库(可选)」+ 简单配置/关键 API 入口的指针 + `Options/` 目录行;`examples.md` 新增完整章节(字段表、各方言拼串规则、优先级与热重载、两个坑);`doc/版本日志.md` 补 v2026.11.08。 +- `AddLightOrm` 的 XML summary 内嵌 `LightOrmDatabases` 的 JSON 结构(`` 块逐字段注释),IDE 悬浮可查。 +- **两个必须记住的坑**:① 配置键名**不做严格校验**(`ValidateConfigurationKeys` 里 `BinderOptions` 恒为 null,`ErrorOnUnknownConfiguration` 永远关着)→ 拼错的键静默忽略;② `DatabaseDefinition` 加字段必须同步 `BindingExtensions.s_configKeys_DatabaseDefinition` 与 `BindCore`,否则字段被静默丢弃。 +- 方言名规范值:`Sqlite` / `MySql` / `SqlServer` / `PostgreSQL` / `Oracle` / `Dameng` / `KingbaseES`(对应 `DbBaseType.Name`,注册表大小写不敏感)。 +- 顺手清掉 `BindingExtensions` 的 4 条 CS8604(net462/netstandard2.0 无 `[NotNullWhen]`,补 `!`)。DI 项目现 0 警告 0 错误,`DatabaseConfigurationTest` 5/5 通过。 +- 沙箱跑测试也要 `--no-restore`,否则 restore 阶段因 `C:/Users/Marvel/AppData/Roaming/NuGet` 无权限直接失败。