Apizr.Integrations.FileTransfer.Optional 6.3.0

Additional Details

Optional.Async reference package is no longer maintained

There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Apizr.Integrations.FileTransfer.Optional --version 6.3.0                
NuGet\Install-Package Apizr.Integrations.FileTransfer.Optional -Version 6.3.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Apizr.Integrations.FileTransfer.Optional" Version="6.3.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Apizr.Integrations.FileTransfer.Optional --version 6.3.0                
#r "nuget: Apizr.Integrations.FileTransfer.Optional, 6.3.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Apizr.Integrations.FileTransfer.Optional as a Cake Addin
#addin nuget:?package=Apizr.Integrations.FileTransfer.Optional&version=6.3.0

// Install Apizr.Integrations.FileTransfer.Optional as a Cake Tool
#tool nuget:?package=Apizr.Integrations.FileTransfer.Optional&version=6.3.0                

Apizr

Refit based web api client, but resilient (retry, connectivity, cache, auth, log, priority...)

Read - Documentation Browse - Source Watch - Tutorials

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.

How

An api definition with some attributes:

// (Polly) Define a resilience pipeline key
// OR use Microsoft Resilience instead
[assembly:ResiliencePipeline("TransientHttpError")]
namespace Apizr.Sample
{
    // (Apizr) Define your web api base url and ask for cache and logs
    [BaseAddress("https://reqres.in/"), 
    Cache(CacheMode.FetchOrGet, "01:00:00"), 
    Log(HttpMessageParts.AllButBodies)]
    public interface IReqResService
    {
        // (Refit) Define your web api interface methods
        [Get("/api/users")]
        Task<UserList> GetUsersAsync([RequestOptions] IApizrRequestOptions options);

        [Get("/api/users/{userId}")]
        Task<UserDetails> GetUserAsync([CacheKey] int userId, [RequestOptions] IApizrRequestOptions options);

        [Post("/api/users")]
        Task<User> CreateUser(User user, [RequestOptions] IApizrRequestOptions options);
    }
}

Some resilience strategies:

// (Polly) Create a resilience pipeline (if not using Microsoft Resilience)
var resiliencePipelineBuilder = new ResiliencePipelineBuilder<HttpResponseMessage>()
    .AddRetry(
        new RetryStrategyOptions<HttpResponseMessage>
        {
            ShouldHandle = new PredicateBuilder<HttpResponseMessage>()
                .Handle<HttpRequestException>()
                .HandleResult(response =>
                    response.StatusCode is >= HttpStatusCode.InternalServerError
                        or HttpStatusCode.RequestTimeout),
            Delay = TimeSpan.FromSeconds(1),
            MaxRetryAttempts = 3,
            UseJitter = true,
            BackoffType = DelayBackoffType.Exponential
        });

An instance of this managed api:

Extended

Relies on IServiceCollection extension methods approach.

// (Logger) Configure logging the way you want, like
services.AddLogging(loggingBuilder => loggingBuilder.AddDebug());

// (Apizr) Add an Apizr manager for the defined api to your container
services.AddApizrManagerFor<IReqResService>(
    options => options
        // With a cache handler
        .WithAkavacheCacheHandler()
        // If using Microsoft Resilience
        .ConfigureHttpClientBuilder(builder => builder
            .AddStandardResilienceHandler()));

// (Polly) Add the resilience pipeline (if not using Microsoft Resilience)
services.AddResiliencePipeline<string, HttpResponseMessage>("TransientHttpError",
    builder => builder.AddPipeline(resiliencePipelineBuilder.Build()));
...

// (Apizr) Get your manager instance the way you want, like
var reqResManager = serviceProvider.GetRequiredService<IApizrManager<IReqResService>>();

Static

Relies on static builder instantiation approach.

// (Polly) Add the resilience pipeline with its key to a registry
var resiliencePipelineRegistry = new ResiliencePipelineRegistry<string>();
resiliencePipelineRegistry.TryAddBuilder<HttpResponseMessage>("TransientHttpError", 
    (builder, _) => builder.AddPipeline(resiliencePipelineBuilder.Build()));

// (Apizr) Get your manager instance
var reqResManager = ApizrBuilder.Current.CreateManagerFor<IReqResService>(
    options => options
        // With a logger
        .WithLoggerFactory(LoggerFactory.Create(loggingBuilder =>
            loggingBuilder.Debug()))
        // With the defined resilience pipeline registry
        .WithResiliencePipelineRegistry(resiliencePipelineRegistry)
        // And with a cache handler
        .WithAkavacheCacheHandler());

And then you're good to go:

var userList = await reqResManager.ExecuteAsync((api, opt) => api.GetUsersAsync(opt));

This request will be managed with the defined resilience strategies, data cached and all logged.

