• 开箱即用简单便捷的轻量级开源开发框架


      你是不是羡慕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

  • 相关阅读:
    6.基础控件
    5.对话框组合
    4.对话框程序
    3. MFC原理介绍
    三星曲面显示器
    笔记本光驱接口怎么外接台式机硬盘?
    笔记本usb外接3.5寸sata台式机硬盘, 用mhdd检测不到,怎么处理?
    MHDD检测不到硬盘的解决办法
    MHDD检测电脑硬盘坏道
    一个指向指针函数的函数指针
  • 原文地址:https://www.cnblogs.com/R2/p/11583952.html
Copyright © 2020-2023  润新知