IronAlpine.Caching
2.0.0
dotnet add package IronAlpine.Caching --version 2.0.0
NuGet\Install-Package IronAlpine.Caching -Version 2.0.0
<PackageReference Include="IronAlpine.Caching" Version="2.0.0" />
<PackageVersion Include="IronAlpine.Caching" Version="2.0.0" />
<PackageReference Include="IronAlpine.Caching" />
paket add IronAlpine.Caching --version 2.0.0
#r "nuget: IronAlpine.Caching, 2.0.0"
#:package IronAlpine.Caching@2.0.0
#addin nuget:?package=IronAlpine.Caching&version=2.0.0
#tool nuget:?package=IronAlpine.Caching&version=2.0.0
IronAlpine.Caching
Why
Provides cache-aware mediator behavior and cache contracts for request/response caching with invalidation support.
Installation
dotnet add package IronAlpine.Caching
Core Types
ICacheableQueryCachingBehavior<TRequest,TResponse>- Cache setting DTO and contracts
Program.cs
builder.Services.AddIronAlpineCaching();
Behavior Order
Recommended order:
- Logging
- Caching
- Validation
- Auditing
- Transaction
Combinations
- With
IronAlpine.Caching.Redis: distributed cache + pub/sub invalidation. - With
IronAlpine.Data.EFCore.Mediator: safe cache invalidation after successful commit.
Troubleshooting
- Cache miss always: ensure request implements
ICacheableQueryand key generation is deterministic. - Stale data: verify invalidation event publishing and channel subscriptions.
Configuration Deep Dive
When a package exposes options classes, use builder.Configuration binding and keep values explicit per environment.
Common guidance:
- Prefer explicit values in production.
- Keep retries/timeouts conservative; tune with telemetry.
- Enable startup validation in non-development environments.
- Fail fast when required dependencies are missing.
Integration Patterns
Pattern A: API service with EF + Messaging
- Register EF provider package.
- Register messaging inbox/outbox package.
- Register mediator and behavior order.
- Enable health readiness checks for DB and broker.
Pattern B: Read-heavy service with Dapper + Messaging
- Register Dapper data package.
- Register messaging package with consumer enabled.
- Add observability and structured logging.
Pattern C: Security-focused service
- Register security ASP.NET package.
- Add policy catalog or resolver.
- Register authorization EFCore projection package only where needed.
Options Checklist
Use this checklist when configuring any IronAlpine package:
- Required connection strings present.
- Feature flags intentional (
Enable*values reviewed). - Retry and timeout values match SLO expectations.
- Startup validation behavior understood.
- Environment-specific defaults are overridden in production.
Troubleshooting Matrix
- Startup failure with validation error : A required dependency package or config value is missing. Check package registrations and bound options sections.
- Background workers not starting
: Verify execution mode,
Enable*flags, and hosted services registration. - Policy/authorization mismatch : Check claim types, policy naming strategy, and catalog entries.
- Cache stale or no-hit behavior : Validate key generation, invalidation path, and distributed lock configuration.
- Messaging duplicate handling issues
: Verify
event-idpropagation and idempotency key construction.
Best-Practice Notes
- Keep handler logic deterministic and side-effect boundaries explicit.
- Keep
IQueryableusage inside application handlers/services. - Keep transaction save boundaries in handlers where business intent is clear.
- Prefer explicit topic policy metadata for critical events.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- IronAlpine.Kernel (>= 2.0.0)
- IronAlpine.Locking.Abstractions (>= 2.0.0)
- IronAlpine.Mediator.Abstractions (>= 2.0.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 9.0.7)
- Microsoft.Extensions.Logging.Abstractions (>= 9.0.7)
-
net9.0
- IronAlpine.Kernel (>= 2.0.0)
- IronAlpine.Locking.Abstractions (>= 2.0.0)
- IronAlpine.Mediator.Abstractions (>= 2.0.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 9.0.7)
- Microsoft.Extensions.Logging.Abstractions (>= 9.0.7)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on IronAlpine.Caching:
| Package | Downloads |
|---|---|
|
IronAlpine.Caching.Redis
Redis implementation for IronAlpine.Caching with EF Core-backed cache settings, pub/sub invalidation for multi-pod deployments, and table contributor support. |
GitHub repositories
This package is not used by any popular GitHub repositories.
Stable mediator release with request/response, notification publish strategies, streaming, and dependency injection integration.