Adnc 源码解析

先看 Adnc.Demo.Usr.Api 解决方案

 var startAssembly = System.Reflection.Assembly.GetExecutingAssembly();
 var startAssemblyName = startAssembly.GetName().Name ?? string.Empty;
 var lastName = startAssemblyName.Split('.').Last();
 var migrationsAssemblyName = startAssemblyName.Replace($".{lastName}", ".Repository");
 var serviceInfo = ServiceInfo.CreateInstance(startAssembly, migrationsAssemblyName);

上面代码是构建 Adnc.Demo.Usr.Api 服务信息

namespace Adnc.Shared.WebApi;

public class ServiceInfo : IServiceInfo
{
    private static ServiceInfo? _instance = null;
    private static readonly object _lockObj = new();

    public string Id { get; private set; } = string.Empty;
    public string ServiceName { get; private set; } = string.Empty;
    public string CorsPolicy { get; set; } = string.Empty;
    public string ShortName { get; private set; } = string.Empty;
    public string RelativeRootPath { get; private set; } = string.Empty;
    public string Version { get; private set; } = string.Empty;
    public string Description { get; private set; } = string.Empty;
    public Assembly StartAssembly { get; private set; } = default!;
    public string MigrationsAssemblyName { get; private set; } = string.Empty;

    private ServiceInfo()
    {
    }

    public static ServiceInfo CreateInstance(Assembly startAssembly, string? migrationsAssemblyName = null)
    {
        if (_instance is not null)
            return _instance;

        lock (_lockObj)
        {
            if (_instance is not null)
                return _instance;

            if (startAssembly is null)
                startAssembly = Assembly.GetEntryAssembly() ?? throw new NullReferenceException(nameof(startAssembly));

            var attribute = startAssembly.GetCustomAttribute<AssemblyDescriptionAttribute>();
            var description = attribute is null ? string.Empty : attribute.Description;
            var version = startAssembly.GetName().Version ?? throw new NullReferenceException("startAssembly.GetName().Version");
            var startAssemblyName = startAssembly.GetName().Name ?? string.Empty;
            var serviceName = startAssemblyName.Replace(".", "-").ToLower();
            var ticks = DateTime.Now.GetTotalMilliseconds().ToLong();
            var ticksHex = Convert.ToString(ticks, 16);
            var envName = Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT")?.ToLower();
            var serviceId = envName switch
            {
                "development" => $"{serviceName}-dev-{ticksHex}",
                "test" => $"{serviceName}-test-{ticksHex}",
                "staging" => $"{serviceName}-stag-{ticksHex}",
                "production" => $"{serviceName}-{ticksHex}",
                _ => throw new NullReferenceException("ASPNETCORE_ENVIRONMENT")
            };

            var names = startAssemblyName.Split(".");
            migrationsAssemblyName ??= startAssemblyName.Replace($".{names.Last()}", ".Migrations");
            _instance = new ServiceInfo
            {
                Id = serviceId,
                ServiceName = serviceName,
                ShortName = $"{names[^2]}-{names[^1]}".ToLower(),
                RelativeRootPath = $"{names[^2]}/{names[^1]}".ToLower(),
                CorsPolicy = "default",
                StartAssembly = startAssembly,
                Description = description,
                Version = $"{version.Major}.{version.Minor}.{version.Build}.{version.Revision}",
                MigrationsAssemblyName = migrationsAssemblyName
            };
        }
        return _instance;
    }

    public static ServiceInfo GetInstance()
    {
        if (_instance is null)
            throw new NullReferenceException(nameof(ServiceInfo));

        return _instance;
    }
}

上面使用得是单例模式

注意这里的代码 public Assembly StartAssembly { get; private set; } = default!;

StartAssembly 后面需要用它反射

接下来这行代码

var app = WebApplication.CreateBuilder(args).ConfigureAdncDefault(serviceInfo).Build();

调用 ConfigureAdncDefault(serviceInfo)

