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 數據訪問引擎來說，性能的關注點主要 (不限) 有這些要素：

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

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

其他

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

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

支持贊助

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

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

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

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

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

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

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

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

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

※專營大陸快遞台灣服務

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

前言：命令模式我們平常可能會經常使用，如果我們不了解命令模式的結構和定義那麼在使用的時候也不會將它對號入座。

舉個例子：在winform開發的時候我們常常要用同一個界面來進行文件的下載，但是並不是所有地方都用同一個下載邏輯處理文件，然後下載界面卻可以是同一個界面。

為了以後復用下載界面（下載显示，進度條等）我們常常將下載執行操作定義成一個接口，在具體使用的時候實現接口，將具體執行對象設置到下載界面。當下載按鈕被按下的時候，就調用設置的具體執行對象（接收者）來執行下載的處理。

那接下來我們就看下命令模式的具體細節和實現，再回頭想想我們平時什麼時候不經意就使用到了命令模式，這樣以後交流使用專業的術語不僅能裝還能用。

1、遙控器應用場景

HeadFirst設計模式一書中以遙控器為例實現命令模式，以餐館點餐講解命令模式的對象和結構。為了邏輯清晰我們不混合兩種講解方式，只以遙控器為例講解。

現在需求是有一個遙控器，遙控器上面有控制各種電器的開關，而開關的執行控制電器是由各個廠家開發的設備(對象)插入到對應開關位置的卡槽裏面，基於這些條件我們來實現遙控器系統。

簡單粗暴的解決方案可以對開關做一個標識，當某個開關被按下時根據開關類型進行if判斷。形如 if slot1==Light ,then light.on(), else if slot1==Tv then tv.on() 這種代碼將出現一堆，對於以後增加減少開關或者更換開關都是比較糟糕的。而對於設計遙控器類來說我們應該讓遙控器代碼盡量保持簡單，而不用去關心具體廠商類怎麼執行。所以我們應該將執行封裝在一個命令對象里中，那麼我們就試着一步步實現遙控器。

　　首先我們為命令對象定義一個統一的接。

　　接口只有一個簡單的execute執行命令方法。

    public interface Command
    {
        //執行命令的方法
        public void execute();
    }

　　接下來我們實現一個打開電燈的命令

    public class Light
    {
        public void on() {
            Console.WriteLine("打開電燈");
        }

        public void off()
        {
            Console.WriteLine("關閉電燈");
        }
    }

    public class LightOnCommand : Command
    {
        Light light;

        public LightOnCommand(Light light)
        {
            this.light = light;
        }
        public void execute()
        {
            light.on();
        }
    }

　　為了簡單我們假設遙控器只有一個開關，實現遙控器。

    public class SimpleRemoteControl
    {
        //卡槽
        Command slot;

        public void setCommand(Command command)
        {
            slot = command;
        }

        //按下開關
        public void ButtonWasPressed() {
            slot.execute();
        }

    }

　　測試

     static void Main(string[] args)
        {
            SimpleRemoteControl remoteControl = new SimpleRemoteControl();
            //廠商提供的電燈類，命令的接收者
            Light light = new Light();

            //我們封裝的命令對象，設置接收者
            LightOnCommand lightOnCommand = new LightOnCommand(light);

            //設置遙控器開關對應的命令對象
            remoteControl.setCommand(lightOnCommand);
            remoteControl.ButtonWasPressed();
            Console.ReadKey();
        }

　　

2、命令模式、類圖

通過上面的例子我們已經使用了命令模式來實現一個簡單的遙控器，再回顧【前言】我們說的界面下載文件按鈕操作是不是就是一個典型的可以使用命令模式的應用場景。

只是有一點我們可能不會有什麼其他廠商設計好的執行類，我們也許直接就在繼承接口的命令對象中實現execute的邏輯，而不用再調用其他接收者執行。

這就是“聰明”命令對象，上面我們實現的是“傻瓜”命令對象。這個稍後再說，我們先看命令模式定義和畫出類圖。

命令模式：將“請求”封裝成對象，以便使用不同的請求、隊列或日誌來參數化其他對象。命令模式也支持撤銷的操作。

3、完成多開關遙控器和撤銷操作

