Zongsoft.Data 發布公告

很高興我們的 ORM 數據訪問框架()在歷經兩個 SaaS 產品的應用之後，今天正式宣布對外推廣！
這是一個類風格的 ORM(Object/Relational Mapping) 數據訪問框架。

又一個輪子？

在很長時間里，.NET 陣營似乎一直缺乏一個被普遍使用的 ORM 數據訪問框架，從最早的原生 ADO.NET 到舶來品 iBatis.NET 和 Hibernate.NET，後來又經歷了 Linq for SQL 與 Entity Framework 的混戰，可能是因為 Entity Framework 早期版本的模糊定位和反覆變更的設計導致了它失之霸主之位，進而造就了一段百舸爭流、群雄共逐的戰國時代。在歷經漫長而反覆的期待、失望、糾結和痛苦之後，我終於決定動手造一個輪子。

設計理念

在開始動手之前，先確定以下基本設計原則：

數據庫優先(Database First)
嚴格的 POCO/POJO 支持
映射模型與代碼完全隔離
禁止業務層出現 SQL 和類 SQL 代碼

在一個業務系統中，數據結構及其關係毋庸置疑是最底層的基礎性結構，數據庫應由系統架構師或開發負責人進行仔細設計 （No Schema/Weakly Schema 的思潮是塗抹了蜂蜜的毒藥），數據訪問映射以數據庫表結構關係為基石，在此之上業務層亦以概念映射模型為準繩，層級之間相互隔離。

領域模型實體避免通過註解 (標籤) 來進行元數據定義，應確保嚴格符合 POCO/POJO 範式。通過語義化的 Schema 來聲明訪問的數據結構關係，禁止應用層的 SQL 和 Linq 式的類 SQL 代碼可降低業務層對數據層的依賴、提升代碼可維護性外，還具備更加統一可控的便利性，併為數據訪問引擎的實現提供了更大的優化空間和自由度。

範例說明

下面通過三個的例子 （注：例子均基於項目） 來佐證上面的部分設計理念，更多示例和闡述請參考項目的文檔和項目的代碼。

提示： 下面的範例均基於開源項目，該項目是一個完整的論壇社區的後台程序。你可能需要預先閱讀一下該項目的文檔，以便更好的理解範例代碼的業務邏輯。

示例一

導航查詢及導航過濾

var forums = this.DataAccess.Select<Forum>(
    Condition.Equal("SiteId", this.User.SiteId) &
    Condition.In("Visibility", Visibility.Internal, Visibility.Public) |
    (
        Condition.Equal("Visibility", Visibility.Specified) &
        Condition.Exists("Users",
                  Condition.Equal("UserId", this.User.UserId) &
                  (
                      Condition.Equal("IsModerator", true) |
                      Condition.NotEqual("Permission", Permission.None)
                  )
        )
    ),
    "*, MostRecentThread{ThreadId,Title,Creator{Name,Nickname,Avatar}}"
);

上述數據訪問的查詢方法大致生成如下SQL腳本：

SELECT
    t.*,
    t1.ThreadId AS 'MostRecentThread.ThreadId',
    t1.Title AS 'MostRecentThread.Title',
    t1.CreatorId AS 'MostRecentThread.CreatorId',
    t2.UserId AS 'MostRecentThread.Creator.UserId',
    t2.Name AS 'MostRecentThread.Creator.Name',
    t2.Nickname AS 'MostRecentThread.Creator.Nickname',
    t2.Avatar AS 'MostRecentThread.Creator.Avatar'
FROM Forum t
    LEFT JOIN Thread AS t1 ON
        t.MostRecentThreadId=t1.ThreadId
    LEFT JOIN UserProfile AS t2 ON
        t1.CreatorId=t2.UserId
WHERE
    t.SiteId = @p1 AND
    t.Visibility IN (@p2, @p3) OR
    (
        t.Visibility = @p4 AND
        EXISTS
        (
            SELECT u.SiteId, u.ForumId, u.UserId
            FROM ForumUser u
            WHERE u.SiteId = t.SiteId AND
                  u.ForumId = t.ForumId AND
                  u.UserId = @p5 AND
                  (
                      u.IsModerator = @p6 OR
                      u.Permission != @p7
                  )
        )
    );

上述示例通過 Select 查詢方法的 schema 參數 （即值為 *, MostRecentThread{ThreadId,Title,Creator{Name,Nickname,Avatar}} 的參數） 從數據結構關係的層次指定了查詢數據的形狀，因而不再需要 SQL 或類 SQL 語法中 JOIN 這樣命令式的語法元素，它不光提供了更簡潔且語義化的 API 訪問方式，而且還給數據訪問引擎底層提供了更大的優化空間和自由度。

如果將 Select 查詢方法的 schema 參數值改為 *,Moderators{*},MostRecentThread{ThreadId,Title,Creator{Name,Nickname,Avatar}} 后，數據訪問引擎會將查詢內部分解為一對多的兩條 SQL 語句進行迭代執行，而這些都不需要業務層進行分拆處理，因而提升了效率並降低了業務層的複雜度。

注：將 Schema 模式表達式通過 Web API 提供給前端應用，將大大減少後端開發的工作量，提升前後端的工作效率。

示例二

一對多的關聯新增

// 構建待新增的實體對象
var forum = new
{
    SiteId = this.User.SiteId,
    GroupId = 100,
    Name = "xxxx",

    // 一對多的導航屬性
    Users = new ForumUser[]
    {
      new ForumUser { UserId = 1001, IsModerator = true },
      new ForumUser { UserId = 1002, Permission = Permission.Read },
      new ForumUser { UserId = 1003, Permission = Permission.Write },
    }
}

