開箱即用簡單便捷的輕量級開源開發框架

来源:https://www.cnblogs.com/R2/archive/2019/09/25/11583952.html
-Advertisement-
Play Games

你是不是羡慕Java SpringBoot里功能強大的@註解功能，Spring Boot倡導是一種開箱即用、方便快捷、約定優於配置的開發流程，雖然現在.NET Core也往相同的方向走，但在使用上總有點彆扭，目前市面上貌似還沒有輕量級的真正意義上的開箱即用的基於.NET Core的框架。 想想多年前 ...


　　你是不是羡慕Java SpringBoot里功能強大的@註解功能，Spring Boot倡導是一種開箱即用、方便快捷、約定優於配置的開發流程，雖然現在.NET Core也往相同的方向走，但在使用上總有點彆扭，目前市面上貌似還沒有輕量級的真正意義上的開箱即用的基於.NET Core的框架。

　　想想多年前自己開發基於配置的DevFx開發框架，因為需要配置，造成開發人員苦不堪言，而且還容易配置錯誤，導致各種奇怪的錯誤；於是便有全新重寫DevFx框架的想法，經過N個月的奮戰，終於可以放出來用了。

　　框架不求功能全面，只求使用方便、靈活。

　　目前框架提供基於Attribute的IoC DI容器，完全可以面向介面編程了；提供輕量級的業務參數配置方案，未來計劃作為集中配置的基礎；提供極簡但不失靈活的數據訪問框架，類似mybatis基於sql的數據訪問；還有基於HTTP/JSON的遠程調用方案（以優雅的本地調用方式來遠程調用）；主要是以上幾個功能。

　　框架是基於.NET Standard 2.0開發，理論上.NET Framework 4.6.1也能使用，因為框架已完全重新重寫了，命名空間啥的都有改變，所以不相容之前的版本，目前版本是5.0.2。

　　OK，show me the code。下麵讓我們來快速入門，看看怎麼個開箱即用。

 

打開VS2019，建立基於.NET Core 2.2或3.0的控制台項目ConsoleApp1，下麵的例子是基於.NET Core 3.0的。使用NuGet安裝DevFx 5.0.2版本

 

 上圖，忽略DevFx.*，這是老舊版本，目前基於.NET Standard只有一個包，就是DevFx

創建業務邏輯介面和實現類

using DevFx;

namespace ConsoleApp1
{
    //業務邏輯介面，[Service]特性告訴DevFx這個介面需要被DI
    [Service]
    public interface IMyService
    {
        string GetUserName(string userId);
    }
}
using DevFx;
using System;

namespace ConsoleApp1
{
    //業務邏輯實現類，[Object]特性告訴DevFx這個類需要放入到IoC容器里，DevFx會掃描這個類實現了哪些介面，並做映射
    [Object]
    internal class MyService : IMyService
    {
        public string GetUserName(string userId) {
            return $"{userId}_{DateTime.Now.Ticks}";
        }
    }
}

開始調用邏輯

using DevFx;
using System;

namespace ConsoleApp1
{
    class Program
    {
        static void Main(string[] args) {
            //控制台程式需要顯式調用框架的初始化方法
            //ASP.NET Core（通用主機）可以使用UseDevFx擴展方法來初始化框架
            ObjectService.Init();
            //獲取介面實現類的實例
            var myservice = ObjectService.GetObject<IMyService>();
            Console.WriteLine(myservice.GetUserName("IamDevFx"));
            //還能直接獲取MyService類的實例
            var myservice1 = ObjectService.GetObject<MyService>();
            //2種方式獲取的實例是同一個
            Console.WriteLine($" myservice={myservice.GetHashCode()}{Environment.NewLine}myservice1={myservice1.GetHashCode()}");
        }
    }
}

運行下：

 

 是不是很簡單？開箱即用！

 

接下介紹下自動裝配的例子

我們建立另外一個業務邏輯介面和相應的實現類，同樣分別標上[Service]和[Object]

using DevFx;

namespace ConsoleApp1
{
    [Service]
    public interface IBizService
    {
        string GetUserDisplayName(string userId);
    }

    [Object]
    internal class BizService : IBizService
    {
        public string GetUserDisplayName(string userId) {
            return "IamBizService";
        }
    }
}

改下之前的業務類MyService

using DevFx;
using System;

