services.AddCors(options => {
options.AddPolicy("CorsPolicy", builder => builder.AllowAnyOrigin()
如果您将 Swagger 用于 API 文档，请更改以下粗体文本：
来自：
{
c.SwaggerDoc("v1", new Info {
Title = "Your API Title",
Version = "API Version Number",
Description = "Description of your API"
});
c.AddSecurityDefinition("Bearer", new ApiKeyScheme {
In = "header",
Description = "Please enter JWT with Bearer into field",
Name = "Authorization",
Type = "apiKey"
});
c.AddSecurityRequirement(new Dictionary < string, IEnumerable < string >> {
{
"Bearer",
Enumerable.Empty < string > ()
},
});
c.CustomSchemaIds(i => i.FullName);
c.OperationFilter < SwaggerParametersFilter > ();
到：
services.AddSwaggerGen(c => {
c.SwaggerDoc("v1", new OpenApiInfo {
Title = " Your API Title ",
Version = "API Version Number",
Description = "Description of your API "
});
c.AddSecurityDefinition("Bearer", new OpenApiSecurityScheme {
Description = "Please enter JWT with Bearer into field”
Name = "Authorization",
In = ParameterLocation.Header,
Type = SecuritySchemeType.ApiKey,
Scheme = "Bearer"
});
c.AddSecurityRequirement(new OpenApiSecurityRequirement() {
{
new OpenApiSecurityScheme {
Reference = new OpenApiReference {
Type = ReferenceType.SecurityScheme,
Id = "Bearer"
},
Scheme = "oauth2",
Name = "Bearer",
In = ParameterLocation.Header,
},
new List < string > ()
}
});
c.CustomSchemaIds(i => i.FullName);
c.OperationFilter < SwaggerParametersFilter > ();
我将在 #6 中介绍 SwaggerParametersFilter。
在 Startup.cs 的配置方法中
将 IHostingEnvironment 替换为 IWebHostEnvironment HostingEnviorment现在已过时，它将从 .net 核心的未来版本中删除。它被注入控制器并提供应用程序网络托管环境的信息。
从：
public void Configure(IApplicationBuilder app, IHostingEnvironment env, IServiceProvider services)
到：
public void Configure(IApplicationBuilder app, IWebHostEnvironment env, IServiceProvider services)
使用 #4.d 中定义的 CORS 策略名称，而不是在此处定义规则：
从：
app.UseCors(builder => builder.WithOrigins( "*" )
到：
app.UseCors( "CorsPolicy" );
这里 CorsPolicy 是 cors 策略的名称。
将 app.UseMvc() 替换为EndPoint Routing，如下所示，
从：
app.UseMvc();
到：
app.UseRouting();
app.UseEndpoints(endpoints => {
endpoints.MapDefaultControllerRoute();
endpoints.MapControllerRoute("default", "{controller=Home}/{action=Index}/{id?}");
});
在 .NET Core 中，EndPoint路由是引入的新功能，它在您的请求管道的中间件中提供路由信息。
所以，AddMVC和EndPoint路由的区别在于，AddMVC在你的请求管道的中间件完成后提供路由信息，所以我们中间件中没有路由信息。在端点路由中，我们正在配置它并将其放入中间件请求管道中。
如果您使用 Swagger 操作过滤器在所有操作方法或端点上全局应用某些逻辑，请更改下面的粗体文本：
从：
public class SwaggerParametersFilter: IOperationFilter {
public void Apply(Operation operation, OperationFilterContext context) {
if (operation.Parameters == null) operation.Parameters = new List < IParameter > ();
operation.Parameters.Add(new NonBodyParameter {
Name = "HeaderName",
In = "header",
Type = "string",
Required = true
});
到：
public class SwaggerParametersFilter: IOperationFilter {
public void Apply(OpenApiOperation operation, OperationFilterContext context) {
if (operation.Parameters == null) operation.Parameters = new List < OpenApiParameter > ();
operation.Parameters.Add(new OpenApiParameter {
Name = " HeaderName",
In = ParameterLocation.Header,
Required = true
});
如果您使用的是带有 Kestrel 的无状态服务，那么在 CreateServiceInstanceListeners 方法中，如果您使用的是listenOptions.NoDelay =true; （为了提高效率，它使用了在 #3.c 部分中介绍的 Nagle）
从：
return new WebHostBuilder().UseKestrel(opt => {
int Httpsport = serviceContext.CodePackageActivationContext.GetEndpoint("1HttpsEndpoint").Port;
opt.Listen(IPAddress.IPv6Any, Httpsport, listenOptions => {
listenOptions.UseHttps(GetCertificateFromStore());
listenOptions.NoDelay = true;
});
到（去掉蓝色粗体，添加如下配置“UseLibuv ” ），
return new WebHostBuilder().UseKestrel(opt => {
int Httpsport = serviceContext.CodePackageActivationContext.GetEndpoint("1HttpsEndpoint").Port;
opt.Listen(IPAddress.IPv6Any, Httpsport, listenOptions => {
listenOptions.UseHttps(GetCertificateFromStore());
});
}).UseLibuv(opts => {
opts.NoDelay = true;
})
如果您使用 Service Fabric 托管 API/微服务，请使用最新版本更新 Service Fabric 群集。
结论
我试图涵盖人们通常在 API 实现中使用的几乎所有基本内容。好消息是 .NET Core 3.1 有长期支持（直到 2022 年 12 月 3 日）。
感谢您阅读这篇文章！