这是一个扩展方法在 Adnc.Shared.WebApi 解决方案中

public static WebApplicationBuilder ConfigureAdncDefault(this WebApplicationBuilder builder, IServiceInfo serviceInfo)

{

builder.Services.AddAdnc(serviceInfo);

}

调用了 AddAdnc(serviceInfo) 扩展方法

public static class ServiceCollectionExtension
{
    /// <summary>
    ///  统一注册Adnc.WebApi通用服务
    /// </summary>
    /// <param name="services"></param>
    /// <param name="startupAssembly"></param>
    /// <returns></returns>
    /// <exception cref="ArgumentNullException"></exception>
    /// <exception cref="NullReferenceException"></exception>
    public static IServiceCollection AddAdnc(this IServiceCollection services, IServiceInfo serviceInfo)
    {
        if (serviceInfo?.StartAssembly is null)
            throw new ArgumentNullException(nameof(serviceInfo));
        var webApiRegistarType = serviceInfo.StartAssembly.ExportedTypes.FirstOrDefault(m => m.IsAssignableTo(typeof(IDependencyRegistrar)) && m.IsAssignableTo(typeof(AbstractWebApiDependencyRegistrar)) && m.IsNotAbstractClass(true));
        if (webApiRegistarType is null)
            throw new NullReferenceException(nameof(IDependencyRegistrar));

        if (Activator.CreateInstance(webApiRegistarType, services) is not IDependencyRegistrar webapiRegistar)
            throw new NullReferenceException(nameof(webapiRegistar));

        webapiRegistar.AddAdnc();

        return services;
    }
}

上面红色代码 serviceInfo.StartAssembly 通过他反射

创建了子类 Activator.CreateInstance(webApiRegistarType, services) is not IDependencyRegistrar webapiRegistar

子类也就是 Adnc.Demo.Usr.Api 解决方法中得 UsrWebApiDependencyRegistrar

using Adnc.Demo.Usr.Api.Authentication;
using Adnc.Demo.Usr.Api.Authorization;
using Adnc.Shared.WebApi.Registrar;

namespace Adnc.Demo.Usr.Api;

public sealed class UsrWebApiDependencyRegistrar : AbstractWebApiDependencyRegistrar
{
   
    public UsrWebApiDependencyRegistrar(IServiceCollection services)
        : base(services)
    {
    }

    public UsrWebApiDependencyRegistrar(IApplicationBuilder app)
        : base(app)
    {
    }

    public override void AddAdnc()
    {
        AddWebApiDefault<BearerAuthenticationLocalProcessor, PermissionLocalHandler>();
        AddHealthChecks(true, true, true, false);
        Services.AddGrpc();
    }

    public override void UseAdnc()
    {
        UseWebApiDefault(endpointRoute: endpoint =>
        {
            endpoint.MapGrpcService<Grpc.AuthGrpcServer>();
            endpoint.MapGrpcService<Grpc.UsrGrpcServer>();
        });
    }
}

子类重写了父类得 AddAdnc() 方法调用了父类AbstractWebApiDependencyRegistrar 中得 AddWebApiDefault<BearerAuthenticationLocalProcessor, PermissionLocalHandler>(); 方法也就是

 /// <summary>
 /// 注册Webapi通用的服务
 /// </summary>
 /// <typeparam name="TAuthenticationProcessor"><see cref="AbstractAuthenticationProcessor"/></typeparam>
 /// <typeparam name="TAuthorizationHandler"><see cref="AbstractPermissionHandler"/></typeparam>
 protected virtual void AddWebApiDefault<TAuthenticationProcessor, TAuthorizationHandler>()
     where TAuthenticationProcessor : AbstractAuthenticationProcessor
     where TAuthorizationHandler : AbstractPermissionHandler
 {

     Services.AddControllers();
   

     Services
         .AddHttpContextAccessor()
         .AddMemoryCache();
     Configure();
     AddControllers();
     AddAuthentication<TAuthenticationProcessor>();
     AddAuthorization<TAuthorizationHandler>();
     AddCors();
     var enableSwaggerUI = Configuration.GetValue(NodeConsts.SwaggerUI_Enable, true);
     if(enableSwaggerUI)
     {
         AddSwaggerGen();
         AddMiniProfiler();
     }
     AddApplicationServices();
 }