// 執行數據新增操作
this.DataAccess.Insert<Forum>(forum, "*, Users{*}");

上述數據訪問的新增方法大致生成如下SQL腳本：

/* 主表插入語句，執行一次 */
INSERT INTO Forum (SiteId,ForumId,GroupId,Name,...) VALUES (@p1,@p2,@p3,@p4,...);

/* 子表插入語句，執行多次 */
INSERT INTO ForumUser (SiteId,ForumId,UserId,Permission,IsModerator) VALUES (@p1,@p2,@p3,@p4,@p5);

上述示例通過 Insert 新增方法的 schema 參數（即值為 *,User{*} 的參數）指定了新增數據的形狀，由數據訪問引擎根據映射定義自動處理底層的 SQL 執行方式，確保業務層代碼的簡潔和更高的執行效率。

示例三

一對一和一對多的關聯更新，對於“一對多”的導航屬性，還能確保該屬性值 (集合類型) 以 UPSERT 模式寫入。

public bool Approve(ulong threadId)
{
    //構建更新的條件
    var criteria =
        Condition.Equal(nameof(Thread.ThreadId), threadId) &
        Condition.Equal(nameof(Thread.Approved), false) &
        Condition.Equal(nameof(Thread.SiteId), this.User.SiteId) &
        Condition.Exists("Forum.Users",
            Condition.Equal(nameof(Forum.ForumUser.UserId), this.User.UserId) &
            Condition.Equal(nameof(Forum.ForumUser.IsModerator), true));

    //執行數據更新操作
    return this.DataAccess.Update<Thread>(new
    {
        Approved = true,
        ApprovedTime = DateTime.Now,
        Post = new
        {
            Approved = true,
        }
    }, criteria, "*,Post{Approved}") > 0;
}

上述數據訪問的更新方法大致生成如下SQL腳本：

/* 以下代碼為支持 OUTPUT/RETURNING 子句的數據庫（如：SQLServer,Oracle,PostgreSQL） */

/* 根據更新的關聯鍵創建臨時表 */
CREATE TABLE #TMP
(
    PostId bigint NOT NULL
);

/* 更新主表，並將更新的關聯鍵輸出到內存臨時表 */
UPDATE T SET
    T.[Approved]=@p1,
    T.[ApprovedTime]=@p2
OUTPUT DELETED.PostId INTO #TMP
FROM [Community_Thread] AS T
    LEFT JOIN [Community_Forum] AS T1 ON /* Forum */
        T1.[SiteId]=T.[SiteId] AND
        T1.[ForumId]=T.[ForumId]
WHERE
    T.[ThreadId]=@p3 AND
    T.[Approved]=@p4 AND
    T.[SiteId]=@p5 AND EXISTS (
        SELECT [SiteId],[ForumId]
        FROM [Community_ForumUser]
        WHERE [SiteId]=T1.[SiteId] AND
              [ForumId]=T1.[ForumId] AND
              [UserId]=@p6 AND
              [IsModerator]=@p7
    );

/* 更新關聯表 */
UPDATE T SET
    T.[Approved]=@p1
FROM [Community_Post] AS T
WHERE EXISTS (
    SELECT [PostId]
    FROM #TMP
    WHERE [PostId]=T.[PostId]);

上述示例通過 Update 更新方法的 schema 參數（即值為 *,Post{Approved} 的參數）指定了更新數據的形狀，數據訪問引擎將根據數據庫類型生成高效的 SQL 語句，對於業務層而言這一切都是無感的、透明的。

對於一對多的導航屬性，數據訪問引擎默認將以 UPSERT 模式處理子集的寫入，關於 UPSERT 更多信息請參考項目文檔。

性能

我們希望提供最佳的綜合性價比，對於一個 ORM 數據訪問引擎來說，性能的關注點主要 (不限) 有這些要素：

生成簡潔高效的 SQL 腳本，並盡可能利用特定數據庫的最新 SQL 語法；
數據查詢結果的實體組裝(Populate)過程必須高效；
避免反射，有效的語法樹緩存。

實現層面我們採用 Emitting 動態編譯技術對實體組裝(Populate)、數據參數綁定等進行預熱處理，可查閱等相關類的源碼深入了解。

其他

得益於 “以聲明方式來表達數據結構關係” 的語義化設計理念，相對於命令式設計而言，它使得程序意圖更加聚焦，天然地對底層數據的表達和優化更加寬容與自由。

更多詳細內容 （譬如：讀寫分離、繼承表、數據模式、映射文件、過濾器、驗證器、類型轉換、數據隔離） 請查閱相關文檔。

支持贊助

我們歡迎並期待任何形式的推廣支持！

如果你認同我們的設計理念請為這個項目點贊(Star)，如果你認為該項目很有用，並且希望支持它未來的發展，請給予必要的資金來支持它：

關注 Zongsoft 微信公眾號，對我們的文章進行打賞；
加入，可以獲得在線問答和技術支持；
如果您的企業需要現場技術支持與輔導，又或者需要開發新功能、即刻的錯誤修復等請給我。

提醒： 本文可能會更新，請閱讀原文：，以避免因內容陳舊而導致的謬誤，同時亦有更好的閱讀體驗。

本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理
【其他文章推薦】

※為什麼 USB CONNECTOR 是電子產業重要的元件?

※網頁設計一頭霧水??該從何著手呢? 找到專業技術的網頁設計公司，幫您輕鬆架站!

※想要讓你的商品成為最夯、最多人討論的話題?網頁設計公司讓你強力曝光

※想知道最厲害的台北網頁設計公司推薦、台中網頁設計公司推薦專業設計師”嚨底家”!!

※專營大陸快遞台灣服務

※台灣快遞大陸的貨運公司有哪些呢?