因为喜欢所以升级,MyStaging-3.0 继续

  • A+
所属分类：.NET技术
摘要

目前该项目只有我一个人在维护，权当学习交流。为什么要继续维护呢，说一千道一万，还是因为喜欢，由于他的简单易用，从而促使我决定对 MyStaging 进行升级，目前 3.0+的版本和2.1.13 是不兼容的两套体系，3.0+ 体系架构更灵活清晰，可操作性和易用性更强。
便宜好用的国外VPS推荐

 

我为什么维护MyStaging

目前该项目只有我一个人在维护，权当学习交流。为什么要继续维护呢，说一千道一万，还是因为喜欢，由于他的简单易用，从而促使我决定对 MyStaging 进行升级，目前 3.0+的版本和2.1.13 是不兼容的两套体系，3.0+ 体系架构更灵活清晰，可操作性和易用性更强。

欢迎使用 MyStaging

项目地址

https://github.com/lianggx/mystaging

因为喜欢所以升级,MyStaging-3.0 继续

MyStaging 是一款基于 .NETCore 平台的 ORM 中间件，提供简单易用的接入工具，全链路写法，支持 DbFirst/CodeFirst，而且两种模式（DbFirst/CodeFirst）可以无缝切换。比如一开始你是先创建数据库，然后生成了实体，在接下来的开发过程中，改动实体对象后，可以使用CodeFirst进行无缝迁移，自由使用DbFirst/CodeFirst进行迁移工作 。

支持多种数据库类型，和 EF 不同的是，对单个项目的多路上下文支持中引进了主从数据库概念，查询默认从库，也可以指定主库，删除/修改/新增操作默认走主库，地层还提供了对单个查询数据的分布式缓存操作，可以自由灵活配置，目前 MyStaging 还在持续完善中，欢迎加入 Star/Contributors/Fork。

相关组件

MyStaging一共分为三个部分，分别是：

  • 1、基础框架 - MyStaging
  • 2、提供程序 - MyStaging.Mysql/MyStaging.PostgreSQL
  • 3、迁移工具 - MyStaging.Gen

在包管理控制台安装 MyStaging.Gen 到 dotnet tool 命令

MyStaging.Gen 是一个独立的数据库迁移组件，其本质上是一个控制台程序，你可以单独下载这个包到本地，也可以将他安装到 dotnet tool ，安装到 dotnet tool 后，你就可以在 visual studio 中使用命令进行数据库的迁移工作。

安装迁移工具到 dotnet tool

dotnet tool install -g MyStaging.Gen

要使用 MyStaging.Gen 请根据下面的参数说明，执行创建实体对象映射.

