using DotNetCore.CAP; using LINGYUN.Abp.Dapr.Client.ClientProxying; using LINGYUN.Abp.Dapr.Client.DynamicProxying; using LINGYUN.Abp.ExceptionHandling; using LINGYUN.Abp.ExceptionHandling.Emailing; using LINGYUN.Abp.Localization.CultureMap; using LINGYUN.Abp.Localization.Persistence; using LINGYUN.Abp.Serilog.Enrichers.Application; using LINGYUN.Abp.Serilog.Enrichers.UniqueId; using LINGYUN.Abp.Wrapper; using Medallion.Threading; using Medallion.Threading.Redis; using Microsoft.AspNetCore.Authentication.JwtBearer; using Microsoft.AspNetCore.DataProtection; using Microsoft.Extensions.Caching.StackExchangeRedis; using Microsoft.Extensions.Configuration; using Microsoft.Extensions.DependencyInjection; using Microsoft.Extensions.Options; using Microsoft.OpenApi.Models; using OpenTelemetry.Metrics; using OpenTelemetry.Resources; using OpenTelemetry.Trace; using PackageName.CompanyName.ProjectName.Localization; using StackExchange.Redis; using System; using System.Collections.Generic; using System.Text.Encodings.Web; using System.Text.Unicode; using Volo.Abp; using Volo.Abp.Auditing; using Volo.Abp.Caching; using Volo.Abp.EntityFrameworkCore; using Volo.Abp.GlobalFeatures; using Volo.Abp.Http.Client; using Volo.Abp.Json; using Volo.Abp.Json.SystemTextJson; using Volo.Abp.Localization; using Volo.Abp.MultiTenancy; using Volo.Abp.Threading; using Volo.Abp.VirtualFileSystem; using static IdentityModel.ClaimComparer; namespace PackageName.CompanyName.ProjectName; public partial class ProjectNameHttpApiHostModule { protected const string ApplicationName = "ProjectName"; private static readonly OneTimeRunner OneTimeRunner = new(); private void PreConfigureFeature() { OneTimeRunner.Run(() => { GlobalFeatureManager.Instance.Modules.Editions().EnableAll(); }); } private void PreConfigureApp() { AbpSerilogEnrichersConsts.ApplicationName = ApplicationName; PreConfigure(options => { // 以开放端口区别 options.SnowflakeIdOptions.WorkerId = 5; options.SnowflakeIdOptions.WorkerIdBits = 5; options.SnowflakeIdOptions.DatacenterId = 1; }); } private void PreConfigureCAP(IConfiguration configuration) { PreConfigure(options => { options #if MySQL .UseMySql(sqlOptions => { configuration.GetSection("CAP:MySql").Bind(sqlOptions); }) #elif SqlServer .UseSqlServer(sqlOptions => { configuration.GetSection("CAP:SqlServer").Bind(sqlOptions); }) #elif Sqlite .UseSqlite(sqlOptions => { configuration.GetSection("CAP:Sqlite").Bind(sqlOptions); }) #elif Oracle || OracleDevart .UseOracle(sqlOptions => { configuration.GetSection("CAP:Oracle").Bind(sqlOptions); }) #elif PostgreSql .UsePostgreSql(sqlOptions => { configuration.GetSection("CAP:PostgreSql").Bind(sqlOptions); }) #endif .UseRabbitMQ(rabbitMQOptions => { configuration.GetSection("CAP:RabbitMQ").Bind(rabbitMQOptions); }) .UseDashboard(); }); } private void ConfigureJsonSerializer(IConfiguration configuration) { // 统一时间日期格式 Configure(options => { var jsonConfiguration = configuration.GetSection("Json"); if (jsonConfiguration.Exists()) { jsonConfiguration.Bind(options); } }); // 中文序列化的编码问题 Configure(options => { options.JsonSerializerOptions.Encoder = JavaScriptEncoder.Create(UnicodeRanges.All); }); } private void ConfigureDistributedLock(IServiceCollection services, IConfiguration configuration) { var distributedLockEnabled = configuration["Redis:IsEnabled"]; if (distributedLockEnabled.IsNullOrEmpty() || bool.Parse(distributedLockEnabled)) { var redis = ConnectionMultiplexer.Connect(configuration["DistributedLock:Redis:Configuration"]); services.AddSingleton(_ => new RedisDistributedSynchronizationProvider(redis.GetDatabase())); } } private void ConfigureOpenTelemetry(IServiceCollection services, IConfiguration configuration) { var openTelemetryEnabled = configuration["OpenTelemetry:IsEnabled"]; if (openTelemetryEnabled.IsNullOrEmpty() || bool.Parse(openTelemetryEnabled)) { services.AddOpenTelemetry() .ConfigureResource(builder => { builder.AddService(ApplicationName); }) .WithTracing(builder => { builder.AddHttpClientInstrumentation(); builder.AddAspNetCoreInstrumentation(); builder.AddCapInstrumentation(); builder.AddEntityFrameworkCoreInstrumentation(); builder.AddZipkinExporter(zipKinOptions => { var endpoint = configuration["OpenTelemetry:ZipKin:Endpoint"]; if (!endpoint.IsNullOrWhiteSpace()) { zipKinOptions.Endpoint = new Uri(configuration["OpenTelemetry:ZipKin:Endpoint"]); } }); }) .WithMetrics(builder => { builder.AddHttpClientInstrumentation(); builder.AddAspNetCoreInstrumentation(); }); } } private void ConfigureExceptionHandling() { // 自定义需要处理的异常 Configure(options => { // 加入需要处理的异常类型 options.Handlers.Add(); options.Handlers.Add(); options.Handlers.Add(); options.Handlers.Add(); options.Handlers.Add(); options.Handlers.Add(); }); // 自定义需要发送邮件通知的异常类型 Configure(options => { // 是否发送堆栈信息 options.SendStackTrace = true; // 未指定异常接收者的默认接收邮件 // 指定自己的邮件地址 }); } private void ConfigureAuditing(IConfiguration configuration) { Configure(options => { options.ApplicationName = ApplicationName; // 是否启用实体变更记录 var allEntitiesSelectorIsEnabled = configuration["Auditing:AllEntitiesSelector"]; if (allEntitiesSelectorIsEnabled.IsNullOrWhiteSpace() || (bool.TryParse(allEntitiesSelectorIsEnabled, out var enabled) && enabled)) { options.EntityHistorySelectors.AddAllEntities(); } }); } private void ConfigureCaching(IConfiguration configuration) { Configure(options => { configuration.GetSection("DistributedCache").Bind(options); }); Configure(options => { var redisConfig = ConfigurationOptions.Parse(options.Configuration); options.ConfigurationOptions = redisConfig; options.InstanceName = configuration["Redis:InstanceName"]; }); } private void ConfigureVirtualFileSystem() { Configure(options => { options.FileSets.AddEmbedded("PackageName.CompanyName.ProjectName"); }); } private void ConfigureMultiTenancy(IConfiguration configuration) { // 多租户 Configure(options => { options.IsEnabled = true; }); var tenantResolveCfg = configuration.GetSection("App:Domains"); if (tenantResolveCfg.Exists()) { Configure(options => { var domains = tenantResolveCfg.Get(); foreach (var domain in domains) { options.AddDomainTenantResolver(domain); } }); } } private void ConfigureSwagger(IServiceCollection services) { // Swagger services.AddSwaggerGen( options => { options.SwaggerDoc("v1", new OpenApiInfo { Title = "ProjectName API", Version = "v1" }); options.DocInclusionPredicate((docName, description) => true); options.CustomSchemaIds(type => type.FullName); options.AddSecurityDefinition("Bearer", new OpenApiSecurityScheme { Description = "JWT Authorization header using the Bearer scheme. Example: \"Authorization: Bearer {token}\"", Name = "Authorization", In = ParameterLocation.Header, Scheme = "bearer", Type = SecuritySchemeType.Http, BearerFormat = "JWT" }); options.AddSecurityRequirement(new OpenApiSecurityRequirement { { new OpenApiSecurityScheme { Reference = new OpenApiReference { Type = ReferenceType.SecurityScheme, Id = "Bearer" } }, new string[] { } } }); options.OperationFilter(); }); } private void ConfigureLocalization() { // 支持本地化语言类型 Configure(options => { options.Languages.Add(new LanguageInfo("en", "en", "English")); options.Languages.Add(new LanguageInfo("zh-Hans", "zh-Hans", "简体中文")); }); Configure(options => { // 持久化本地化资源 options.SaveStaticLocalizationsToPersistence = true; options.AddPersistenceResource(); }); Configure(options => { var zhHansCultureMapInfo = new CultureMapInfo { TargetCulture = "zh-Hans", SourceCultures = new string[] { "zh", "zh_CN", "zh-CN" } }; options.CulturesMaps.Add(zhHansCultureMapInfo); options.UiCulturesMaps.Add(zhHansCultureMapInfo); }); } private void ConfigureSecurity(IServiceCollection services, IConfiguration configuration, bool isDevelopment = false) { services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme) .AddJwtBearer(options => { options.Authority = configuration["AuthServer:Authority"]; options.Audience = configuration["AuthServer:ApiName"]; options.RequireHttpsMetadata = Convert.ToBoolean(configuration["AuthServer:RequireHttpsMetadata"]); options.MapInboundClaims = Convert.ToBoolean(configuration["AuthServer:MapInboundClaims"]); }); if (!isDevelopment) { var redis = ConnectionMultiplexer.Connect(configuration["Redis:Configuration"]); services .AddDataProtection() .SetApplicationName("LINGYUN.Abp.Application") .PersistKeysToStackExchangeRedis(redis, "LINGYUN.Abp.Application:DataProtection:Protection-Keys"); } } private void ConfigureWrapper() { Configure(options => { // 取消注释包装结果 // options.IsEnabled = true; }); Configure(options => { // http服务间调用发送不需要包装结果的请求头 options.ProxyClientBuildActions.Add( (_, builder) => { builder.ConfigureHttpClient((provider, client) => { var wrapperOptions = provider.GetRequiredService>(); var wrapperHeader = wrapperOptions.Value.IsEnabled ? AbpHttpWrapConsts.AbpWrapResult : AbpHttpWrapConsts.AbpDontWrapResult; client.DefaultRequestHeaders.TryAddWithoutValidation(wrapperHeader, "true"); }); }); }); Configure(options => { // dapr服务间调用发送不需要包装结果的请求头 options.ProxyRequestActions.Add( (appId, httpRequestMessage) => { httpRequestMessage.Headers.TryAddWithoutValidation(AbpHttpWrapConsts.AbpDontWrapResult, "true"); }); }); } }