父类中的方法调用了 AddApplicationServices(); 方法

这个方法

namespace Adnc.Shared.WebApi.Registrar;

public abstract partial class AbstractWebApiDependencyRegistrar
{
    /// <summary>
    /// 注册Application层服务
    /// </summary>
    protected virtual void AddApplicationServices()
    {
 
        var appAssembly = ServiceInfo.GetApplicationAssembly();
       
        if (appAssembly is not null)
        {
            var applicationRegistrarType = appAssembly.ExportedTypes.FirstOrDefault(m => m.IsAssignableTo(typeof(IDependencyRegistrar)) && !m.IsAssignableTo(typeof(AbstractWebApiDependencyRegistrar)) && m.IsNotAbstractClass(true));
            if (applicationRegistrarType is not null)
            {
                var applicationRegistrar = Activator.CreateInstance(applicationRegistrarType, Services) as IDependencyRegistrar;
                applicationRegistrar?.AddAdnc();
            }
        }
    }
}

这段代码 ServiceInfo.GetApplicationAssembly(); 获取了 Adnc.Shared.Application 程序集

using Adnc.Infra.Consul.Configuration;

namespace Adnc.Shared.WebApi
{
    public static class ServiceInfoExtension
    {
        private static readonly object lockObj = new();
        private static Assembly? appAssembly;

        /// <summary>
        /// 获取WebApiAssembly程序集
        /// </summary>
        /// <returns></returns>
        public static Assembly GetWebApiAssembly(this IServiceInfo serviceInfo) => serviceInfo.StartAssembly;

        /// <summary>
        /// 获取Application程序集
        /// </summary>
        /// <returns></returns>
        public static Assembly GetApplicationAssembly(this IServiceInfo serviceInfo)
        {
            if (appAssembly is null)
            {
                lock (lockObj)
                {
                    if (appAssembly is null)
                    {
                        Assembly startAssembly = serviceInfo.StartAssembly ?? throw new NullReferenceException(nameof(serviceInfo.StartAssembly));
                        string startAssemblyFullName = startAssembly.FullName ?? throw new NullReferenceException(nameof(startAssembly.FullName));
                        string startAssemblyName = startAssembly.GetName().Name ?? string.Empty;
                        string lastName = startAssemblyName.Split(".").Last();
                        string appAssemblyFullName = startAssemblyFullName.Replace($".{lastName}", ".Application");
                        appAssembly = AppDomain.CurrentDomain.GetAssemblies().FirstOrDefault(x => x.FullName == appAssemblyFullName);
                        if (appAssembly is null)
                        {
                            appAssembly = startAssembly;
                            //appAssembly = Assembly.Load(appAssemblyName);
                            //var appAssemblyPath = serviceInfo.AssemblyLocation.Replace(".WebApi.dll", ".Application.dll");
                            ///appAssembly = Assembly.LoadFrom(appAssemblyPath);
                        }
                    }
                }
            }
            return appAssembly;
        }

