Eklee.Azure.Functions.Http 0.8.2

There is a newer version of this package available.
See the version list below for details.
dotnet add package Eklee.Azure.Functions.Http --version 0.8.2
NuGet\Install-Package Eklee.Azure.Functions.Http -Version 0.8.2
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="Eklee.Azure.Functions.Http" Version="0.8.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Eklee.Azure.Functions.Http --version 0.8.2
#r "nuget: Eklee.Azure.Functions.Http, 0.8.2"
#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 Eklee.Azure.Functions.Http as a Cake Addin
#addin nuget:?package=Eklee.Azure.Functions.Http&version=0.8.2

// Install Eklee.Azure.Functions.Http as a Cake Tool
#tool nuget:?package=Eklee.Azure.Functions.Http&version=0.8.2

Introduction

The purpose of this library is to help developers with dependency injection per HTTP request context. This is currently not available via the default dependency injection infrastructure. A secondary goal is provide easy access to common infrastructure services such as security, logging, etc.

DI Usage

In order to leverage this library, there are 3 steps. You would want to setup your DI, apply the ExecutionContextDependencyInjection attribute, and inject the ExecutionContext as a parameter in your function.

Step 1: Setup DI

The first step is to setup your DI via the Autofac Module.

using Autofac;

namespace FunctionApp1
{
    public class MyModuleConfig : Module
    {
        protected override void Load(ContainerBuilder builder)
        {
            builder.RegisterType<MyDomain>().As<IMyDomain>();
        }
    }
}

Step 2/3: Setup ExecutionContextDependencyInjection attribute on said function and inject ExecutionContext.

The second step is to apply the ExecutionContextDependencyInjection on your function and tell it which Module type you would like. Next, you can inject the ExecutionContext which internally carries the function instance Id.

