signalr

SignalR スキル

リアルタイムのクライアント・サーバー通信を実現する ASP.NET Core SignalR の実装です。Sorcha では、ワークフロー通知用の ActionsHub（Blueprint Service）と、台帳イベント用の RegisterHub（Register Service）の 2 つのハブを使用します。どちらも、クエリパラメーターを介した JWT 認証と、グループベースのブロードキャストを使用します。

クイックスタート

ハブの実装

// Strongly-typed hub with client interface
public class RegisterHub : Hub<IRegisterHubClient>
{
    public async Task SubscribeToRegister(string registerId)
    {
        await Groups.AddToGroupAsync(Context.ConnectionId, $"register:{registerId}");
    }
}

public interface IRegisterHubClient
{
    Task RegisterCreated(string registerId, string name);
    Task TransactionConfirmed(string registerId, string transactionId);
}

サービスからの送信

public class NotificationService
{
    private readonly IHubContext<ActionsHub> _hubContext;

    public async Task NotifyActionConfirmedAsync(ActionNotification notification, CancellationToken ct)
    {
        await _hubContext.Clients
            .Group($"wallet:{notification.WalletAddress}")
            .SendAsync("ActionConfirmed", notification, ct);
    }
}

クライアント接続（テスト）

var connection = new HubConnectionBuilder()
    .WithUrl($"{baseUrl}/actionshub?access_token={jwt}")
    .Build();

connection.On<ActionNotification>("ActionConfirmed", notification => { /* handle */ });
await connection.StartAsync();
await connection.InvokeAsync("SubscribeToWallet", walletAddress);

主な概念

概念	用途	例
グループ	メッセージの送信先を購読者ごとに振り分けます	wallet:{address}, register:{id}, tenant:{id}
型付きハブ	コンパイル時の安全性を確保します	Hub<IRegisterHubClient>
IHubContext	サービスから送信します	IHubContext<THub> を注入します
JWT 認証	クエリパラメーターによる認証	?access_token={jwt}

よくあるパターン

ハブを介したサービスの抽象化

対象: ビジネスロジックを SignalR の実装から分離する場合

// Interface in Services/Interfaces/
public interface INotificationService
{
    Task NotifyActionAvailableAsync(ActionNotification notification, CancellationToken ct = default);
}

// Register in DI
builder.Services.AddScoped<INotificationService, NotificationService>();

Program.cs でのハブ登録

builder.Services.AddSignalR();

// Map after authentication middleware
app.MapHub<ActionsHub>("/actionshub");
app.MapHub<RegisterHub>("/hubs/register");

関連項目

• パターン - ハブのパターン、グループへの振り分け、型付きクライアント
• ワークフロー - テスト、スケーリング、認証のセットアップ

関連スキル

• aspire - サービスのオーケストレーションと構成
• jwt - ハブ接続用の認証トークンのセットアップ
• redis - スケーリング用のバックプレーン構成
• xunit - 統合テストのパターン
• fluent-assertions - ハブのテスト用アサーション

ドキュメントリソース

Context7 で最新の SignalR ドキュメントを取得します。

Context7 の使用方法:

1. mcp__context7__resolve-library-id を使用して「signalr aspnetcore」を検索します
2. ソースコードよりもウェブサイトのドキュメント（/websites/ で始まる ID）を優先します
3. 解決したライブラリ ID を使用して mcp__context7__query-docs でクエリします

ライブラリ ID: /websites/learn_microsoft_en-us_aspnet_core (SignalR を含む ASP.NET Core ドキュメント)

おすすめのクエリ:

• 「SignalR ハブのグループと認証」
• 「SignalR Redis バックプレーンのスケーリング」
• 「SignalR の強く型付けされたハブ」