Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
557 changes: 557 additions & 0 deletions .workbuddy/memory/2026-09-17.md

Large diffs are not rendered by default.

235 changes: 235 additions & 0 deletions .workbuddy/memory/2026-09-18.md

Large diffs are not rendered by default.

256 changes: 128 additions & 128 deletions .workbuddy/memory/MEMORY.md

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion DatabaseUtils.Avalonia/ViewModels/MainViewModel.cs
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ public MainViewModel(IExpressionContext context)
supportedDb.Add(DbBaseType.Oracle.Name, str => OracleProvider.Create(o => o.MasterConnectionString = str));
supportedDb.Add(DbBaseType.PostgreSQL.Name, str => PostgreSQLProvider.Create(o => o.MasterConnectionString = str));
supportedDb.Add(DbBaseType.MySql.Name, str => MySqlProvider.Create(o => o.MasterConnectionString = str));
supportedDb.Add(DbBaseType.SqlServer.Name, str => SqlServerProvider.Create(SqlServerVersion.V1, o => o.MasterConnectionString = str));
supportedDb.Add(DbBaseType.SqlServer.Name, str => SqlServerProvider.Create(o => o.MasterConnectionString = str));
SupportedDbNames = [.. supportedDb.Keys];

// 从配置恢复上次的状态(经属性赋值,保持与界面绑定一致)
Expand Down
2 changes: 1 addition & 1 deletion DatabaseUtils/WpfApp.razor.cs
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ protected override void OnInitialized()
supportedDb.Add(DbBaseType.Oracle.Name, str => LightORM.Providers.Oracle.OracleProvider.Create(o => o.MasterConnectionString = str));
supportedDb.Add(DbBaseType.PostgreSQL.Name, str => LightORM.Providers.PostgreSQL.PostgreSQLProvider.Create(o => o.MasterConnectionString = str));
supportedDb.Add(DbBaseType.MySql.Name, str => LightORM.Providers.MySql.MySqlProvider.Create(o => o.MasterConnectionString = str));
supportedDb.Add(DbBaseType.SqlServer.Name, str => LightORM.Providers.SqlServer.SqlServerProvider.Create(SqlServerVersion.V1, o => o.MasterConnectionString = str));
supportedDb.Add(DbBaseType.SqlServer.Name, str => LightORM.Providers.SqlServer.SqlServerProvider.Create(o => o.MasterConnectionString = str));
}