public static class Function1
{
    [ExecutionContextDependencyInjection(typeof(MyModuleConfig))]
    [FunctionName("Function1")]
    public static async Task<IActionResult> Run(
        [HttpTrigger(AuthorizationLevel.Function, "get", "post", Route = null)] HttpRequest req,
        ILogger log,
        ExecutionContext executionContext)
    {

Dependency Resolution Usage:

Now, there are 2 extension methods you can use against the ExecutionContext. You can choose the Resolve method to resolve your dependency.

var myDomain = executionContext.Resolve<IMyDomain>();
myDomain.DoWork();

Or you can get the Resolver.

var resolver = executionContext.GetResolver();
var myDomain = resolver.Get<IMyDomain>();
myDomain.DoWork();

Azure Function Logger Usage:

Note that we have already captured ILogger as well as the actual HttpRequest. So, if you can inject IHttpRequestContext to access the logger or Http request which is hanging off IHttpRequestContext.

public class MyDomain : IMyDomain
{
    private readonly IHttpRequestContext _requestContext;

    public MyDomain(IHttpRequestContext requestContext)
    {
        _requestContext = requestContext;
    }

    public void DoWork()
    {
        _requestContext.Logger.LogInformation("FOOBAR");
    }
}

Exception Handling Usage:

To translate an exception-type to an HTTP response like Bad Request, you can implement the IExceptionHandler which will provide a way for the infrastructure code to recognize an exception type and return the correct HTTP response.

public class MyArgumentExceptionHandler : IExceptionHandler
{
    public ExceptionHandlerResult Handle(Exception ex)
    {
        if (ex.GetType() == typeof(ArgumentException))
        {
            return new ExceptionHandlerResult(true, new BadRequestObjectResult(new ErrorMessage { Message = ex.Message }));
        }

        return null;
    }
}

Remember to register the handler in your Module. You can register more than one.

builder.RegisterType<MyArgumentExceptionHandler>().As<IExceptionHandler>();
builder.RegisterType<MyCustomExceptionHandler>().As<IExceptionHandler>();

To leverage the handlers, you will need to use the extension method Run.

[ExecutionContextDependencyInjection(typeof(MyModule))]
[FunctionName("Function3")]
public static async Task<IActionResult> Run3(
    [HttpTrigger(AuthorizationLevel.Anonymous, "post", Route = null)]
    HttpRequest req, ILogger log, ExecutionContext executionContext)
{
    // Example of how we can directly resolve a dependency.
    return await executionContext.Run<IDtoDomain, DtoResponse>(domain => Task.FromResult(domain.DoWork()));
}

Azure AD integration Usage:

We can access user context from the Azure AD integration. Inject IHttpRequestContext into your domain and access the Security property.

See the following link for more information on these special headers: https://docs.microsoft.com/en-us/azure/app-service/app-service-authentication-how-to#access-user-claims

_httpRequestContext.Security.Principal.Name
...
_httpRequestContext.Security.Principal.Id

Microsoft.Extensions.Configuration.IConfiguration Usage:

We can leverage IConfiguration directly to get settings stored locally in local.settings.json or get settings stored in Azure Web App's Application settings.

Here's an example of using IConfiguration to determine if your Azure Function is running locally by using a common configuration value stored in local.settings.json.

using Microsoft.Extensions.Configuration;

namespace Eklee.Azure.Functions.Http.Example
{
    public class ConfigDomain : IConfigDomain
    {
        private readonly IConfiguration _configuration;

        public ConfigDomain(IConfiguration configuration)
        {
            _configuration = configuration;
        }

        public bool IsLocalEnvironment()
        {
            var value = _configuration.GetValue<string>("AzureWebJobsStorage");
            return value == "UseDevelopmentStorage=true";
        }
    }
}

Microsoft.Extensions.Logging.ILogger Usage:

We can leverage ILogger directly to perform logging activities.

Here's an example of using ILogger to log an info message.

using Microsoft.Extensions.Logging;

namespace Eklee.Azure.Functions.Http.Example
{
    public class MyLogDomain : IMyLogDomain
    {
        private readonly ILogger _logger;

        public MyLogDomain(ILogger logger)
        {
            _logger = logger;
        }

        public void DoWork()
        {
            _logger.LogInformation("MyLogDomain DoWork invoked.");
        }
    }
}

ICacheManager Usage:

We can leverage ICacheManager to perform caching work. First, choose your preferred DistributedCache as you are setting up your Module. Note that MemoryDistributedCache is just an example. In a production senario, you may choose something like Azure Redis.

builder.UseDistributedCache<MemoryDistributedCache>();

Next, you may inject ICacheManager for usage. Here's an example of using ICacheManager to cache a value from repository for a duration of time (5 seconds in the example below) if it does not already exist. CacheResult is returned where we can determine if the result is from Cache or from the repository query.

public DomainWithCache(ICacheManager cacheManager, IRepository repository)
{
    _cacheManager = cacheManager;
    _repository = repository;
    ...
}

public async Task<CacheResult<KeyValueDto>> GetAsync(string key)
{
    return await _cacheManager.TryGetOrSetIfNotExistAsync(() => _repository.Single(x => x.Key == key), key,
        new DistributedCacheEntryOptions
        {
            AbsoluteExpiration = DateTimeOffset.UtcNow.AddSeconds(5)
        });
}
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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Eklee.Azure.Functions.Http:

Package Downloads
Eklee.Azure.Functions.GraphQl

Implement one or more Serverless GraphQL API(s) using Azure Functions, Azure Cosmos DB, Azure Search, Azure Table Storage etc.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
0.14.2 3,111 1/19/2021
0.12.19 2,429 11/26/2020
0.12.18 487 11/26/2020
0.10.1 1,379 6/14/2020
0.9.0 1,271 3/28/2020
0.8.7 1,011 12/22/2019
0.8.6 2,210 9/8/2019
0.8.4 2,752 8/11/2019
0.8.3 4,298 6/16/2019
0.8.2 1,804 3/25/2019
0.8.1 5,755 2/10/2019
0.7.0 2,150 12/28/2018
0.6.1 1,655 11/2/2018
0.5.0 1,166 10/27/2018
0.4.1 882 10/25/2018
0.3.0 825 10/21/2018
0.2.0 843 10/19/2018
0.1.1 874 10/16/2018

* Use latest packages.