coravel

コラベル

Coravelは、開発者がタスク/ジョブスケジューリング、キューイング、キャッシュ、メーリング（およびその他！）などの高度なアプリケーション機能をアクセスしやすく簡単に作成することにより、.NETアプリケーションを迅速に稼働させるのを支援します。シンプルで表現力豊かで簡単な構文が付属しています。

ここで公式のドキュメントを表示できます。

特徴：

タスク/ジョブスケジューリング

通常、Windowsタスクスケジューラを介してCronジョブまたはタスクを構成して、実行する単一または複数の再発動タスクを取得する必要があります。

Coravelを使用すると、コードでシンプルでエレガントで流fluent的な構文を使用して、すべてのスケジュールされたタスクを1か所でセットアップできます。

キューイング

Coravelは、ユーザーがHTTPリクエストが終了するのを待つ代わりに、インメモリを実行して背景にオフロードするゼロ構成キューを提供します！

キャッシング

Coravelは、.NETコアアプリケーションでキャッシュするために使いやすいAPIを提供します。

デフォルトでは、メモリ内キャッシュを使用しますが、より堅牢なシナリオのためにデータベースドライバーもあります！

イベント放送

Coravelのイベントブロードキャストは、パーツが大まかに結合されている保守可能なアプリケーションを構築するのに役立ちます！

郵送

電子メールは本来あるべきほど簡単ではありません。幸運なことに、Coravelはこれを提供して解決します。

• 組み込みの電子メールに優しいレーザーテンプレート
• シンプルで柔軟なメーリングAPI
• 視覚テストのために電子メールをレンダリングします
• SMTP、ローカルログファイル、またはBYOMをサポートするドライバー（ "独自のメーラーをお持ちください）ドライバー
• appsettings.jsonを介したクイックでシンプルな構成
• そしてもっと！

サンプル

• EFコアでCoravelを使用します
• Coravelのタスクスケジューリングを使用した.NETワーカーサービス

私をサポートします

BuyMeaCoffeeで進行中のオープンソース作業をサポートできます。

クイックスタート

Coravelを使用して、スケジュールされた間隔でアクションを発行できる基本的な労働者サービスプロセスの構築を開始できる速さは次のとおりです。

1. ターミナル： dotnet new worker -n [NameOfYourApp] -o ./[NameOfYourApp]
2. ターミナル： dotnet add package coravel
3. Program.csを以下に置き換えます。

 using Coravel ;

Console . OutputEncoding = System . Text . Encoding . UTF8 ;

var builder = Host . CreateApplicationBuilder ( args ) ;
builder . Services . AddScheduler ( ) ;

var host = builder . Build ( ) ;

host . Services . UseScheduler ( s =>
{
    s . Schedule ( ( ) => Console . WriteLine ( "It's alive! ?" ) ) . EverySecond ( ) ;
} ) ;

host . Run ( ) ;

4. ターミナル： dotnet run

それだけです - 幸せなコーディング！

Coravel Pro

エンティティフレームワークを使用して.NETアプリケーションを構築している場合は、Coravel Proを調べてください。それは、あなたの.NETアプリを簡単に維持および管理するための管理パネルとツールです！

• 視覚的な仕事のスケジューリングと管理
• efエンティティを管理するためのcrud ui
• ダッシュボードを簡単に構成して、ヘルスメトリック（または必要なもの）を表示する
• データのカスタム表現レポートを作成します
• そしてもっと！

よくある質問

Coravelは吊り下げとどのように違いますか？

Hangfireはしばらくの間、Modern .Net（Core）の前に存在していました。 Coravelがそうではない機能をたくさん持っている素晴らしいツールです。特に：永続的なキュー、再試行メカニズム、多くのストレージドライバーのサポートなど。

ただし、（2023年3月現在）Still Stillは、真のasync/awaitネイティブにサポートしていません（こことここ）。これは、たとえば、Webアプリケーション内でHangfireを使用すると、I/O操作を実行するスレッドを使用する場合ほど効率的ではないことを意味します。

Coravelは、最新のC＃と.NETプリミティブを念頭に置いて作成されました - async/awaitや.NETの組み込み依存噴射ユーティリティなど。つまり、Coravelは設定が容易になり、Webアプリケーションが着信HTTPリクエストに応答するために必要なスレッドで非常に効率的になりません。

CoravelはQuartzとどのように違いますか？

Quartzは、.NETに移植された古いJavaライブラリです。それはまだ最新の.NET依存関係インジェクションツールに接続していません。 CoravelのAPIははるかに簡潔で理解できると考える人もいます。

たとえば、ドキュメントからこのサンプルをCoravelの作業方法と比較してください（たとえば、Coravelのスケジューラを「開始」および「停止」する方法を理解する必要はありませんが、クォーツスケジューラを手動で作業する必要があります）。

私のアプリケーションがダウンした場合に備えて、Coravelは持続的なキューのジョブをストレージにサポートしますか？

いいえ。少なくとも、まだ。

Coravel Processesはメモリ内のアイテムを並べました。アプリケーションがダウンしても、すべてのアイテムが処理されるまでアプリケーションがシャットダウンできなくなります。

Coravelは再試行メカニズムをサポートしていますか？

Coravelの哲学は、他の.NETプリミティブとうまく協力することでした。つまり、他のライブラリを使用するのは簡単です。

Coravelは、Coravelが必要ではないものを膨らませないように非常に注意しているため、内部的に再試行メカニズムをサポートしていません。 Coravelが最善を尽くしていることに焦点を合わせたいと思います（たとえば、「ジョブスケジューリング、キューイングなど、追加のインフラストラクチャと複雑な構成を必要とせずに」）。

たとえば、Invocables内でPollyを使用してRETRIESを行うことができます。一部の人々は、組み込みの取得があるIInvocableから継承する基本クラスを構成します。

Coravelは分散ロックをサポートしていますか？

いいえ。ただし、これは、distributedlockのようなバトルテストされた分散ロックライブラリを使用することで再び実現できます。このようなInvocableのInvoke()を作成する場合があります。

 public class TestInvocable : IInvocable
{
  private ApplicationDbContext _context ;
  private IDistributedLockProvider _distributedlock ;

  public TestInvocable ( ApplicationDbContext context , IDistributedLockProvider distributedlock )
  {
    this . _context = context ;
    this . _distributedlock = distributedlock ;
  }

  public async Task Invoke ( )
  {
    await using ( await this . _distributedlock . AcquireAsync ( ) )
    {
      await this . _context . Test . AddAsync ( new TestModel ( ) { Name = "test name" } ) ;
      await this . _context . SaveChangesAsync ( ) ;
    }
  }
}