Paramore.Darker.Policies
4.0.1
dotnet add package Paramore.Darker.Policies --version 4.0.1
NuGet\Install-Package Paramore.Darker.Policies -Version 4.0.1
<PackageReference Include="Paramore.Darker.Policies" Version="4.0.1" />
paket add Paramore.Darker.Policies --version 4.0.1
#r "nuget: Paramore.Darker.Policies, 4.0.1"
// Install Paramore.Darker.Policies as a Cake Addin #addin nuget:?package=Paramore.Darker.Policies&version=4.0.1 // Install Paramore.Darker.Policies as a Cake Tool #tool nuget:?package=Paramore.Darker.Policies&version=4.0.1
Darker
The query-side counterpart of Brighter.
Usage with ASP.NET Core
In your ConfigureServices
method, use AddDarker
to add Darker to the container.
ASP.NET Core integration is provided by the Paramore.Darker.AspNetCore package.
// This method gets called by the runtime. Use this method to add services to the container.
public void ConfigureServices(IServiceCollection services)
{
// Add Darker and some extensions.
services.AddDarker()
.AddHandlersFromAssemblies(typeof(GetPeopleQueryHandler).Assembly)
.AddJsonQueryLogging()
.AddDefaultPolicies();
// Add framework services.
services.AddMvc();
}
WARNING if you are using EFCore the DBContext DI Lifetime is scoped, for Darker to play nicely with EFCore and DI the QueryProcessor must also be registration as Scoped
services.AddDarker(options =>
{
//EFCore by default registers Context as scoped, which forces the QueryProcessorLifetime to also be scoped
options.QueryProcessorLifetime = ServiceLifetime.Scoped;
})
This example uses the request logging integration provided by Paramore.Darker.QueryLogging and policy integration provided by Paramore.Darker.Policies. Have a look at the Startup.ConfigureServices method in the SampleApi project for more examples on how to use the integrations.
Inject IQueryProcessor
and call Execute
or ExecuteAsync
to dispatch your query to the registered query handler.
using Paramore.Darker;
using Microsoft.AspNetCore.Mvc;
using System.Threading;
using System.Threading.Tasks;
public class FooController : ControllerBase
{
private readonly IQueryProcessor _queryProcessor;
public FooController(IQueryProcessor queryProcessor)
{
_queryProcessor = queryProcessor;
}
public async Task<IActionResult> Get(CancellationToken cancellationToken = default(CancellationToken))
{
var query = new GetFoo(42);
var result = await _queryProcessor.ExecuteAsync(query, cancellationToken);
return Ok(result);
}
}
using Paramore.Darker;
public sealed class GetFoo : IQuery<string>
{
public int Number { get; }
public GetFoo(int number)
{
Number = number;
}
}
Implement either QueryHandler<,>
or QueryHandlerAsync<,>
depending on whether you wish to execute your queries synchronously or asynchronously.
For most control, you can also implement IQueryHandler<,>
directly.
using Paramore.Darker;
using Paramore.Darker.Attributes;
using Paramore.Darker.Policies;
using Paramore.Darker.QueryLogging;
using System.Threading;
using System.Threading.Tasks;
public sealed class GetFooHandler : QueryHandlerAsync<GetFoo, string>
{
[QueryLogging(1)]
[FallbackPolicy(2)]
[RetryableQuery(3)]
public override async Task<string> ExecuteAsync(GetFoo query, CancellationToken cancellationToken = default(CancellationToken))
{
return await FetchFooForNumber(query.Number, cancellationToken);
}
}
Usage without ASP.NET
Register your queries and handlers with QueryHandlerRegistry
and use QueryProcessorBuilder
to configure and build a IQueryProcessor
.
var registry = new QueryHandlerRegistry();
registry.Register<GetFoo, string, GetFooHandler>();
IQueryProcessor queryProcessor = QueryProcessorBuilder.With()
.Handlers(registry, Activator.CreateInstance, t => {}, Activator.CreateInstance)
.InMemoryQueryContextFactory()
.Build();
Instead of Activator.CreateInstance
, you can pass any factory Func<Type, object>
to constuct handlers and decorator.
Integrations with some DI frameworks are available, for example SimpleInjector, as provided by the Paramore.Darker.SimpleInjector package:
var container = new Container();
var queryProcessor = QueryProcessorBuilder.With()
.SimpleInjectoHandlers(container, opts =>
opts.WithQueriesAndHandlersFromAssembly(typeof(GetPeopleQuery).Assembly))
.InMemoryQueryContextFactory()
.Build();
container.Register<IQueryProcessor>(queryProcessor);
In this case you don't need to manually register queries or handlers as the integration allows scanning assemblies for matching types.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- Paramore.Darker (>= 4.0.1)
- Polly (>= 8.3.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories (1)
Showing the top 1 popular GitHub repositories that depend on Paramore.Darker.Policies:
Repository | Stars |
---|---|
BrighterCommand/Brighter
A framework for building messaging apps with .NET and C#.
|
Version | Downloads | Last updated |
---|---|---|
4.0.1 | 17,462 | 3/15/2024 |
3.0.0 | 34,096 | 11/1/2022 |
2.0.79 | 5,552 | 8/25/2022 |
2.0.78 | 107,142 | 9/8/2019 |
2.0.63 | 3,444 | 8/28/2019 |
2.0.11 | 2,947 | 3/18/2019 |
1.1.1 | 6,555 | 6/1/2018 |
1.1.0 | 1,711 | 10/31/2017 |
1.0.2 | 1,584 | 10/4/2017 |
1.0.1 | 1,361 | 10/1/2017 |
1.0.0 | 1,389 | 8/24/2017 |
0.6.0 | 1,433 | 5/9/2017 |