async Task Connect()
Expand Down
1 change: 0 additions & 1 deletion LightORM.slnx
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,6 @@
<Project Path="test/LightORMTest.SqlServer/LightORMTest.SqlServer.csproj" />
<Project Path="test/LightORMTest/LightORMTest.csproj" />
<Project Path="test/PerformanceTest/PerformanceTest.csproj" />
<Project Path="test/TestProject1/TestProject1.csproj" />
<Project Path="test/TestWeb/TestWeb.csproj" />
</Folder>
<Folder Name="/test/AotTest/">
Expand Down
10 changes: 8 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -343,10 +343,16 @@ public virtual void Exits(IExpressionResolver resolver, MethodCallExpression met

- `ToString()` → `CONVERT(VARCHAR(MAX), ...)`,且**把 .NET 日期格式字符串映射成 SQL Server 的 style code**(`"yyyy-MM-dd"` → 23,`"yyyyMMdd"` → 112 等),这是非常贴合实际业务痛点的细节。
- `Contains` 区分 `string.Contains`(→ `LIKE '%'+x+'%'`)和集合 `Contains`(→ `IN (...)`)。
- `Join` 聚合根据 `SqlServerVersion` 决定用 `STRING_AGG`(2017+)还是抛异常。
- `Join` 聚合 → `STRING_AGG`(2017+ 才有;低版本不预判,直接交给数据库报错——只有一种写法,判版本只是多一条无意义的失败分支)。
- `JsonQuery` → `JSON_VALUE`,`JsonSet` → `JSON_MODIFY`。

**版本感知**:`SqlServerMethodResolver` 构造函数接收 `SqlServerVersion` 枚举,同一 SQL 片段在不同 SQL Server 版本下生成不同函数——这是 `TRIM`(2017+ 原生 vs 兼容写法)等函数能正确工作的原因。
**版本感知**:`SqlServerMethodResolver` / `CustomSqlServerAdapter` 接收 `SqlServerCapabilities`——由构造期后台探测的服务端版本(或显式 `SpecificVersion`)翻译成能力位,同一 SQL 片段在不同 SQL Server 版本下生成不同函数。当前只登记**"存在两套写法"**的能力:`OffsetFetch`(2012+ 的 `OFFSET/FETCH` vs `ROW_NUMBER` 包裹)与 `TrimFunction`(2017+ 原生 `TRIM` vs `LTRIM(RTRIM())`);只有一种写法的能力(如 `JSON_VALUE`、`STRING_AGG`)不判版本,交给数据库报错即可。
探测是可选特性:`SpecificVersion` 已指定或 `DetectVersion = false`(典型的 ToSql 纯生成场景)时不建连,**探测失败或未探测也一律按完整功能生成**(SqlServer 的能力位都是"新写法在老版本报错、旧写法在新版本仍可跑",故乐观基线更合理)。

**能力档案的公共骨架**:`DbCapabilities<TDatabase, TDatabaseFeatures>`(`src/LightORM/Implements/DbCapabilities.cs`)承载探测的全部机制——单飞、后台重试自愈、连接串超时改写、`Baseline`/`ForVersion`/`Start`;方言只实现 `ProbeTarget` 与 `MapFeatures(Version?) → TFeatures`,`PrepareProbeConnectString` / `OpenBeforeRead` 有默认值可按需覆盖。
> net462 / netstandard2.0 不支持接口静态抽象成员,故方言元数据用**实例成员**表达:静态工厂先 `new TDatabase()` 借一个空实例读出探测键与连接串改写委托(CRTP + `new()` 约束),空实例只是元数据载体。

**接入探测的只有四个方言**:`SqlServerCapabilities` / `MySqlCapabilities` / `OracleCapabilities` / `SqliteCapabilities`——它们各自有"两套写法"的能力位,探测结果有地方用。PostgreSQL / KingbaseES / Dameng **不接入**:实测它们的 SQL 生成本就没有按版本二选一的分支,探测结果无处可用,只会白搭一次连库开销(`SpecificVersion` / `DetectVersion` 在这三个方言上也没有语义)。

### SelectBuilder:SQL 的结构组装器

Expand Down
8 changes: 6 additions & 2 deletions doc/项目大纲.md
Original file line number Diff line number Diff line change
Expand Up @@ -544,10 +544,14 @@ AOT 下的行为差异:
| `ToString` 日期 | `CONVERT(VARCHAR(MAX),col,style)` —— **把 .NET 格式串映射成 style code**(`"yyyy-MM-dd"`→23,`"yyyyMMdd"`→112) | `STRFTIME('%Y-%m-%d %H:%M:%S',col)` | | | | |
| JSON | `JSON_VALUE` / `JSON_MODIFY` | `JSON_EXTRACT` / `JSON_SET`(Binary 用 JSONB\_*) | | | | |
| Upsert | `MERGE INTO ... WHEN MATCHED` | `INSERT ... ON CONFLICT(pk) DO UPDATE SET EXCLUDED` | | | | |
| 分组聚合 | `STRING_AGG`(按 `SqlServerVersion` 决定,2017+ 才支持,否则抛异常) | `GROUP_CONCAT` | | | | |
| 分组聚合 | `STRING_AGG`(2017+ 才有;不按版本预判,低版本交给数据库报错) | `GROUP_CONCAT` | | | | |
| 批量插入 | `SqlBulkCopy` | 不支持(多行 VALUES) | | | | |

**版本感知**:`SqlServerMethodResolver` 构造接收 `SqlServerVersion` 枚举,同一 SQL 片段在不同版本生成不同函数(如 `TRIM` 在 2017+ 用原生)。
**版本感知**:`SqlServerMethodResolver` / `CustomSqlServerAdapter` 接收 `SqlServerCapabilities`——构造期后台探测的服务端版本(或 `SpecificVersion` 显式指定)翻译成能力位,同一 SQL 片段在不同版本生成不同函数(如 `TRIM` 在 2017+ 用原生、分页在 2012+ 用 `OFFSET/FETCH`)。
**只登记"存在两套写法"的能力**(SqlServer:`OffsetFetch` / `TrimFunction`;MySQL:`GroupByRollup`;Oracle:`IdentityColumn` / `JsonNativeType`;SQLite:`Jsonb`),只有一种写法的能力不判版本——硬判只会多一条走不到的失败分支,交给数据库报错即可。探测可用 `SpecificVersion` 或 `DetectVersion = false` 关闭;**未探测 / 探测失败按该方言的基线策略生成**(SqlServer / SQLite 乐观取完整功能,MySQL / Oracle 保守退旧写法)。

**能力档案骨架**:`DbCapabilities<TDatabase, TDatabaseFeatures>` 承载全部探测机制(单飞、后台重试自愈、连接串超时改写、`Baseline`/`ForVersion`/`Start`),方言只给 `ProbeTarget` + `MapFeatures(Version?) → TFeatures`(`PrepareProbeConnectString` / `OpenBeforeRead` 有默认值)。net462 不支持接口静态抽象成员,故用 CRTP + `new TDatabase()` 空实例传递方言元数据。
**只有存在"两套写法"的方言才接入探测**(SqlServer / MySQL / Oracle / SQLite)——探测的唯一目的是喂能力位;PostgreSQL / KingbaseES / Dameng 实测没有版本相关分支,不接入,避免白搭一次连库开销。

### 6.3 新增一个数据库 = 实现 5 个类

Expand Down
14 changes: 14 additions & 0 deletions src/LightORM/DbStruct/TableGenerateOption.cs
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,20 @@ public TableOptions()
{

}
/// <summary>
/// 显式指定数据库版本。一旦指定,则<b>不发起版本探测</b>;同时它优先于探测结果。
/// </summary>
public Version? SpecificVersion { get; set; }

/// <summary>
/// 是否允许在构造期后台探测数据库版本,默认开启。
/// <para>
/// 支持版本差异的方言会把探测结果翻译成自己的能力位;关掉探测(如 ToSql 纯 SQL 生成场景,
/// 不需要也不应该建连)时按<b>完整功能</b>处理。探测失败同样落到完整功能。
/// </para>
/// </summary>
public bool DetectVersion { get; set; } = true;

public bool NotCreateIfExists { get; set; }
public bool UseUnicodeString { get; set; } = true;
public bool SupportComment { get; set; } = true;
Expand Down
25 changes: 25 additions & 0 deletions src/LightORM/ExceptionPolyfills.cs
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,31 @@ internal static void ThrowObjectDisposedException(object? instance)

namespace System.Runtime.CompilerServices
{
[AttributeUsage(AttributeTargets.All, AllowMultiple = true, Inherited = false)]
internal sealed class CompilerFeatureRequiredAttribute : Attribute
{
public CompilerFeatureRequiredAttribute(string featureName)
{
FeatureName = featureName;
}

public string FeatureName { get; }
public bool IsOptional { get; init; }

public const string RefStructs = nameof(RefStructs);
public const string RequiredMembers = nameof(RequiredMembers);
}

[AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Field | AttributeTargets.Property, AllowMultiple = false, Inherited = false)]
internal sealed class RequiredMemberAttribute : Attribute
{
}

[AttributeUsage(AttributeTargets.Constructor, AllowMultiple = false, Inherited = false)]
internal sealed class SetsRequiredMembersAttribute : Attribute
{
}

internal sealed class NotNullAttribute : Attribute
{
}
Expand Down
127 changes: 127 additions & 0 deletions src/LightORM/Implements/DbCapabilities.cs
Original file line number Diff line number Diff line change
@@ -0,0 +1,127 @@
using System.Data.Common;

namespace LightORM.Implements;

/// <summary>
/// 数据库能力档案的公共骨架:<b>探测机制全部在这里,方言只提供差异</b>。
/// <para>
/// 方言需要实现两样:<see cref="ProbeTarget"/> 与 <see cref="MapFeatures"/>;
/// <see cref="PrepareProbeConnectString"/> / <see cref="OpenBeforeRead"/> 有默认值可按需覆盖;
/// <see cref="Baseline"/> / <see cref="ForVersion"/> / <see cref="Start"/> 以及所有读取成员都由基类提供。
/// </para>
/// <para>
/// <b>只有"同一 SQL 片段存在两套写法、需要按版本二选一"的方言才需要有这个类</b>——探测的唯一目的就是喂
/// <see cref="Features"/>。没有任何版本相关分支的方言不要接入:探测结果无处可用
/// </para>
/// net462 / netstandard2.0 的运行时<b>不支持接口中的静态抽象成员</b>(static abstract 需要 .NET 7+ 运行时,net462 上不可用)
/// </summary>
public abstract class DbCapabilities<TDatabase, TDatabaseFeatures>
where TDatabase : DbCapabilities<TDatabase, TDatabaseFeatures>, new()
{
/// <summary>
/// 探测状态。只由基类的静态工厂写入;读取请走 <see cref="ServerVersion"/> 等公开成员。
/// </summary>
protected DbVersionProbe Probe { get; set; } = DbVersionProbe.None;

/// <summary>
/// 探测的单飞键,用 <see cref="DbBaseType.Name"/>(同一键 + 同一连接串全进程只探测一次)。
/// </summary>
protected abstract string ProbeTarget { get; }

/// <summary>
/// 把探测用的连接串改写成"带秒级连接超时"的版本;返回 null 表示不改写。
/// <para>
/// <b>核心只给策略(探测必须秒级返回),怎么表达超时是方言的私有知识</b>:SqlServer 用
/// <c>SqlConnectionStringBuilder.ConnectTimeout</c>、Oracle 用 <c>ConnectionTimeout</c>、MySQL 用 <c>ConnectionTimeout</c>(uint)……
/// 按"超时键名"字符串试探区分不了语义(多个驱动同时接受 <c>Command Timeout</c> 且读回值相等),故交给方言。
/// </para>
/// 默认不改写;返回 null 或抛异常时,核心沿用原连接串让探测自己去失败。
/// </summary>
protected virtual string? PrepareProbeConnectString(string connectionString, int timeoutSeconds) => null;

/// <summary>
/// 读取 <see cref="DbConnection.ServerVersion"/> 前是否必须先 Open。
/// 除 SQLite 外所有驱动在关闭连接上读该属性都会抛异常,故默认 true;
/// SQLite 覆盖为 false——它未 Open 即可读,且对其 Open 会在文件不存在时建出一个空库文件。
/// </summary>
protected virtual bool OpenBeforeRead => true;

/// <summary>
/// 版本 → 能力位。<b>版本不可用(未探测 / 探测失败 / 未启用探测)时的基线策略由方言自己定</b>:
/// 可以保守(退到全版本可用的旧写法),也可以乐观(按完整功能生成),取决于该方言的能力位是否
/// "新写法在旧库直接失败"。直接比版本分量,不要构造 <c>Version</c> 实例做比较。
/// </summary>
public abstract TDatabaseFeatures MapFeatures(Version? version);

/// <summary>服务端版本,含原始串与来源(Explicit / Probed / Assumed)。</summary>
public DbServerVersion ServerVersion => Probe.Value;

public Version? Version => ServerVersion.Parsed;

public CapabilitySource Source => ServerVersion.Source;

/// <summary>探测是否已就绪(诊断用,不做等待)。</summary>
public bool IsResolved => Probe.IsResolved;

/// <summary>能力位。由版本推导,故必须与 SQL 生成期的读取保持一致。</summary>
public TDatabaseFeatures Features => MapFeatures(Version);

/// <summary>显式指定版本,优先级高于探测结果。</summary>
public void Override(Version? version) => Probe.Override(version);

/// <summary>不探测(未启用探测 / 纯 SQL 生成 / 静态实例),版本视为未知。</summary>
public static TDatabase Baseline { get; } = ForProbe(new TDatabase(), DbVersionProbe.None);

/// <summary>使用显式指定的版本,<b>不发起后台探测</b>。</summary>
public static TDatabase ForVersion(Version version) => ForProbe(new TDatabase(), version);

/// <summary>
/// 构造期发起后台探测。三条不探测的出口,结果都落到 <see cref="Baseline"/>:
/// <list type="bullet">
/// <item><paramref name="specificVersion"/> 已给定——用户既然指定了版本,就没有连库的必要;</item>
/// <item><paramref name="detectVersion"/> 为 false——用户主动关闭探测(典型的 ToSql 纯生成场景);</item>
/// <item><paramref name="connectionString"/> 为空——没有可探测的目标。</item>
/// </list>
/// 探测本身失败(连不上 / 未就绪)与上述出口同结果:版本视为未知,能力位落到方言的基线策略。
/// </summary>
public static TDatabase Start(DbProviderFactory factory,
string connectionString,
Version? specificVersion = null,
bool detectVersion = true)
{
if (specificVersion is not null)
{
return ForVersion(specificVersion);
}

if (!detectVersion || string.IsNullOrWhiteSpace(connectionString))
{
return Baseline;
}

// 借一个空实例读出方言元数据(探测键 / 连接串改写 / 是否需先 Open),探测结果也写回它。
var metadata = new TDatabase();
var probe = DbVersionProbe.Start(metadata.ProbeTarget,
factory,
connectionString,
metadata.PrepareProbeConnectString,
openBeforeRead: metadata.OpenBeforeRead);

return ForProbe(metadata, probe);
}

/// <summary>把探测状态写进实例(<paramref name="probe"/> 为 None 即"不探测")。</summary>
private static TDatabase ForProbe(TDatabase capabilities, DbVersionProbe probe)
{
capabilities.Probe = probe;
return capabilities;
}

/// <summary>在空实例上写显式版本(等同 <see cref="Override"/>,供静态工厂使用)。</summary>
private static TDatabase ForProbe(TDatabase capabilities, Version version)
{
capabilities.Probe = DbVersionProbe.None;
capabilities.Override(version);
return capabilities;
}
}
Loading
Loading