4.4 异构、多数据库的存取组件

在一个大型系统中,应该允许访问多个数据库,甚至是多个异构的数据库。例如表单模块使用mysql,数据仓库模块使用oracle等等。按照这个目标,数据的配置信息:

 

 1     "Database": {
 2       "ConnectionStrings": [
 3         {
 4           "Name": "MicroStrutLibrary",
 5           "ConnectionString": "Data Source=XXXX;Initial Catalog=XXXX;User Id=OperUser;Password=OperUser;MultipleActiveResultSets=true;Persist Security Info=true",
 6           "ProviderName": "System.Data.SqlClient"
 7         },
 8         {
 9           "Name": "CMS",
10           "ConnectionString": "Data Source=XXXX;Initial Catalog=XXXX;User Id=OperUser;Password=OperUser;MultipleActiveResultSets=true;Persist Security Info=true",
11           "ProviderName": "System.Data.SqlClient"
12         }
13       ],
14       "Providers": [
15         {
16           "Name": "System.Data.SqlClient",
17           "Type": "MicroStrutLibrary.Infrastructure.Core.Data.Entity.SqlServerDbContextOptionsBuilderProvider, MicroStrutLibrary.Infrastructure.Core.Data.Entity"
18         }
19       ]
20     }

 

每个数据库都有一个Name(名称,以后都用这个名称访问)、ConnectionString(数据库链接串)、ProviderName(提供程序名)。对于ProviderName(提供程序名)在Providers中描述了对应的实现类描述TypeDescription。从上面我们可以看出,我们可以设置多个数据库,不同的数据库可以设置不同的Provider,也就是不同的数据库类型,从而实现了多个异构数据库的存取操作。

对于数据库配置信息类DataConfigInfo,实现ConfigInfo,应该很简单,就不赘述了,可以参见可换源的配置

框架中,每个模块(例如公共模块、数据仓库模块、表单模块、CMS模块、授权认证模块等)都对应于一个数据库上下文DbContext。这个数据库上下文指向一个数据库,也就是要对应上数据配置中的Name属性。我们的做法是新建一个DbNameAttribute,放在DbContext上,以确定具体数据库的Name。

 

 1     /// <summary>
 2     /// 指定数据库名称特性
 3     /// </summary>
 4     [AttributeUsage(AttributeTargets.Class, AllowMultiple = false, Inherited = false)]
 5     public class DbNameAttribute : Attribute
 6     {
 7         /// <summary>
 8         /// 数据库名称
 9         /// </summary>
10         public string Name { get; set; }
11 
12         /// <summary>
13         /// 构造函数
14         /// </summary>
15         /// <param name="name"></param>
16         public DbNameAttribute(string name)
17         {
18             this.Name = name;
19         }
20 }

 

DBNameAttribute中的Name应该设置的就是配置中的Name,从而确保DbContext对应的是哪个数据库。

例如公共模块部分的DbContext写法如下:

 1     [DbName("MicroStrutLibrary")]
 2     public class CommonDbContext : EntityDbContext
 3     {
 4         public CommonDbContext(DbContextOptions<CommonDbContext> options) : base(options)
 5         {
 6         }
 7 
 8         public DbSet<AccessoryInfo> Accessories { get; set; }
 9 
10         public DbSet<SystemParameterInfo> SystemParameters { get; set; }
11         public DbSet<SystemParameterDetailInfo> SystemParameterDetails { get; set; }
12     ……
13     }

大家会注意到CommonDbContext继承EntityDbContext,他是框架的数据库上下文抽象基类,继承DbContext。这个抽象类的重写OnModelCreating方法,找出当前具体实现EntityDbContext类(例如CommonDbContext)的所有DbSet属性,形成该EntityDbContext用到的所有DbSet泛型的参数类,就是AccessoryInfo、SystemParameterInfo等类。然后找出所有继承ORMapping关系映射基类EntityTypeConfiguration的子类,创建映射绑定关系。

抽象的关系映射基类EntityTypeConfiguration代码如下:

 

1     public abstract class EntityTypeConfiguration<T> where T: class
2     {
3         public void Bind(ModelBuilder modelBuilder)
4         {
5             InnerBind(modelBuilder.Entity<T>());
6         }
7 
8         protected abstract void InnerBind(EntityTypeBuilder<T> builder);
9     }

 

例如系统参数的ORMapping类就可以写成:

 

 1     /// <summary>
 2     /// 系统参数 映射信息
 3     /// </summary>
 4     public class SystemParameterMapper : EntityTypeConfiguration<SystemParameterInfo>
 5     {
 6         protected override void InnerBind(EntityTypeBuilder<SystemParameterInfo> builder)
 7         {
 8             builder.ToTable("SYSTEM_PARAMETER_INFO");
 9 
10             builder.Property(p => p.AppCode).HasColumnName("APP_CODE").IsRequired();
11             builder.Property(p => p.SystemParaCode).HasColumnName("SYSTEM_PARA_CODE").IsRequired();
12             builder.Property(p => p.SystemParaName).HasColumnName("SYSTEM_PARA_NAME").IsRequired();
13             builder.Property(p => p.SortOrder).HasColumnName("SORT_ORDER").IsRequired();
14             builder.Property(p => p.Remark).HasColumnName("REMARK");
15 
16             builder.HasKey(p => new { p.AppCode, p.SystemParaCode });
17 
18             builder.HasMany(p => p.DetailList).WithOne().HasForeignKey(f => new { f.AppCode, f.SystemParaCode }).OnDelete(DeleteBehavior.Cascade);
19         }
20     }

 