        /// <summary>
        /// 获取导航首页内容
        /// </summary>
        /// <param name="serviceInfo"></param>
        /// <param name="app"></param>
        /// <returns></returns>
        public static string GetDefaultPageContent(this IServiceInfo serviceInfo, IServiceProvider serviceProvider)
        {
            var swaggerUrl = $"/{serviceInfo.RelativeRootPath}/index.html";
            var consulOptions = serviceProvider.GetRequiredService<IOptions<ConsulOptions>>();
            var healthCheckUrl = consulOptions?.Value?.HealthCheckUrl ?? $"/{serviceInfo.RelativeRootPath}/health-24b01005-a76a-4b3b-8fb1-5e0f2e9564fb";
            var envName = Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT");
            var content = $"<div align='center'><a href='https://github.com/alphayu/adnc' target='_blank'><img src='https://aspdotnetcore.net/wp-content/uploads/2023/04/adnc-topics.png'/></a><br>" +
                $"ASPNETCORE_ENVIRONMENT = {envName} <br> " +
                $"Version = {serviceInfo.Version} <br> " +
                $"ServiceName = {serviceInfo.ServiceName} <br> " +
                $"ShortName = {serviceInfo.ShortName} <br> " +
                $"RelativeRootPath = {serviceInfo.RelativeRootPath} <br> " +
                $"<br><a href='{swaggerUrl}'>swagger UI</a> | <a href='{healthCheckUrl}'>healthy checking</a><br>" +
                $"<br>{DateTime.Now}</div>";
            return content;
        }
    }
}

这段代码

 string appAssemblyFullName = startAssemblyFullName.Replace($".{lastName}", ".Application");
 appAssembly = AppDomain.CurrentDomain.GetAssemblies().FirstOrDefault(x => x.FullName == appAssemblyFullName);
是获取 Adnc.Shared.Application 程序集

这个方法通过反射构造了 DependencyRegistrar 对象强调一下这是是对 Adnc.Demo.Usr.Application 中的 DependencyRegistrar 构造对象

namespace Adnc.Demo.Usr.Application;

public sealed class DependencyRegistrar : AbstractApplicationDependencyRegistrar
{
    public override Assembly ApplicationLayerAssembly => Assembly.GetExecutingAssembly();

    public override Assembly ContractsLayerAssembly => typeof(IUserAppService).Assembly;

    public override Assembly RepositoryOrDomainLayerAssembly => typeof(EntityInfo).Assembly;

    public DependencyRegistrar(IServiceCollection services) : base(services)
    {
    }

    public override void AddAdnc() => AddApplicaitonDefault();
}

Adnc.Demo.Usr.Application 解决方案 DependencyRegistrar 类 重写了 父类方法

public override void AddAdnc() => AddApplicaitonDefault();

该方法  AddApplicaitonDefault() 在 Adnc.Shared.Application 解决方案

/// <summary>
/// 注册adnc.application通用服务
/// </summary>
protected virtual void AddApplicaitonDefault()
{
    Services
        .AddValidatorsFromAssembly(ContractsLayerAssembly, ServiceLifetime.Scoped)
        .AddAdncInfraAutoMapper(ApplicationLayerAssembly)
        .AddAdncInfraYitterIdGenerater(RedisSection)
        .AddAdncInfraConsul(ConsulSection)
        .AddAdncInfraDapper();

    AddApplicationSharedServices();
    AddAppliactionSerivcesWithInterceptors();
    AddApplicaitonHostedServices();
    AddEfCoreContextWithRepositories();
    AddMongoContextWithRepositries();
    AddRedisCaching();
    AddBloomFilters();
}

这里说明 AddEfCoreContextWithRepositories(); 这个方法是注册 EF

using Adnc.Infra.Repository.EfCore.MySql.Configurations;
using Adnc.Infra.Repository.Mongo;
using Adnc.Infra.Repository.Mongo.Configuration;
using Adnc.Infra.Repository.Mongo.Extensions;
using Microsoft.EntityFrameworkCore;

namespace Adnc.Shared.Application.Registrar;

public abstract partial class AbstractApplicationDependencyRegistrar
{
    /// <summary>
    /// 注册EFCoreContext与仓储
    /// </summary>
    protected virtual void AddEfCoreContextWithRepositories()
    {
        var serviceType = typeof(IEntityInfo);
        var implType = RepositoryOrDomainLayerAssembly.ExportedTypes.FirstOrDefault(type => type.IsAssignableTo(serviceType) && type.IsNotAbstractClass(true));
        if (implType is null)
            throw new NotImplementedException(nameof(IEntityInfo));
        else
            Services.AddScoped(serviceType, implType);

        AddEfCoreContext();
    }

