在 ASP.NET Core中使用Cravel作為排程器

2024-03-23碼農

概述：使用 .NET 構建可靠、自我維持的 API 時，計劃一個或多個後台任務幾乎是不可避免的。一些軟體包已經存在多年，例如 Hangfire 和 Quartz.NET。ASP.NET Core 允許將後台任務實作為托管服務。但是，您可能需要一些更可自訂和輕量級的東西，語法更簡單。我介紹Coravel。Cravel是一個用於.NET的開源輕量級庫，允許您在 ASP.NET Core應用程式中輕松執行後台處理和排程。Cravel透過使任務/作業排程、排隊、緩存、信件（等等）等高級應用程式功能易於存取和易於使用，幫助開發人員快速啟動和執行他們的.NET應用程式。排程語法Coravel 的靈感來自 La

使用 .NET 構建可靠、自我維持的 API 時，計劃一個或多個後台任務幾乎是不可避免的。一些軟體包已經存在多年，例如 Hangfire 和 Quartz.NET。

ASP.NET Core 允許將後台任務實作為托管服務。但是，您可能需要一些更可自訂和輕量級的東西，語法更簡單。我介紹Coravel。

Cravel 是一個用於.NET的開源輕量級庫，允許您在 ASP.NET Core應用程式中輕松執行後台處理和排程。Cravel透過使任務/作業排程、排隊、緩存、信件（等等）等高級應用程式功能易於存取和易於使用，幫助開發人員快速啟動和執行他們的.NET應用程式。

排程語法

Coravel 的靈感來自 Laravel 的任務計劃程式，它建立在 .NET Core 內建依賴項註入之上。它使用 Fluent API 來計劃任務，讓您輕松指定任務的頻率、開始時間和結束時間。它還提供了一種對後台作業進行排隊和處理的簡單方法，使您能夠輕松處理大量數據或執行長時間執行的任務。

為什麽使用Cravel進行排程？

與 Hangfire 和 Quartz.net 等替代品相比，它重量輕。
它是近乎零的配置，只需最少的程式碼行即可完成工作。
它易於使用，語法簡單
它支持 async/await，並且非常高效。

卡拉維爾專業版

Coravel Pro是一個專業的管理面板，具有可無縫整合到.NET Core套用中的視覺化工具。

功能包括：

資料庫持久化排程

一個漂亮的使用者介面來管理您的作業/可呼叫物件

執行狀況指標儀表板

輕松配置數據的表格報告（支持聚合/復雜投影）

如果你喜歡 Coravel，正在使用 EF Core 生成 .NET Core 套用，並且想要更多很棒的工具，請檢視！

要求

Coravel 是專為 .NET Core 套用設計的 .NET Standard 庫。將 Coravel 包含在現有 .NET Core 應用程式（版本 2.1.0+）或其他 .NET Standard 計畫中。

安裝

Coravel 需要 nuget 包才能開始使用。Coravel

dotnet add package coravel

任務/作業排程

通常，您必須透過 Windows 任務計劃程式配置 cron 作業或任務，才能執行單個或多個重復出現的任務。

使用 Coravel，您可以使用簡單、優雅、流暢的語法在一個地方設定所有計劃任務——在程式碼中！

可呼叫物件表示應用程式中的獨立作業。建立可呼叫物件使用共享介面。使用 .NET Core 的依賴項註入服務，可呼叫項將在執行時註入其所有依賴項。Coravel.Invocable.IInvocable

下面是建立可呼叫（Job）的範例程式碼：

public classExpiryJobInvocable : IInvocable { privatereadonlyICatalogueService _catalogueService; privatereadonlyILogger<ExpiryJobInvocable> _logger; publicExpiryJobInvocable(ICatalogueService catalogueService, ILogger<ExpiryJobInvocable> logger) { _logger = logger; _catalogueService = catalogueService; } publicasyncTaskInvoke() { await _catalogueService.ExpireCatalogueListing(); } }

使用依賴註入註冊可呼叫檔如下所示：

publicstaticIServiceCollectionRegisterCoravelScheduler(thisIServiceCollection services) { services.AddScheduler(); services.AddTransient<ExpiryJobInvocable>(); return services; }

另外，不要忘記透過指定頻率在應用程式構建器中註冊。它公開了預配置的方法，其中包括 cron 運算式語法。

var app = builder.Build(); app.Services.UseScheduler(scheduler => { scheduler.Schedule<ExpiryJobInvocable>().EveryMinute().PreventOverlapping(nameof(ExpiryJobInvocable)); }).LogScheduledTaskProgress(app.Services.GetRequiredService<ILogger<IScheduler>>());

以下是可用於指定頻率的方法：

// // Summary: // Defines methods available to you for specifying the frequency of how often your // scheduled tasks will run. publicinterfaceIScheduleInterval { IScheduledEventConfigurationEveryMinute(); IScheduledEventConfigurationEveryFiveMinutes(); IScheduledEventConfigurationEveryTenMinutes(); IScheduledEventConfigurationEveryFifteenMinutes(); IScheduledEventConfigurationEveryThirtyMinutes(); IScheduledEventConfigurationHourly(); IScheduledEventConfigurationHourlyAt(int minute); IScheduledEventConfigurationDaily(); IScheduledEventConfigurationDailyAtHour(int hour); IScheduledEventConfigurationDailyAt(int hour, int minute); IScheduledEventConfigurationWeekly(); IScheduledEventConfigurationMonthly(); IScheduledEventConfigurationCron(string cronExpression); IScheduledEventConfigurationEverySecond(); IScheduledEventConfigurationEveryFiveSeconds(); IScheduledEventConfigurationEveryTenSeconds(); IScheduledEventConfigurationEveryFifteenSeconds(); IScheduledEventConfigurationEveryThirtySeconds(); IScheduledEventConfigurationEverySeconds(int seconds); }