namespace ConsoleApp1
{
    //業務邏輯實現類，[Object]特性告訴DevFx這個類需要放入到IoC容器里，DevFx會掃描這個類實現了哪些介面，並做映射
    [Object]
    internal class MyService : IMyService
    {
        //自動裝配（註入）
        [Autowired]
        protected IBizService BizService { get; set; }

        public string GetUserName(string userId) {
            return $"{userId}_{DateTime.Now.Ticks}_{this.BizService.GetUserDisplayName(userId)}";
        }
    }
}

運行下：

 

接下來介紹下基於xml的配置，可能有些同學會問，.NET Core不是自帶配置了麽？別急，看下我們的使用方式你就清楚誰便捷了。

業務參數指的比如微信的API介面地址、APPID等程式里需要使用的，或者一些開關之類的參數

首先定義需要承載業務參數的介面

using DevFx.Configuration;

namespace ConsoleApp1
{
    //定義需要承載業務參數的介面，[SettingObject("~/myservice/weixin")]告訴框架這是一個配置承載對象
    //    其中~/myservice/weixin為配置在配置文件里的路徑
    [SettingObject("~/myservice/weixin")]
    public interface IWeixinSetting
    {
        string ApiUrl { get; }
        string AppID { get; }
        string AppKey { get; }
    }
}

使用自動裝配特性，裝配到業務邏輯里，我們修改下MyService類

using DevFx;
using System;

namespace ConsoleApp1
{
    //業務邏輯實現類，[Object]特性告訴DevFx這個類需要放入到IoC容器里，DevFx會掃描這個類實現了哪些介面，並做映射
    [Object]
    internal class MyService : IMyService
    {
        //自動裝配（註入）
        [Autowired]
        protected IBizService BizService { get; set; }
        //配置自動註入
        [Autowired]
        protected IWeixinSetting WeixinSetting { get; set; }

        public string GetUserName(string userId) {
            return $"{userId}_{DateTime.Now.Ticks}_{this.BizService.GetUserDisplayName(userId)}_weixin={this.WeixinSetting.ApiUrl}";
        }
    }
}

在項目里添加app.config，並設置為有更新就輸出

 

app.config內容如下：

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <devfx>
        <myservice>
            <weixin apiUrl="https://api.weixin.qq.com/sns/oauth2/access_token"
                    appId="1234567890" appKey="0123456789" />
        </myservice>
    </devfx>
</configuration>

運行下：

 

 

最後介紹下類似mybatis的數據訪問是如何開箱即用的，因為涉及到資料庫，稍微複雜些，但還是很方便的。

我們以操作MySql為例，首先需要使用NuGet安裝MySql驅動包，目前框架預設使用社區版的MySql驅動：MySqlConnector

 

定義我們的數據訪問層介面

using ConsoleApp1.Models;
using DevFx;
using DevFx.Data;

namespace ConsoleApp1.Data
{
    //定義數據操作介面，[DataService]告訴框架這是一個數據操作介面
    [DataService(GroupName = "MyService")]
    public interface IMyDataService : ISessionDataService
    {
        EventMessage GetEventMessageByID(string id);
    }
}

在項目中，添加一個.sqlconfig文件，用來編寫對應的Sql語句，並把這個文件按嵌入資源形式設置

 

 sqlconfig內容如下：

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <devfx>
        <data>
            <statements name="MyService">
                <add name="GetEventMessageByID">
                    <sql>
                        <![CDATA[SELECT * FROM EventMessages WHERE MessageGuid = @ID]]>
                    </sql>
                </add>
            </statements>
        </data>
    </devfx>
</configuration>

相信聰明的你能看出對應關係

然後就是在app.config里配置鏈接字元串，如下

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <devfx>
        <data debug="true">
            <connectionStrings>
                <add name="EventMessageConnection" connectionString="Database=EventMessages;Data Source=資料庫IP;User ID=資料庫用戶;Password=密碼;Character Set=utf8" providerName="System.Data.MySqlClient" />
            </connectionStrings>
            <dataStorages defaultStorage="EventMessageStorage">
                <add name="EventMessageStorage" connectionName="EventMessageConnection" type="MySql" />
            </dataStorages>
        </data>

        <myservice>
            <weixin apiUrl="https://api.weixin.qq.com/sns/oauth2/access_token"
                    appId="1234567890" appKey="0123456789" />
        </myservice>
    </devfx>
</configuration>

調整下我們MySerivce類

using ConsoleApp1.Data;
using DevFx;
using System;