假設遙控器現在有五個開關。我們已經有簡單遙控器的經驗，那麼其他4個開關我們也將對應的命令對象設置上去就行了。定義兩個數組用來記錄開關對應的命令對象。

    public class RemoteControl
    {
        Command[] onCommands;
        Command[] offCommands;
        public RemoteControl()
        {
            onCommands = new Command[5];
            offCommands = new Command[5];
            Command noCommand = new NoCommand();
            for (int i = 0; i < 5; i++)
            {
                onCommands[i] = noCommand;
                offCommands[i] = noCommand;
            }
        }
        public void setCommand(int slot,Command commandOn, Command commandOff)
        {
            onCommands[slot] = commandOn;
            offCommands[slot] = commandOff;
        }

        //按下開關
        public void OnButtonWasPressed(int slot)
        {
            onCommands[slot].execute();
        }
        //關閉開關
        public void OffButtonWasPressed(int slot)
        {
            offCommands[slot].execute();
        }

        //打印出數組命令對象
        public override string ToString() {
            var sb = new StringBuilder("\n------------Remote Control-----------\n");
            for (int i = 0; i < onCommands.Length; i++)
            {
                sb.Append($"[slot{i}] {onCommands[i].GetType()}\t{offCommands[i].GetType()} \n");
            }
            return sb.ToString();
        }

    }

　　在遙控器中我們定義了一個Nocommand類，是為了對遙控器對應的開關初始化命令對象，避免為空報錯或者消除開關調用命令對象時檢查對象是否為空的判斷。 

     public void OnButtonWasPressed(int slot)
        {
            if(onCommand[slot]!=null))
                onCommands[slot].execute();
        }

　　在許多設計模式中我們都能看到這種初始值或者空對象的使用。甚至有時候，空對象本身也被視為一種設計模式。(感覺這樣代碼比較優雅O(∩_∩)O)

遙控器完成了，我們還有做一項工作，就是撤銷操作。

撤銷操作我們同樣在命令接口裡面定義一個undo 方法。

    public interface Command
    {
        //執行命令的方法
        public void execute();
        //撤銷命令方法
        public void undo();
    }

　　然後我們讓LightOnCommand實現undo方法，添加LightOffCommand命令對象。

    public class LightOnCommand : Command
    {
        Light light;

        public LightOnCommand(Light light)
        {
            this.light = light;
        }
        public void execute()
        {
            light.on();
        }
        public void undo() {
            light.off();
        }
    }


    class LightOffCommand : Command
    {
        Light light;

        public LightOffCommand(Light light)
        {
            this.light = light;
        }
        public void execute()
        {
            light.off();
        }

        public void undo()
        {
            light.on();
        }
    }

 遙控器裏面添加撤銷按鈕操作UndoButtonWasPressed並用undoCommand屬性存儲上一次操作。

    public class RemoteControl
    {
        Command[] onCommands;
        Command[] offCommands;
        Command undoCommand;
        public RemoteControl()
        {
            onCommands = new Command[5];
            offCommands = new Command[5];
            Command noCommand = new NoCommand();
            for (int i = 0; i < 5; i++)
            {
                onCommands[i] = noCommand;
                offCommands[i] = noCommand;
            }
        }
        public void setCommand(int slot,Command commandOn, Command commandOff)
        {
            onCommands[slot] = commandOn;
            offCommands[slot] = commandOff;
        }

        //按下開關
        public void OnButtonWasPressed(int slot)
        {
            onCommands[slot].execute();
            undoCommand = onCommands[slot];
        }
        //關閉開關
        public void OffButtonWasPressed(int slot)
        {
            offCommands[slot].execute();
            undoCommand = offCommands[slot];
        }

        public void UndoButtonWasPressed() {
            undoCommand.undo();
        }
        //打印出數組命令對象
        public override string ToString() {
            var sb = new StringBuilder("\n------------Remote Control-----------\n");
            for (int i = 0; i < onCommands.Length; i++)
            {
                sb.Append($"[slot{i}] {onCommands[i].GetType()}\t{offCommands[i].GetType()} \n");
            }
            return sb.ToString();
        }

    }

測試：

4、補充總結

補充：

①命令模式的接收者不一定要存在，之前提到過“聰明”和“傻瓜”命令對象，如果以“聰明”命令對象設計，調用者和接收者之間解耦程度比不上“傻瓜”命令對象，但是我們在使用比較簡單的時候仍然可以使用“聰明”命令對象設計。

②撤銷例子我們只做了返回最後一次操作，如果要撤銷許多次我們可以對操作記錄進行保存到堆棧，不管什麼時候撤銷，我們都可以從堆棧中取出最上層命令對象執行撤銷操作。