Apizr has a lot more to offer, just read the doc!

Where

Managing (Core)

Project Current Upcoming
Apizr NuGet NuGet Pre Release
Apizr.Extensions.Microsoft.DependencyInjection NuGet NuGet Pre Release

Caching

Project Current Upcoming
Apizr.Extensions.Microsoft.Caching NuGet NuGet Pre Release
Apizr.Integrations.Akavache NuGet NuGet Pre Release
Apizr.Integrations.MonkeyCache NuGet NuGet Pre Release

Handling

Project Current Upcoming
Apizr.Integrations.Fusillade NuGet NuGet Pre Release
Apizr.Integrations.MediatR NuGet NuGet Pre Release
Apizr.Integrations.Optional NuGet NuGet Pre Release

Mapping

Project Current Upcoming
Apizr.Integrations.AutoMapper NuGet NuGet Pre Release
Apizr.Integrations.Mapster NuGet NuGet Pre Release

Transferring

Project Current Upcoming
Apizr.Integrations.FileTransfer NuGet NuGet Pre Release
Apizr.Extensions.Microsoft.FileTransfer NuGet NuGet Pre Release
Apizr.Integrations.FileTransfer.MediatR NuGet NuGet Pre Release
Apizr.Integrations.FileTransfer.Optional NuGet NuGet Pre Release

Generating

Project Current Upcoming
Refitter NuGet NuGet Pre Release
Refitter.SourceGenerator NuGet NuGet Pre Release

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

Choose which generating approach suites to your needs by installing either:

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.Extensions 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 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 is compatible. 
.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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on Apizr.Integrations.FileTransfer.Optional:

Repository Stars
christianhelle/refitter
A tool for generating Refit interfaces and contracts from OpenAPI specifications
Version Downloads Last updated
6.4.0-preview.4 79 11/19/2024 6.4.0-preview.4 is deprecated because it is no longer maintained.
6.4.0-preview.3 52 11/14/2024 6.4.0-preview.3 is deprecated because it is no longer maintained.
6.4.0-preview.2 55 11/6/2024 6.4.0-preview.2 is deprecated because it is no longer maintained.
6.4.0-preview.1 56 10/25/2024 6.4.0-preview.1 is deprecated because it is no longer maintained.
6.3.0 740 10/17/2024 6.3.0 is deprecated because it is no longer maintained.
6.2.0 173 10/11/2024 6.2.0 is deprecated because it is no longer maintained.
6.1.0 350 10/1/2024 6.1.0 is deprecated because it is no longer maintained.
6.0.0 403 9/10/2024 6.0.0 is deprecated because it is no longer maintained.
6.0.0-preview.9 61 8/29/2024 6.0.0-preview.9 is deprecated because it is no longer maintained.
6.0.0-preview.8 48 8/3/2024 6.0.0-preview.8 is deprecated because it is no longer maintained.
6.0.0-preview.7 717 7/25/2024 6.0.0-preview.7 is deprecated because it is no longer maintained.
6.0.0-preview.6 69 7/18/2024 6.0.0-preview.6 is deprecated because it is no longer maintained.
6.0.0-preview.5 64 6/24/2024 6.0.0-preview.5 is deprecated because it is no longer maintained.
6.0.0-preview.4 77 5/24/2024 6.0.0-preview.4 is deprecated because it is no longer maintained.
6.0.0-preview.3 39 5/2/2024 6.0.0-preview.3 is deprecated because it is no longer maintained.
6.0.0-preview.2 62 3/29/2024 6.0.0-preview.2 is deprecated because it is no longer maintained.
6.0.0-preview.1 71 3/8/2024 6.0.0-preview.1 is deprecated because it is no longer maintained.
5.4.0 191 10/12/2023 5.4.0 is deprecated because it is no longer maintained.
5.3.0 172 9/25/2023 5.3.0 is deprecated because it is no longer maintained.
5.2.0 174 8/28/2023 5.2.0 is deprecated because it is no longer maintained.
5.1.0 228 7/21/2023 5.1.0 is deprecated because it is no longer maintained.
5.0.1 190 7/16/2023 5.0.1 is deprecated because it is no longer maintained.
5.0.0 208 6/22/2023 5.0.0 is deprecated because it is no longer maintained.
5.0.0-preview.4 122 6/16/2023 5.0.0-preview.4 is deprecated because it is no longer maintained.
5.0.0-preview.3 105 6/7/2023 5.0.0-preview.3 is deprecated because it is no longer maintained.
5.0.0-preview.2 94 5/16/2023 5.0.0-preview.2 is deprecated because it is no longer maintained.
5.0.0-preview.1 106 3/22/2023 5.0.0-preview.1 is deprecated because it is no longer maintained.