namespace ConsoleApp1
{
    //業務邏輯實現類，[Object]特性告訴DevFx這個類需要放入到IoC容器里，DevFx會掃描這個類實現了哪些介面，並做映射
    [Object]
    internal class MyService : IMyService
    {
        //自動裝配（註入）
        [Autowired]
        protected IBizService BizService { get; set; }
        //配置自動註入
        [Autowired]
        protected IWeixinSetting WeixinSetting { get; set; }
        //數據訪問介面自動註入
        [Autowired]
        protected IMyDataService MyDataService { get; set; }

        public string GetUserName(string userId) {
            var msg = this.MyDataService.GetEventMessageByID("0000e69f407a4b69bbf3866a499a2eb6");
            var str = $"EventMessage:{msg.MessageGuid}_{msg.Category}_{msg.Priority}_{msg.CreatedTime}";
            return $"{userId}_{DateTime.Now.Ticks}_{this.BizService.GetUserDisplayName(userId)}_weixin={this.WeixinSetting.ApiUrl}{Environment.NewLine}{str}";
        }
    }
}

運行下：

 當然數據訪問不僅僅是查詢，還應該有CRUD、分頁以及事務才完整，這些後續會詳細展開。

 

OK，上面就是這些核心功能的展示，另外框架還支持自定義Attribute的處理方便自行擴展。

後續會比較詳細介紹實現原理以及對框架的拓展，比如服務註冊發現、配置中心等等。

有興趣的同學可以一起共同討論維護，項目開源地址在：https://github.com/mer2/devfx

碼字不容易啊，感興趣的可以去star下。

示例代碼在此：https://files.cnblogs.com/files/R2/ConsoleApp1.zip

 


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • [視頻教程] 如何在Linux深度系統deepin下安裝docker
    筆記： 安裝docker的命令 curl -sSL https://get.docker.com/ | sh service docker start 排查錯誤的命令 strace 視頻地址在此：https://www.bilibili.com/video/av68889436/ ...
  • 實用Jupyter Notebook擴展工具——提升你的工作效率
    Jupyter Notebook 現已成為數據分析，機器學習的必備工具。因為它可以讓數據分析師集中精力向用戶解釋整個分析過程。通過安裝一些擴展工具，可以讓你在Jupyter Notebook上的工作效率進一步的提高。 Jupyter NbExtensions Configurator Jupyter ...
  • Ubuntu18.04直接安裝python3.7或者升級自帶的python3.6版本之後導致終端無法打開的解決辦法
    安裝ptyhon3.7 sudo apt-get update sudo apt-get install python3.7 安裝成後的目錄在/usr/bin/python3.7，同時將其設置成預設 sudo update-alternatives --install /usr/bin/python ...
  • DRF框架中鏈表數據通過ModelSerializer深度查詢方法彙總
    DRF框架中鏈表數據通過ModelSerializer深度查詢方法彙總 一.準備測試和理解準備 創建類 生成表單數據 Test1 id| test_2_id_id | 1|1 2|2 Test2 id|name | 1|名字1 2|名字2 二.深度查詢通過Test1獲得Test2的name而不是id ...
  • python-隨機生成驗證碼實例
    需求：隨機生成驗證碼， 思路： 1.生成一個隨機數，65-90 2.數字轉化為字母：chr(數字) 1 #!/usr/bin/env python 2 # -*- coding:utf-8 -*- 3 4 import random 5 temp = "" 6 for i in range(6): ...
  • python常用數據結構講解
    [TOC] 一：序列     在數學上，序列是被排成一排的對象，而在python中，序列是最基本的數據結構。它的主要特征為擁有索引，每個索引的元素是可迭代對象。都可以進行索引，切片，加，乘，檢查成員等操作。在python中，有六種內建的索引，但是常用的是列表，元組，字元 ...
  • .NET Core簡介
    這是大佬老A寫的一篇介紹Asp.Net core框架的文章https://www.cnblogs.com/artech/p/inside-asp-net-core-framework.html 2001年，微軟推出了Asp.Net ，2009年，推出了Asp.Net MVC .Net Framewo ...
  • C#面向對象之多態
    一、多態 多態是從繼承中引出來的概念，即不同的派生類對基類的相同方法表現出不同的行為。如下麵例子中動物的游泳方法： 當用戶使用派生類雞的游泳方法時，由於基類的游泳方法滿足雞的需求，則直接調用基類的游泳方法返回不會；當用戶使用派生類狗和蛙的游泳方法時，由於基類的游泳方法的實現不滿足狗和蛙的需求，所以狗 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類