命令模式常被用於隊列請求，日誌請求。當隊列按照順序取到存放的命令對象后調用執行方法就行了而不用去管具體執行什麼。

日誌請求在某些場合可以用來將所有動作記錄在日誌中，並能在系統死機后通過日誌記錄進行恢復到之前的狀態（撤銷）。對於更高級的的應用而言，這些技巧可以應用到事務（transaction）處理中。

 通過簡單到更進一步的實現講解了命令模式和一些靈活點和需要注意的點，有什麼理解不到位的歡迎指正。

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

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

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

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

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

※專營大陸快遞台灣服務

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

SpringBoot項目有一些基本的配置，比如啟動圖案（banner），比如默認配置文件application.properties，以及相關的默認配置項。

示例項目代碼在：

一、啟動圖案banner

編寫banner.txt放入resources文件夾下，然後啟動項目即可修改默認圖案。

關於banner的生成，可以去一些專門的網站。

比如：https://www.bootschool.net/ascii

二、配置文件application

2.1 application.properties/yml

resources下通常會默認生成一個application.properties文件，這個文件包含了SpringBoot項目的全局配置文件。裏面的配置項通常是這樣的：

server.port=8080

在這個文件里我們可以添加框架支持的配置項，比如項目端口號、JDBC連接的數據源、日誌級別等等。

現在比較流行的是將properties文件改為yml文件。yml文件的格式yaml是這樣的：

server:
    port: 8080

yml和properties的作用是一樣的。而yml的好處是顯而易見的——更易寫易讀。

屬性之間互相調用使用${name}：

eknown:
    email: eknown@163.com
    uri: http://www.eknown.cn
    title: 'hello, link to ${eknown.uri} or email to ${eknown.email}'

鏈接：

2.2 多環境配置文件

通常開發一個應用會有多個環境，常見如dev/prod，也會有test，甚至其他一些自定義的環境，SpringBoot支持配置文件的靈活切換。

定義新配置文件需要遵循以下格式：application-{profile}.properties 或者application-{profile}.yml

比如現在有dev和prod兩個環境，我需要在application.yml文件之外新建兩個文件：

1. application-dev.yml

   server:
      port: 8080

2. application-prod.yml

   server:
     port: 8081

然後在application.yml中通過application.profiles.active={profile}指明啟用那個配置：

application:
    profiles:
      active: dev

除了在application.yml中指定配置文件外，還可以通過啟動命令指定：java -jar xxx.jar --spring.profiles.active=dev

2.2 自定義配置項並獲取它

主要介紹兩種方式，獲取單個配置項和獲取多個配置項。

舉例：

eknown:
    email: eknown@163.com
    uri: http://www.eknown.cn

2.2.1 使用@Value註解獲取單個配置項

@Value("${eknown.email}")
private String email;

@Value("${eknown.uri}")
private String url;

注意：使用@Value註解的時候，所在類必須被Spring容器管理，也就是被@Component、@Controller、@Service等註解定義的類。

2.2.2 獲取多個配置項

第一種，定義一個bean類，通過@Value獲取多個配置項：

@Component
public class MyConfigBean {
  
}

然後我們通過get方法來獲取這些值：

@RestController
public class BasicAction {
  
  @Autowired
  private MyConfigBean myConfigBean;

}

第二種，使用註解@ConfigurationProperties：

@Component
@ConfigurationProperties(perfix="eknown")
public class MyConfigBean {

  private String email;
  private String uri;
}

這裏只需要通過prefix指定前綴即可，後面的值自動匹配。

這裏我們還使用了@Component註解來讓spring容器管理這個MyConfigBean。

此外，我們可以不需要引入@Component，轉而在Application啟動類上加上@EnableConfigurationProperties({MyConfigBean.class})來啟動這個配置。

注意：我們這裡是從主配置文件，也就是SpringBoot默認的application-profile文件中獲取配置數據的。

而從自定義的配置文件，比如test.yml這種形式中獲取配置項時，情況是有點不大一樣的。

三、自定義配置文件

上面介紹的配置文件都是springboot默認的application開頭的文件。如果要自定義一個配置文件呢，比如test.yml或test.properties，怎麼獲取其中的配置項呢？

使用@PageResource註解即可。

首先我們來看一下讀取自定義的properties文件里的內容：

test.properties

hello.time=2019.11.19
hello.name=eknown

定義Configuration類：