    /// <summary>
    /// 注册EFCoreContext
    /// </summary>
    protected virtual void AddEfCoreContext()
    {
        var serviceInfo = Services.GetServiceInfo();
        var mysqlConfig = MysqlSection.Get<MysqlOptions>();
        var serverVersion = new MariaDbServerVersion(new Version(10, 5, 4));
        Services.AddAdncInfraEfCoreMySql(options =>
        {
            options.UseLowerCaseNamingConvention();
            options.UseMySql(mysqlConfig.ConnectionString, serverVersion, optionsBuilder =>
            {
                optionsBuilder.MinBatchSize(4)
                                        .MigrationsAssembly(serviceInfo.MigrationsAssemblyName)
                                        .UseQuerySplittingBehavior(QuerySplittingBehavior.SplitQuery);
            });

            //if (this.IsDevelopment())
            //{
            //    //options.AddInterceptors(new DefaultDbCommandInterceptor())
            //    options.LogTo(Console.WriteLine, LogLevel.Information)
            //                .EnableSensitiveDataLogging()
            //                .EnableDetailedErrors();
            //}
            //替换默认查询sql生成器,如果通过mycat中间件实现读写分离需要替换默认SQL工厂。
            //options.ReplaceService<IQuerySqlGeneratorFactory, AdncMySqlQuerySqlGeneratorFactory>();
        });
    }

    /// <summary>
    /// 注册MongoContext与仓储
    /// </summary>
    protected virtual void AddMongoContextWithRepositries(Action<IServiceCollection>? action = null)
    {
        action?.Invoke(Services);

        var mongoConfig = MongoDbSection.Get<MongoOptions>();
        Services.AddAdncInfraMongo<MongoContext>(options =>
        {
            options.ConnectionString = mongoConfig.ConnectionString;
            options.PluralizeCollectionNames = mongoConfig.PluralizeCollectionNames;
            options.CollectionNamingConvention = (NamingConvention)mongoConfig.CollectionNamingConvention;
        });
    }
}

其中 Services.AddAdncInfraEfCoreMySql扩展方法调用得是 Adnc.Infra.Repository.EfCore.MySql 解决方案注册了仓储这里

using Adnc.Infra.Repository.EfCore.MySql;
using Adnc.Infra.Repository.EfCore.MySql.Transaction;

namespace Microsoft.Extensions.DependencyInjection;

public static class ServiceCollectionExtension
{
    public static IServiceCollection AddAdncInfraEfCoreMySql(this IServiceCollection services, Action<DbContextOptionsBuilder> optionsBuilder)
    {
        if (services.HasRegistered(nameof(AddAdncInfraEfCoreMySql)))
            return services;

        services.TryAddScoped<IUnitOfWork, MySqlUnitOfWork<MySqlDbContext>>();
        services.TryAddScoped(typeof(IEfRepository<>), typeof(EfRepository<>));
        services.TryAddScoped(typeof(IEfBasicRepository<>), typeof(EfBasicRepository<>));
        services.AddDbContext<DbContext, MySqlDbContext>(optionsBuilder);

        return services;
    }
}

这篇分析了

Adnc.Demo.Usr.Api -----(ConfigureAdncDefault(serviceInfo))---------> Adnc.Shared.WebApi -------- AddAdnc 反射获取子类子类重写 AddAdnc 调用了父类

AddWebApiDefault.AddApplicationServices 反射出 Adnc.Shared.Application------->

Adnc.Shared.Application ----- (AbstractApplicationDependencyRegistrar.AddApplicaitonDefault.AddEfCoreContextWithRepositories) ----->

Adnc.Infra.Repository.EfCore.MySql

就是依次往上调用

posted on 2024-07-12 12:27 是水饺不是水饺阅读(87) 评论(0) 收藏举报

刷新页面返回顶部

是水饺不是水饺

Adnc 源码解析

导航

公告