ABP框架系列之二十九：(Hangfire-Integration-延迟集成)

Introduction

Hangfire is a compherensive background job manager. You can integrate ASP.NET Boilerplate with Hangfire to use it instead of default background job manager. You can use the same background job API for Hangfire. Thus, your code will be independent of Hangfire. But, if you like, you can directly use Hangfire's API also.

迟发性是一个综合的后台作业管理。你可以将ASP.NET样板与迟发性来代替默认的背景作业管理器。你可以使用相同的背景工作API为迟发性。因此，您的代码将被独立的迟发。但是，如果你喜欢，你可以直接使用API迟发的。

Hangfire Integration depends on the frameworks you are using.

ASP.NET Core Integration

Abp.HangFire.AspNetCore package is used to integrate to ASP.NET Core based applications. It depends on Hangfire.AspNetCore. This document describes to install hangfire to an ASP.NET Core project. It's similar for ABP based projects too. First install Abp.HangFire.AspNetCore package to your web project:

Install-Package Abp.HangFire.AspNetCore

Then you can install any storage for Hangfire. Most common one is SQL Server storage (see Hangfire.SqlServer nuget package). After you installed these nuget packages, you can configure your project to use Hangfire.

First, we are changing Startup class to add Hangfire to dependency injection and configure storage and connection string in the ConfigureServices method:

services.AddHangfire(config =>
{
    config.UseSqlServerStorage(_appConfiguration.GetConnectionString("Default"));
});

Then we can add UseHangfireServer call in the Configure method:

app.UseHangfireServer();

If you want to use hangfire's dashboard, you can add it too:

如果你想用迟发的仪表盘

app.UseHangfireDashboard();

If you want to authorize the dashboard, you can use AbpHangfireAuthorizationFilter as shown below:

app.UseHangfireDashboard("/hangfire", new DashboardOptions
{
    Authorization = new[] { new AbpHangfireAuthorizationFilter("MyHangFireDashboardPermissionName") }
});

The configuration above is almost standard to integrate hangfire to an ASP.NET Core application. For ABP based projects, we should also configure our web module to replace Hangfire for ABP's default background job manager:

[DependsOn(typeof (AbpHangfireAspNetCoreModule))]
public class MyProjectWebModule : AbpModule
{
    public override void PreInitialize()
    {
        Configuration.BackgroundJobs.UseHangfire();				
    }

    //...
}

We added AbpHangfireAspNetCoreModule as a dependency and used Configuration.BackgroundJobs.UseHangfire method to replace Hangfire for ABP's default background job manager.

Hangfire requires schema creation permission in your database since it creates it's own schema and tables on first run. See Hangfire documentation for more information.

迟发性需要在您的数据库模式创建许可，因为它创造了它自己的模式和运在第一次运行的时候。

ASP.NET MVC 5.x Integration

Abp.HangFire nuget package is used for ASP.NET MVC 5.x projects:

Install-Package Abp.HangFire

Then you can install any storage for Hangfire. Most common one is SQL Server storage (see Hangfire.SqlServer nuget package). After you installed these nuget packages, you can configure your project to use Hangfire as shown below:

[DependsOn(typeof (AbpHangfireModule))]
public class MyProjectWebModule : AbpModule
{
    public override void PreInitialize()
    {
        Configuration.BackgroundJobs.UseHangfire(configuration =>
        {
            configuration.GlobalConfiguration.UseSqlServerStorage("Default");
        });
				
    }

    //...
}

We added AbpHangfireModule as a dependency and used Configuration.BackgroundJobs.UseHangfire method to enable and configure Hangfire ("Default" is the connection string in web.config).

Hangfire requires schema creation permission in your database since it creates it's own schema and tables on first run. See Hangfire documentation for more information.

Dashboard Authorization（仪表盘授权）

Hagfire can show a dashboard page to see status of all background jobs in real time. You can configure it as described in it's documentation. By default, this dashboard page is available for all users, not authorized. You can integrate it to ABP's authorization system using AbpHangfireAuthorizationFilter class defined in Abp.HangFire package. Example configuration:

hagfire可以显示仪表板页面看到实时背景工作状态。您可以按照文档中描述的方式配置它。默认情况下，此仪表板页可供所有用户使用，未经授权。你可以将它用在Abp.HangFire包中定义的类abphangfireauthorizationfilter ABP的授权系统。配置示例：

app.UseHangfireDashboard("/hangfire", new DashboardOptions
{
    Authorization = new[] { new AbpHangfireAuthorizationFilter() }
});

This checks if current user has logged in to the application. If you want to require an additional permission, you can pass into it's constructor:

app.UseHangfireDashboard("/hangfire", new DashboardOptions
{
    Authorization = new[] { new AbpHangfireAuthorizationFilter("MyHangFireDashboardPermissionName") }
});

Note: UseHangfireDashboard should be called after authentication middleware in your Startup class (probably as the last line). Otherwise, authorization always fails.

注：usehangfiredashboard应该在你启动类认证中间件后调用（可能作为最后一行）。否则，授权总是失败。