@Configuration
@PropertySource("classpath:test.properties")
//@PropertySource("classpath:test.yml") // 注意，yml文件不能直接這樣寫，會讀不出數據
@ConfigurationProperties(prefix = "hello")
public class TestConfiguration {
    private String name;
    private String time;

    // hide get and set methods
}

測試一下：

@RestController
@RequestMapping(value = "test")
public class TestAction {

    @Autowired
    private TestConfiguration testConfiguration;

    @GetMapping(value = "config")
    public String test() {
        return testConfiguration.getName() + "<br/>" + testConfiguration.getTime();
    }
}

如果將properties文件換成yml文件呢？

我們嘗試一下，發現：

讀不出數據？

分析一下@PropertySource註解，發現其使用的PropertySourceFactory是DefaultPropertySourceFactory.

這個類的源碼如下：

public class DefaultPropertySourceFactory implements PropertySourceFactory {
    public DefaultPropertySourceFactory() {
    }

    public PropertySource<?> createPropertySource(@Nullable String name, EncodedResource resource) throws IOException {
        return name != null ? new ResourcePropertySource(name, resource) : new ResourcePropertySource(resource);
    }
}

這個類只能處理properties文件，無法處理yml文件。所以我們需要自定義一個YmlSourceFactory。

public class YamlSourceFactory extends DefaultPropertySourceFactory {

    @Override
    public PropertySource<?> createPropertySource(String name, EncodedResource resource) throws IOException {
        return new YamlPropertySourceLoader().load(resource.getResource().getFilename()
                , resource.getResource()).get(0);
    }
}

然後定義test.yml文件的config類：

@Configuration
@PropertySource(value = "classpath:test.yml", encoding = "utf-8", factory = YamlSourceFactory.class)
@ConfigurationProperties(prefix = "yml.hello")
public class TestYamlConfiguration {
    private String name;
    private String time;

    // hide get and set methods
}

注：為了區分test.properties和test.yml，這裏的test.yml中的屬性以yml.hello開頭。

編寫一下測試：

    @Autowired
    private TestYamlConfiguration ymlConfiguration;

    @GetMapping(value = "yml")
    public String testYml() {
        return "yml config: <br/>" + ymlConfiguration.getName() + "<br/>" + ymlConfiguration.getTime();
    }

訪問：

四、補充@ConfigurationProperties

網上一些資料中，為配合使用@ConfigurationProperties，還使用了@EnableConfigurationProperties註解。

經過測試發現：

1. 從SpringBoot默認配置文件讀取配置信息，使用@ConfigurationProperties + @Component/@Configuration，或者@ConfigurationProperties + 在啟動類添加@EnableConfigurationProperties({class})。這兩種方式都能解決問題

2. 從非默認配置文件讀取配置信息，需要利用@PropertySource註解。同樣兩種方式：

   2.1 @PropertySource + @ConfigurationProperties + @Component/@Configuration

   2.2 @PropertySource + @ConfigurationProperties + @Component/@Configuration + @EnableConfigurationProperties，第二種方式存在一個問題，即還是必須要使用@Component註解，如果不使用，則會導致讀取配置信息為null，但程序不會報錯；而如果採用了，則會導致bean類的set方法被執行兩次（也就是生成了兩個同樣類型的bean類）。這種方式不建議！

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

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

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

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

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

※專營大陸快遞台灣服務

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

前面工廠方法模式中考慮的是一類產品的生產, 如畜牧場只管動物、電視機廠只產電視機等.

同種類稱為同等級, 也就是說,工廠方法模式只會考慮生產同等級的產品,但是在現實生活中許多工廠都是綜合性很強的,也會加大工廠的最大使用效率,能夠生產出多等級的產品. 畜牧場可以養動物,也可以養植物等.

本篇博客將講述抽象工廠方法模式.抽象工廠模式將考慮多等級的產品同時生產,將處於同一個具體工廠所生產的不同等級的產品作為一個產品族. 

模式的定義與特點

定義

是一種為訪問類創建一組相關或者相互依賴的接口,並且訪問類不需要制定所要的產品的具體類就可以得到同族不同等級的產品模式結構.

抽象工廠模式一般都是工廠模式的升級, 工廠模式只生產一個等級的產品,而抽象工廠模式可生產多個等級的產品.

特點

使用抽象工廠模式一般要滿足如下條件.

• 系統中有許多個產品族,每個具體工廠創建統一族但又屬於不同等級結構的產品.

抽象工廠有工廠模式的優點之外,還主要有以下優點:

• 可在類的內部對產品族中相關聯的等級產品進行共同管理,並且不需要引入多個類來進行管理.
• 當增加一個產品族時,不需要更改原來的代碼,滿足了開閉原則.

抽象工廠缺點:

• 當產品族中需要增加新的產品時,所有的工廠類都需要更改

 

模式的結構和實現

抽象工廠和工廠方法一樣,都是由抽象工廠、具體工廠、抽象產品和具體產品4個要素組成,但是抽象工廠中方法個數有所不同,抽象的產品也會有不同.

結構:

模式的主要角色如下:

1. 抽象工廠: 提供了創建產品的接口,包含了多個創建產品的方法,也可以創建多個不同等級的產品.
2. 具體工廠: 實現抽象工廠的多個抽象方法, 完成具體產品的創建.
3. 抽象產品: 定義了產品規範, 描述產品的主要特性和功能, 抽象工廠模式有多個的抽象產品.
4. 具體產品: 實現了抽象產品定義的接口, 具體工廠來創建, 同具體工廠的關係是多對一.

結構圖如下:

模式的實現

上面的圖可發現,抽象工廠和工廠方法有些類似,不同的是產品種類不止一個, 所以創建產品方法也不止一個.

抽象工廠: 提供了產品的生產方法

interface AbstractFactory
{
    public Product1 newProduct1();
    public Product2 newProduct2();
}

具體工廠: 實現產品的生產

class ConcreteFactory1 implements AbstractFactory
{
    public Product1 newProduct1()
    {
        System.out.println("具體工廠 1 生成-->具體產品 11...");
        return new ConcreteProduct11();
    }
    public Product2 newProduct2()
    {
        System.out.println("具體工廠 1 生成-->具體產品 21...");
        return new ConcreteProduct21();
    }
}

 

模式應用實例 

[例1] 抽象工廠設計牧場類.

分析: 農場除了畜牧業可以養動物,也可以養植物,並且也可以種其他的.

抽象工廠模式設計兩個牧場, 一個農場用於養牛和種菜 ,一個用於養馬和種水果.

可以在兩個農場定義生成動物的方法和培養植物的算法.

設計如下結構圖:

代碼如下:

//抽象產品：動物類
interface Animal
{
    public void show();
}

//具體產品：馬類
class Horse implements Animal
{

    public void show()
    {
        jf.setVisible(true);
    }
}

//具體產品：牛類
class Cattle implements Animal
{
   
    public void show()
    {
        jf.setVisible(true);
    }
}

//抽象產品：植物類
interface Plant
{
    public void show();
}
//具體產品：水果類
class Fruitage implements Plant
{    
    public void show()
    {
        jf.setVisible(true);
    }
}
//具體產品：蔬菜類
class Vegetables implements Plant
{
    public void show()
    {
        jf.setVisible(true);
    }
}
//抽象工廠：農場類
interface Farm
{
    public Animal newAnimal();
    public Plant newPlant();
}
//具體工廠：農場類1
class SGfarm implements Farm
{
    public Animal newAnimal()
    {
        System.out.println("新牛出生！");
        return new Cattle();
    }
    public Plant newPlant()
    {
        System.out.println("蔬菜長成！");
        return new Vegetables();
    }
}
//具體工廠：農場類2
class SRfarm implements Farm
{
    public Animal newAnimal()
    {
        System.out.println("新馬出生！");
        return new Horse();
    }
    public Plant newPlant()
    {
        System.out.println("水果長成！");
        return new Fruitage();
    }
}

 

模式的應用場景

抽象工廠模式一般適用於如下場景:

1. 當需要創建的對象是一系列的相互關聯或者依賴的產品族時. 例如工廠中的電視機,收音機以及空調等
2. 系統有多個產品族, 但每次只使用其中的某一族產品時. 如有人只希望某種品牌的衣服和鞋子
3. 系統提供了產品的類庫, 所有產品的接口都相同. 

模式的拓展:

1. 當增加了一個新的產品族時只需要增加一個新的具體實現工廠,不需要更改原來的代碼,滿足了開閉原則
2. 當產品族需要增加一個新種類的產品時, 所有的工廠類都需要更改,不符合開閉原則
3. 當只存在了一個等級結構的產品時,也就退化到了工廠模式的結構.

 

以上就是抽象工廠的理論和實踐模式的內容,希望對大家有所幫助!!!

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

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

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

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

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

※專營大陸快遞台灣服務

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