--help 查看帮助 -m [mode，db[DbFirst]/code[CodeFirst]，默认为 DbFirst -t [dbtype[Mysql/PostgreSQL]，数据库提供程序]  required -d [database，数据库连接字符串] required -p [project，项目名称]  required -o [output，实体对象输出路径]，默认为 {project}/Models 
==============示例==============   CodeFirst：   mystaging.gen -m code -t PostgreSQL -p Pgsql -d "Host=127.0.0.1;Port=5432;Username=postgres;Password=postgres;Database=mystaging;"    DbFirst：   mystaging.gen -m db -t PostgreSQL -p Pgsql -d "Host=127.0.0.1;Port=5432;Username=postgres;Password=postgres;Database=mystaging;" ================================

** 注意，上面的两种迁移模式可以实时切换使用，不影响一开始选择的模式，且无副作用。

如何选择数据库提供程序

MyStaging 提供了多种数据库的支持，目前提供了 PostgreSQL/Mysql 的支持，后续将陆续开发更多提供程序，比如基于 PostgreSQL 进行开发的程序，那么可以选择引用包 MyStaing.PostgreSQL。

数据库 提供程序
PostgreSQL MyStaing.PostgreSQL
Mysql MyStaging.Mysql

迁移过程

当你进行数据库关系迁移后，MyStaging会在指定的路径上生成实体对象文件目录：Model，该目录包含了数据库上下文对象 xxxDbContext 和实体对象的文件，以 /examples/Mysql 项目为例子，执行迁移后，将生成 Model/MysqlDbContext.cs，该文件即为上下文对象；相反的，可以使用了CodeFirst进行 Model 实体对象的迁移，MyStaging 会检查指定程序集的实体对象，当发现对象携带 TableAttribute 特性时，MyStaging会认为该对象参与迁移。

    [Table(name: "article", Schema = "mystaging")]     public partial class Article     {         [Column(TypeName = "tinyint(1)")]         public bool State { get; set; }         /// <summary>         ///  主键，自增         /// </summary>         [PrimaryKey(AutoIncrement = true)]         public int id { get; set; }         public int userid { get; set; }         public string title { get; set; }         public string content { get; set; }         public DateTime createtime { get; set; }         public string IP { get; set; }     }

属性迁移

迁移后的实体对象，都是分部类（partial），在有些情况下，我们需要在实体对象上增加一些影子属性，影子属性通常指数据库中存在的字段，而实体对象中并没有定义，反之一样。如果需要定义影子属性在实体对象中，你只需要在影子属性上增加特性 NotMappedAttribute 即可。

    [Table(name: "article", Schema = "mystaging")]     public partial class Article     {        [NotMapped]        public string IP { get; set; }     }

初始化数据库上下文

初始化 DbContext 上下文对象时，要求传入一个配置 StagingOptions，该 StagingOptions 包含了一些必须和可选的配置

public StagingOptions(string name, string master, params string[] slaves)

上面的 StagingOptions 构造函数中的参数表示： name=配置的名称，master=主数据库的连接字符串，slaves=从库的连接字符串（支持多个），其它没有出现在构造函数中的属性，表示可选参数，可选参数包含了 CacheOptions（缓存选项）和 Logger（日志组件），如果你配置了日志和缓存，MyStaging将在某些场景下启用该设置，比如针对查询单个对象的主键缓存，缓存还支持分布式缓存（IDistributedCache）

最终初始化上下文对象

    // 控制台应用程序     static void Main(string[] args)     {         var options = new MyStaging.Metadata.StagingOptions("MySql", "server=127.0.0.1;user id=root;password=root;database=mystaging");         var context = new MysqlDbContext(options);     }      // Web应用程序     public void ConfigureServices(IServiceCollection services) 	{         var options = new MyStaging.Metadata.StagingOptions("MySql", "server=127.0.0.1;user id=root;password=root;database=mystaging");         var context = new MysqlDbContext(options); 		services.AddScoped(this.Configuration);     }

CURD合集

插入

此示例包含单次插入和批量插入

    var article = new Article()     {         content = "你是谁？你从哪里来？要到哪里去？",         createtime = DateTime.Now,         userid = customer.Id,         IP = "127.0.0.1",         State = true,         title = "振聋发聩的人生三问"     };          var list = new System.Collections.Generic.List<Article>();     for (int i = 0; i < 10; i++)     {         list.Add(article);     }          // 单个插入     var newArticle = context.Article.Insert.Add(article);     // 批量插入     var affrows = context.Article.Insert.AddRange(list).SaveChange();

更新

与 EF 不同的是，MyStaging的更新采用无附加实体的方式，直接执行更新过程

    var article = context.Article.Update.SetValue(f => f.content, "未来已来，从这里开始").Where(f => f.id == 1001).SaveChange();

删除

删除和更新类似，都是直接执行

    context.Article.Delete.Where(f => f.id == 1001).SaveChange();

查询

查询比较复杂，不过基本和 EF 类似的语法

    // 单个查询     var article = context.Customer.Select.Where(f => f.Id == 2 && f.Name == "Ron").ToOne();     // 列表查询，排序、分页、分组     var articles = context.Customer.Select.OrderBy(f => f.Id).Page(1, 10).GroupBy("Name").ToList();     // 表连接查询     var article = context.Article.Select.InnerJoin<Customer>("b", (a, b) => a.userid == b.Id).Where<Customer>(f => f.Id == 2).ToOne();     // 首字段查询，ToScalar 参数可以传递 Sql 参数，比如 SUM(x)     var id = context.Customer.Select.Where(f => f.Id == 2 && f.Name == "Ron").ToScalar<int>("Id");

更多示例，请访问 /examples

项目地址：https://github.com/lianggx/mystaging

便宜好用的国外VPS推荐