Apizr.Integrations.Optional
5.0.1
Optional.Async reference package is no more maintained
See the version list below for details.
dotnet add package Apizr.Integrations.Optional --version 5.0.1
NuGet\Install-Package Apizr.Integrations.Optional -Version 5.0.1
<PackageReference Include="Apizr.Integrations.Optional" Version="5.0.1" />
paket add Apizr.Integrations.Optional --version 5.0.1
#r "nuget: Apizr.Integrations.Optional, 5.0.1"
// Install Apizr.Integrations.Optional as a Cake Addin #addin nuget:?package=Apizr.Integrations.Optional&version=5.0.1 // Install Apizr.Integrations.Optional as a Cake Tool #tool nuget:?package=Apizr.Integrations.Optional&version=5.0.1
Apizr
Refit based web api client, but resilient (retry, connectivity, cache, auth, log, priority...)
What
The Apizr project was motivated by this 2015 famous blog post about resilient networking.
Its main focus was to address at least everything explained into this article, meanning:
- Easy access to restful services
- Work offline with cache management
- Handle errors with retry pattern and global catching
- Handle request priority
- Check connectivity
- Fast development time
- Easy maintenance
- Reuse existing libraries
But also, some more core features like:
- Trace http traffic
- Handle authentication
And more integration/extension independent optional features like:
- Choose cache, log and connectivity providers
- Register it as an MS DI extension
- Map model with DTO
- Use Mediator pattern
- Use Optional pattern
- Manage file transfers
The list is not exhaustive, there�s more, but what we wanted was playing with all of it with as less code as we could, not worrying about plumbing things and being sure everything is wired and handled by design or almost.
Inspired by Refit.Insane.PowerPack, we wanted to make it simple to use, mixing attribute decorations and fluent configuration.
Also, we built this lib to make it work with any .Net Standard 2.0 compliant platform, so we could use it seamlessly from any kind of app, with or without DI goodness.
How
An api definition with some attributes:
[assembly:Policy("TransientHttpError")]
namespace Apizr.Sample
{
[WebApi("https://reqres.in/"), Cache, Log]
public interface IReqResService
{
[Get("/api/users")]
Task<UserList> GetUsersAsync();
[Get("/api/users/{userId}")]
Task<UserDetails> GetUserAsync([CacheKey] int userId);
[Post("/api/users")]
Task<User> CreateUser(User user);
}
}
An instance of this managed api:
// Define some policies
var registry = new PolicyRegistry
{
{
"TransientHttpError",
HttpPolicyExtensions
.HandleTransientHttpError()
.WaitAndRetryAsync(new[]
{
TimeSpan.FromSeconds(1),
TimeSpan.FromSeconds(5),
TimeSpan.FromSeconds(10)
})
}
};
// Get your manager instance
var reqResManager = ApizrBuilder.Current.CreateManagerFor<IReqResService>(
options => options
.WithPolicyRegistry(registry)
.WithAkavacheCacheHandler());
And then you're good to go:
var userList = await reqResManager.ExecuteAsync(api => api.GetUsersAsync());
This request will be managed with the defined policies, data cached, http traces logged.
Apizr has a lot more to offer, just read the doc!
Where
Managing (Core)
Project | Current | Upcoming |
---|---|---|
Apizr | ||
Apizr.Extensions.Microsoft.DependencyInjection |
Caching
Project | Current | Upcoming |
---|---|---|
Apizr.Extensions.Microsoft.Caching | ||
Apizr.Integrations.Akavache | ||
Apizr.Integrations.MonkeyCache |
Handling
Project | Current | Upcoming |
---|---|---|
Apizr.Integrations.Fusillade | ||
Apizr.Integrations.MediatR | ||
Apizr.Integrations.Optional |
Mapping
Project | Current | Upcoming |
---|---|---|
Apizr.Integrations.AutoMapper | ||
Apizr.Integrations.Mapster |
Transferring
Project | Current | Upcoming |
---|---|---|
Apizr.Integrations.FileTransfer | ||
Apizr.Extensions.Microsoft.FileTransfer | ||
Apizr.Integrations.FileTransfer.MediatR | ||
Apizr.Integrations.FileTransfer.Optional |
Generating
Project | Current | Upcoming |
---|---|---|
Apizr.Tools.NSwag |
Install the NuGet reference package of your choice:
- Apizr package comes with the static builder instantiation approach (which you can register in your DI container then)
- Apizr.Extensions.Microsoft.DependencyInjection package extends your IServiceCollection with AddApizr, AddApizrFor and AddApizrCrudFor registration methods
- Apizr.Extensions.Microsoft.Caching package brings an ICacheHandler method mapping implementation for MS Extensions Caching
- Apizr.Integrations.Akavache package brings an ICacheHandler method mapping implementation for Akavache
- Apizr.Integrations.MonkeyCache package brings an ICacheHandler method mapping implementation for MonkeyCache
- Apizr.Integrations.Fusillade package enables request priority management using Fusillade
- Apizr.Integrations.MediatR package enables request auto handling with mediation using MediatR
- Apizr.Integrations.Optional package enables Optional result from mediation requests (requires MediatR integration) using Optional.Async
- Apizr.Integrations.AutoMapper package enables data mapping using AutoMapper
- Apizr.Integrations.Mapster package enables data mapping using Mapster- Apizr.Integrations.FileTransfer package enables file transfer management for static registration
- Apizr.Extensions.Microsoft.FileTransfer package enables file transfer management for extended registration
- Apizr.Integrations.FileTransfer.MediatR package enables file transfer management for mediation requests (requires MediatR integration and could work with Optional integration) using MediatR
- Apizr.Integrations.FileTransfer.Optional package enables file transfer management for mediation requests with optional result (requires MediatR integration and could work with Optional integration) using Optional.Async
Install the NuGet .NET CLI Tool package if needed:
- Apizr.Tools.NSwag package enables Apizr files generation by command lines (Models, Apis and Registrations) from an OpenApi/Swagger definition using NSwag
Apizr core package make use of well known nuget packages to make the magic appear:
Package | Features |
---|---|
Refit | Auto-implement web api interface and deal with HttpClient |
Polly | Apply some policies like Retry, CircuitBreaker, etc... |
Microsoft.Extensions.Logging.Abstractions | Delegate logging layer to MS Extensions Logging |
It also comes with some handling interfaces to let you provide your own services for:
- Caching with ICacheHandler, which comes with its default VoidCacheHandler (no cache), but also with:
- InMemoryCacheHandler & DistributedCacheHandler: MS Extensions Caching methods mapping interface (Integration package referenced above), meaning you can provide any compatible caching engine
- AkavacheCacheHandler: Akavache methods mapping interface (Integration package referenced above)
- MonkeyCacheHandler: MonkeyCache methods mapping interface (Integration package referenced above)
- Logging As Apizr relies on official MS ILogger interface, you may want to provide any compatible logging engine (built-in DebugLogger activated by default)
- Connectivity with IConnectivityHandler, which comes with its default VoidConnectivityHandler (no connectivity check)
- Mapping with IMappingHandler, which comes with its default VoidMappingHandler (no mapping conversion), but also with:
- AutoMapperMappingHandler: AutoMapper mapping methods mapping interface (Integration package referenced above)
- MapsterMappingHandler: Mapster mapping methods mapping interface (Integration package referenced above)
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. |
-
- Apizr.Integrations.MediatR (>= 5.0.1)
- Optional.Async (>= 1.3.0)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Apizr.Integrations.Optional:
Package | Downloads |
---|---|
Apizr.Integrations.FileTransfer.Optional
Refit based web api client management, but resilient (retry, connectivity, cache, auth, log, priority...) |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated | |
---|---|---|---|
6.4.0-preview.4 | 98 | 11/19/2024 | |
6.4.0-preview.3 | 51 | 11/14/2024 | |
6.4.0-preview.2 | 54 | 11/6/2024 | |
6.4.0-preview.1 | 52 | 10/25/2024 | |
6.3.0 | 555 | 10/17/2024 | |
6.2.0 | 203 | 10/11/2024 | |
6.1.0 | 383 | 10/1/2024 | |
6.0.0 | 451 | 9/10/2024 | |
6.0.0-preview.9 | 62 | 8/29/2024 | |
6.0.0-preview.8 | 50 | 8/3/2024 | |
6.0.0-preview.7 | 733 | 7/25/2024 | |
6.0.0-preview.6 | 69 | 7/18/2024 | |
6.0.0-preview.5 | 68 | 6/24/2024 | |
6.0.0-preview.4 | 81 | 5/24/2024 | |
6.0.0-preview.3 | 35 | 5/2/2024 | |
6.0.0-preview.2 | 66 | 3/29/2024 | |
6.0.0-preview.1 | 71 | 3/8/2024 | |
5.4.0 | 232 | 10/12/2023 | |
5.3.0 | 198 | 9/25/2023 | |
5.2.0 | 239 | 8/28/2023 | |
5.1.0 | 273 | 7/21/2023 | |
5.0.1 | 248 | 7/16/2023 | |
5.0.0 | 247 | 6/22/2023 | |
5.0.0-preview.4 | 110 | 6/16/2023 | |
5.0.0-preview.3 | 106 | 6/7/2023 | |
5.0.0-preview.2 | 96 | 5/16/2023 | |
5.0.0-preview.1 | 120 | 3/22/2023 | |
4.1.0 | 535 | 5/2/2022 | |
4.0.0 | 466 | 3/30/2022 | |
4.0.0-preview.2 | 161 | 3/15/2022 | |
4.0.0-preview.1 | 146 | 2/15/2022 | |
3.0.0 | 556 | 3/12/2021 | |
2.0.0 | 454 | 1/4/2021 | |
1.9.0 | 539 | 11/19/2020 | |
1.8.1 | 493 | 10/22/2020 | |
1.8.0 | 520 | 10/22/2020 | |
1.7.0 | 521 | 10/19/2020 | |
1.6.0 | 536 | 10/9/2020 | |
1.5.0 | 582 | 7/31/2020 | |
1.4.2 | 523 | 7/24/2020 | |
1.4.1 | 470 | 7/21/2020 | |
1.4.0 | 500 | 7/17/2020 | |
1.3.0 | 525 | 7/9/2020 | |
1.2.0 | 520 | 7/3/2020 |