前面讲了数据库的配置说明,DbContext的具体实现和ORMapping的实现。但是在程序中如何嵌入这些内容,如何将DbContext与配置关联呢?尤其是数据库的Provider是写在配置中的,不能再在Startup中写死services.AddDbContext<BloggingContext>(options => options.UseSqlServer(connection))吧?这种写法,背离了我们使用配置方式的初衷了。

为了解决这个问题,我们写一个startup的扩展方法,将配置和DbContext等关联起来:

 

 1         public static DbContextOptionsBuilder UseDb<TContext>(this DbContextOptionsBuilder optionsBuilder, IServiceProvider serviceProvider) where TContext : DbContext
 2         {
 3             DataConfigInfo config = serviceProvider.GetService<IOptions<DataConfigInfo>>().Value;
 4 
 5             DbNameAttribute attribute = typeof(TContext).GetTypeInfo().GetCustomAttribute<DbNameAttribute>(false);
 6 
 7             ConnectionStringSettingInfo connectionStringSetting = config.ConnectionStrings.SingleOrDefault(o => o.Name == attribute.Name);
 8             ProviderSettingInfo providerSetting = config.Providers.SingleOrDefault(o => o.Name == connectionStringSetting.ProviderName);
 9 
10             Type providerType = Type.GetType(providerSetting.Type);
11 
12             DbContextOptionsBuilderProvider providerInstance = Activator.CreateInstance(providerType) as DbContextOptionsBuilderProvider;
13 
14             providerInstance.ConnectionStringSetting = connectionStringSetting;
15             providerInstance.ProviderSetting = providerSetting;
16 
17             providerInstance.Build(optionsBuilder);
18 
19             EntityDbContext.DbContexts.TryAdd(connectionStringSetting.Name, typeof(TContext));
20 
21             return optionsBuilder;
22         }

 

这个方法的主要作用是:TContext泛型参数是EntityDbContext的实现类,例如CommonDbContext。以上面介绍的数据库配置信息和CommonDbContext为例说明:

1、获取当前CommonDbContext类的DbNameAttribute,也就是MicroStrutLibrary。

2、然后获取MicroStrutLibrary数据库连接串信息

"Name": "MicroStrutLibrary",

"ConnectionString": "Data Source=XXXX;Initial Catalog=XXXX;User Id=OperUser;Password=OperUser;MultipleActiveResultSets=true;Persist Security Info=true",

"ProviderName": "System.Data.SqlClient"

3、再找出对应的DbProvider信息

"Name": "System.Data.SqlClient",

"Type": "MicroStrutLibrary.Infrastructure.Core.Data.Entity.SqlServerDbContextOptionsBuilderProvider, MicroStrutLibrary.Infrastructure.Core.Data.Entity"

4、根据DbProvider信息创建DbContextOptionsBuilderProvider类的实例,并设置属性,执行实例的Build方法。具体这个类在下面讲解。

5、将当前TContext追加到EntityDbContext基类的静态属性DbContexts字典中。这个字典主要是存放数据库的Name和TContext的对应关系。目前暂且用不到(在通用数据查询功能中用的,以后会介绍)。

 

重点来了,DbContextOptionsBuilderProvider类就是针对每种类型数据库SQL Server、MySql、Oracle等的提供程序。Build方法的参数是各种数据库类型的OptionsBuilder,这个OptionsBuilder在.net core类库中,只需要在他们的基础上封装一下即可:

 

 1     public abstract class DbContextOptionsBuilderProvider
 2     {
 3         public ProviderSettingInfo ProviderSetting { get; set; }
 4 
 5         public ConnectionStringSettingInfo ConnectionStringSetting { get; set; }
 6 
 7         public abstract void Build(DbContextOptionsBuilder optionsBuilder);
 8    }
 9 
10     public class SqlServerDbContextOptionsBuilderProvider : DbContextOptionsBuilderProvider
11     {
12         public override void Build(DbContextOptionsBuilder optionsBuilder)
13         {
14             //SQLServer 2008 R2以以下版本
15             optionsBuilder.UseSqlServer(this.ConnectionStringSetting.ConnectionString, ob => ob.UseRowNumberForPaging());
16             //SQLSever 2012以上版本
17             //optionsBuilder.UseSqlServer(this.ConnectionStringSetting.ConnectionString);
18         }
19    }

 

 

上面就是一个SQLServer的具体实现,不过有个说明的是SQLServer 2008R2及以下版本没有offset fetch next语句,只能使用row_number() over方式,因此当数据库是SQLServer 2008R2及以下版本使用optionsBuilder.UseSqlServer(this.ConnectionStringSetting.ConnectionString, ob => ob.UseRowNumberForPaging()),而SQLServer 2012以上版本使用optionsBuilder.UseSqlServer(this.ConnectionStringSetting.ConnectionString)。

还有一点说明的是SQLServer数据库使用datetime2,而不是datetime,否则转换会报错。

 

面向云的.net core开发框架目录

posted @ 2016-11-01 14:33 BenDan2002 阅读(...) 评论(...) 编辑 收藏