在 ASP.NET Core 应用程序启动时运行代码的 3 种方法

开发人员应该将初始化内存缓存的代码放在哪里?

开发人员可能会发现有必要在 ASP.NET Core 应用程序启动时只执行一次代码。例如,开发人员可能需要填充内存缓存、运行后台任务、从某些外部源读取配置、发布应用程序成功启动的事件等。

ASP.NET Core 为开发人员提供了几种不同的方式来实现这一目标,但它们并不等同,开发人员在做出最终选择之前应仔细分析。

直接从ProgramStartup运行代码

在应用程序启动时只执行一次代码的最明显和最直接的方法可能是将该代码直接放入 Program 类的 Main 方法或 Startup 类的 Configure 方法中。 ASP.NET Core 确保这些方法以及放置在其中的代码仅在应用程序启动时执行。

//"Main" method
public static void Main(string[] args)
{
    var host = CreateHostBuilder(args).Build();
    //Startup logic here
    host.Run();
}

//"Configure" method
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }
    app.UseHttpsRedirection();
    //...
    //Startup logic here
}

开发人员可以根据具体情况选择两种方式之一来放置启动逻辑。例如,如果启动逻辑只应在配置请求处理管道后运行,则开发人员应将其放在 Configure 方法的末尾,而不是在创建 IHost 对象之后。

将逻辑放在 Main(或在极少数情况下的 Configure 方法)中的主要优点是可以在应用程序开始服务 Web 请求之前执行启动逻辑,这对于初始化内存缓存或读取配置等任务很重要。

从托管服务运行代码

ASP.NET Core 为开发人员提供了一个 IHostedService 接口,该接口具有在应用程序启动和停止时执行的 StartAsyncStopAsync 方法。此接口通常用于触发长时间运行的后台任务,但 StartAsync 本身必须快速返回,以免阻塞其他托管服务(如果有)。

//Define your hosted service with startup logic
public class MyHostedService : IHostedService
{
    public async Task StartAsync(CancellationToken cancellationToken)
    {
        //Startup logic here
    }

    public async Task StopAsync(CancellationToken cancellationToken)
    {
        //Cleanup logic here
    }
}

//Register hosted service 
public void ConfigureServices(IServiceCollection services)
{
    services.AddHostedService<MyHostedService>();
}

此外,最好知道 StartAsync 方法在配置应用程序的请求管道之前运行(在执行 Configure 方法之前)。当启动逻辑仅在应用程序的请求管道配置后才需要运行时,这可能是一个问题。

订阅 IHostApplicationLifetime 事件

另一个 ASP.NET Core 接口 IHostApplicationLifetime 允许开发人员将其处理程序订阅到 ApplicationStarted、ApplicationStoppingApplicationStopped 事件:

public void Configure(
      IApplicationBuilder app, 
      IWebHostEnvironment env, 
      IHostApplicationLifetime appLifetime)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }

    //...

    appLifetime.ApplicationStarted.Register(OnStarted);
    appLifetime.ApplicationStopping.Register(OnStopping);
    appLifetime.ApplicationStopped.Register(OnStopped);
}

private void OnStarted()
{
    //"On-started" logic
}

private void OnStopping()
{
    //"On-stopping" logic
}

private void OnStopped()
{
    //"On-stopped" logic
}

需要注意的是,OnStarted 事件仅在应用程序主机完全启动后发布,即在服务和请求处理管道已配置并且应用程序已开始服务 Web 请求之后。这意味着如果需要在应用程序开始服务 Web 请求之前执行某些启动逻辑,则生命周期事件将不是一个选择。

总结

  • 在应用程序开始服务 Web 请求之前,所有类型的启动任务都可以直接从 ProgramStartup 类执行。
  • 长时间运行的后台任务应该由托管服务启动和停止。
  • 开发者可以使用 IHostApplicationLifetime 接口订阅 OnStarted事件,该事件在应用宿主完全配置并启动后发布。
  • 1
    点赞
  • 4
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
在IIS上部署ASP.NET Core Web API项目及Swagger可以按照以下步骤进行: 1. 首先,我们需要确保已经在本地系统上安装了ASP.NET Core Runtime和ASP.NET Core Hosting Bundle,以便在IIS中运行ASP.NET Core应用程序。 2. 在Visual Studio中,打开你的ASP.NET Core Web API项目。确保项目已经设置为IIS Express作为本地开发服务器。 3. 在项目根目录下的`Properties`文件夹中找到`launchsettings.json`文件,检查并确保该文件中已经配置了`applicationUrl`为`http://localhost:{port}/`,其中`port`为你希望的端口号。 4. 在Visual Studio的顶部菜单中,找到 `Build` -> `Publish {YourProjectName}`,选择发布目标为`Folder`,点击 `Publish`。 5. 在弹出的窗口中选择一个输出文件夹,用于存储发布项目的文件。 6. 打开发布文件夹,在该文件夹中应该有一个名为`web.config`的文件。双击打开该文件,确保其中有以下代码片段: ```xml <aspNetCore processPath="dotnet" arguments=".\{YourProjectName}.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" forwardWindowsAuthToken="false" /> ``` 7. 打开IIS管理器,右键点击`Sites`节点,选择`Add Website`。填写网站名称以及物理路径为刚刚发布项目的目录。 8. 对于应用程序池,选择一个合适的.NET CLR版本和托管管道模式(例如:.NET CLR版本为No Managed Code,托管管道模式为集成)。 9. 在网站的右侧,找到`Authentication`,禁用匿名身份验证并启用Windows身份验证。 10. 重新启动IIS。 11. 现在,我们可以在浏览器中访问`http://localhost:{port}`,应该能够看到你的ASP.NET Core Web API已经在IIS上成功部署。 12. 最后,要在部署的项目中添加Swagger,可以通过NuGet包管理器,添加`Swashbuckle.AspNetCore`包。 13. 在`Startup.cs`文件的`ConfigureServices`方法中,添加以下配置: ```csharp services.AddSwaggerGen(c => { c.SwaggerDoc("v1", new OpenApiInfo { Title = "API", Version = "v1" }); }); ``` 14. 在`Startup.cs`文件的`Configure`方法中,添加以下代码: ```csharp app.UseSwagger(); app.UseSwaggerUI(c => { c.SwaggerEndpoint("/swagger/v1/swagger.json", "API v1"); }); ``` 15. 重新发布并重新启动IIS,现在你的ASP.NET Core Web API应该在IIS上部署并且通过Swagger可以浏览和调用你的API接口。 以上就是在IIS上部署ASP.NET Core Web API项目及Swagger的步骤。请注意,确保按照正确的顺序执行每一步,并根据自己的项目配置进行调整。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值