sod

项目地址： https://github.com/znlgis/SOD（社区主仓库见 https://gitee.com/znlgis/SOD）

官网： https://www.pwmis.com/sod/

官方文档： http://www.pwmis.com/sod/

NuGet： PDF.NET.SOD

NuGet（.NET 6+）： PWMIS.SOD

许可证： Apache-2.0

概述

SOD 由 PDF.NET 演化而来，主要特点：

• 混合 ORM 模式：原生 SQL + ORM + SQL-MAP（XML 配置）+ OQL（对象查询语言）
• 多数据库：SqlServer / Oracle / MySQL / PostgreSQL / SQLite / Access / 达梦 DM / 人大金仓 / 神舟通用
• AdoHelper：屏蔽底层 Provider 差异
• 实体类：EntityBase，支持脏字段跟踪、字段映射、状态机
• OQL：链式 API 查询、连接、分组、聚合
• SQL-MAP：XML 写 SQL，Mybatis 风格
• 读写分离：主从配置
• 缓存与监控：内置 SQL 性能日志

---

安装

dotnet add package PDF.NET.SOD
# 或对应数据库 Provider：
dotnet add package PDF.NET.SOD.MySQL
dotnet add package PDF.NET.SOD.PostgreSQL

---

配置连接字符串（App.config / appsettings）

<connectionStrings>
  <add name="local" providerName="SqlServer"
       connectionString="server=.;database=demo;uid=sa;pwd=..." />
</connectionStrings>

或代码：

using PWMIS.DataProvider.Data;
var db = MyDB.GetDBHelperByConnectionString(
    "server=.;database=demo;uid=sa;pwd=...", "SqlServer");

---

实体类

using PWMIS.DataMap.Entity;

[Serializable]
public class User : EntityBase
{
    public User() {
        TableName  = "Users";
        IdentityName = "Id";        // 自增列
        PrimaryKeys.Add("Id");
    }

    public int Id        { get => getProperty<int>("Id");
                           set => setProperty("Id", value); }
    public string Name   { get => getProperty<string>("Name");
                           set => setProperty("Name", value, 50); }
    public DateTime Time { get => getProperty<DateTime>("CreateTime");
                           set => setProperty("CreateTime", value); }
}

可通过 SOD CodeMaker 或 EntityBuilder 自动生成。

---

CRUD（EntityQuery）

using PWMIS.DataMap.Entity;

var db = MyDB.GetDBHelperByConnectionName("local");
var q  = new EntityQuery<User>(db);

var u = new User { Name = "Tom", Time = DateTime.Now };
q.Insert(u);                                     // INSERT

u.Name = "Tom2";
q.Update(u);                                     // UPDATE（仅脏字段）

var list = q.GetList(top: 10);                  // SELECT TOP 10
var u1   = q.GetEntity(new User { Id = 1 });    // by PK

q.Delete(u1);                                    // DELETE