Providers Overview

Documentation Index

Fetch the complete documentation index at: https://easyaf.dev/llms.txt

Use this file to discover all available pages before exploring further.

​

Available Providers

​

Provider Comparison

​

Choosing a Provider

​

Azure Storage Queue

• Applications already using Azure ecosystem
• Cost-sensitive scenarios (very affordable)
• High-volume, low-complexity messaging
• Integration with Azure Functions

• 64KB message size limit
• Basic message ordering (FIFO not guaranteed)
• No advanced routing features

• Background job processing
• Event notifications
• Simple workflow coordination

​

Amazon SQS

• Applications in AWS ecosystem
• Mission-critical applications requiring high reliability
• Complex messaging patterns with DLQ support
• Applications requiring message ordering (FIFO queues)

• Higher cost than Azure Storage
• More complex IAM configuration
• AWS-specific features and terminology

• Microservices communication
• Order processing systems
• High-volume transaction processing

​

File System

• Development and testing
• On-premises deployments
• Simple applications with low message volume
• Azure Functions with custom triggers

• Not suitable for production at scale
• No built-in redundancy
• Platform-dependent file locking

• Local development
• Simple background processing
• File-based integrations
• Proof of concepts

​

IndexedDB

• Blazor WebAssembly applications
• Client-side background processing
• Offline-capable applications
• Browser-based workflows

• Browser storage quotas
• Single-user scenarios only
• No cross-browser synchronization
• Limited to WebAssembly context

• Client-side data processing
• Offline message queuing
• Browser-based workflows
• Progressive Web Apps (PWAs)

​

Multi-Provider Architecture

// Configure multiple publishers
services.AddSimpleMessageBusAzureStoragePublisher("primary", options =>
{
    options.ConnectionString = azureConnectionString;
});

services.AddSimpleMessageBusFileSystemPublisher("local", options =>
{
    options.RootPath = localPath;
});

// Use named publishers
public class OrderService
{
    private readonly IMessagePublisher _primaryPublisher;
    private readonly IMessagePublisher _localPublisher;

    public OrderService(
        [FromKeyedServices("primary")] IMessagePublisher primaryPublisher,
        [FromKeyedServices("local")] IMessagePublisher localPublisher)
    {
        _primaryPublisher = primaryPublisher;
        _localPublisher = localPublisher;
    }
}

​

Migration Between Providers

1. Add the new provider alongside the existing one
2. Gradually migrate message types to the new provider
3. Update handlers to process from both providers during transition
4. Remove the old provider once migration is complete

// Phase 1: Add new provider
services.AddSimpleMessageBusAmazonSQSPublisher(newOptions);
services.AddSimpleMessageBusAzureStoragePublisher(oldOptions);

// Phase 2: Dual publishing during migration
await _newPublisher.PublishAsync(message);
await _oldPublisher.PublishAsync(message); // Remove when ready

// Phase 3: Remove old provider
services.RemoveSimpleMessageBusAzureStorage();

​

Provider-Specific Features

​

Azure Storage Queue Features

• Poison message handling: Automatic dead letter queue support
• Message TTL: Configurable time-to-live for messages
• Peek operations: Non-destructive message inspection
• Batch operations: Process multiple messages efficiently

​

Amazon SQS Features

• FIFO queues: Guaranteed message ordering
• Message deduplication: Automatic duplicate detection
• Dead letter queues: Sophisticated error handling
• Long polling: Efficient message retrieval

​

File System Features

• Azure Functions triggers: Custom trigger bindings
• File watching: Real-time processing of new files
• Structured storage: Organized file hierarchies
• Cross-platform compatibility: Works on all operating systems

​

IndexedDB Features

• Offline support: Works without network connectivity
• Large storage: Gigabytes of client-side storage
• Transaction support: ACID properties for data integrity
• Asynchronous operations: Non-blocking browser operations

​

Configuration Patterns

​

Environment-Based Configuration

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddSimpleMessageBusFileSystemProvider();
}
else if (builder.Environment.IsProduction())
{
    builder.Services.AddSimpleMessageBusAzureStorageProvider();
}

​

Feature Flag Configuration

var useAmazonSQS = builder.Configuration.GetValue<bool>("Features:UseAmazonSQS");

if (useAmazonSQS)
{
    builder.Services.AddSimpleMessageBusAmazonSQSProvider();
}
else
{
    builder.Services.AddSimpleMessageBusAzureStorageProvider();
}

​

Next Steps