📖 Usage Examples

Complex Types

public class User
{
    public int Id { get; set; }
    public string Name { get; set; }
}

var options = new HybridCacheStrategyOptions<User>
{
    Cache = cache,
    Ttl = TimeSpan.FromMinutes(10),
    CacheKeyGenerator = ctx => $"user:{ctx.Properties["userId"]}"
};

var pipeline = new ResiliencePipelineBuilder<User>()
    .AddHybridCache(options)
    .Build();

var user = await pipeline.ExecuteAsync(async ctx =>
{
    var userId = (int)ctx.Properties["userId"];
    return await FetchUserFromDatabase(userId);
}, 
new ResilienceContext { Properties = { ["userId"] = 123 } });

Sliding Expiration

var options = new HybridCacheStrategyOptions<string>
{
    Cache = cache,
    Ttl = TimeSpan.FromMinutes(5),
    UseSlidingExpiration = true // Reset TTL on each access
};

Combining with Other Strategies

var pipeline = new ResiliencePipelineBuilder<string>()
    .AddRetry(new RetryStrategyOptions<string>
    {
        MaxRetryAttempts = 3
    })
    .AddHybridCache(options) // Cache successful results
    .AddTimeout(TimeSpan.FromSeconds(30))
    .Build();

⚙️ Configuration

HybridCacheStrategyOptions<TResult>

🔒 Type Safety

This package only supports typed pipelines (ResiliencePipelineBuilder<TResult>). Untyped pipelines (object) are not supported to ensure type safety and avoid serialization issues.

// ✅ SUPPORTED
var typedPipeline = new ResiliencePipelineBuilder<string>()
    .AddHybridCache(options)
    .Build();

// ❌ NOT SUPPORTED
var untypedPipeline = new ResiliencePipelineBuilder()
    .AddHybridCache(options) // Compile error - no extension method
    .Build();

📋 Requirements

• .NET 9.0 or later
• Polly.Core 8.0+
• Microsoft.Extensions.Caching.Hybrid 9.3.0+

🤝 Contributing

Contributions are welcome! Please:

1. Fork the repo
2. Create a feature branch
3. Add tests for new features
4. Ensure all tests pass
5. Submit a PR

📜 License

This project is licensed under the BSD-3-Clause License - same as Polly.

🙏 Acknowledgments

• Polly Project - The resilience and transient-fault-handling library
• Martin Costello - For valuable feedback and guidance

📝 Related Links

• Polly Documentation
• HybridCache Documentation
• Polly Contrib

Note: This is a community-maintained package and not an official part of Polly.Core.