Feature-based Injection

Microsoft.FeatureManagement.sln

@@ -27,6 +27,8 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.FeatureManagement
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "EvaluationDataToApplicationInsights", "examples\EvaluationDataToApplicationInsights\EvaluationDataToApplicationInsights.csproj", "{1502529E-47E9-4306-98C4-BF6CF7C7C275}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "FeatureBasedInjectionPOC", "examples\FeatureBasedInjectionPOC\FeatureBasedInjectionPOC.csproj", "{6655016D-900B-42D2-AA43-C33B0E161D6B}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -73,6 +75,10 @@ Global
 		{1502529E-47E9-4306-98C4-BF6CF7C7C275}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{1502529E-47E9-4306-98C4-BF6CF7C7C275}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{1502529E-47E9-4306-98C4-BF6CF7C7C275}.Release|Any CPU.Build.0 = Release|Any CPU
+		{6655016D-900B-42D2-AA43-C33B0E161D6B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{6655016D-900B-42D2-AA43-C33B0E161D6B}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{6655016D-900B-42D2-AA43-C33B0E161D6B}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{6655016D-900B-42D2-AA43-C33B0E161D6B}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -85,6 +91,7 @@ Global
 		{DACAB624-4611-42E8-844C-529F93A54980} = {FB5C34DF-695C-4DF9-8AED-B3EA2516EA72}
 		{283D3EBB-4716-4F1D-BA51-A435F7E2AB82} = {FB5C34DF-695C-4DF9-8AED-B3EA2516EA72}
 		{1502529E-47E9-4306-98C4-BF6CF7C7C275} = {FB5C34DF-695C-4DF9-8AED-B3EA2516EA72}
+		{6655016D-900B-42D2-AA43-C33B0E161D6B} = {FB5C34DF-695C-4DF9-8AED-B3EA2516EA72}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {84DA6C54-F140-4518-A1B4-E4CF42117FBD}

examples/FeatureBasedInjectionPOC/AlgorithmAlpha.cs

@@ -0,0 +1,12 @@
+namespace FeatureBasedInjectionPOC
+{
+    internal class AlgorithmAlpha : IAlgorithm
+    {
+        public string Name { get; set; }
+
+        public AlgorithmAlpha()
+        {
+            Name = "Alpha";
+        }
+    }
+}

examples/FeatureBasedInjectionPOC/AlgorithmBeta.cs

@@ -0,0 +1,12 @@
+namespace FeatureBasedInjectionPOC
+{
+    internal class AlgorithmBeta : IAlgorithm
+    {
+        public string Name { get; set; }
+
+        public AlgorithmBeta()
+        {
+            Name = "Beta";
+        }
+    }
+}

examples/FeatureBasedInjectionPOC/AlgorithmOmega.cs

@@ -0,0 +1,15 @@
+using Microsoft.FeatureManagement;
+
+namespace FeatureBasedInjectionPOC
+{
+    [FeaturedServiceAlias("Omega")]
+    class AlgorithmOmega : IAlgorithm
+    {
+        public string Name { get; set; }
+
+        public AlgorithmOmega(string name)
+        {
+            Name = name;
+        }
+    }
+}

examples/FeatureBasedInjectionPOC/AlgorithmSigma.cs

@@ -0,0 +1,12 @@
+namespace FeatureBasedInjectionPOC
+{
+    internal class AlgorithmSigma : IAlgorithm
+    {
+        public string Name { get; set; }
+
+        public AlgorithmSigma()
+        {
+            Name = "Sigma";
+        }
+    }
+}

examples/FeatureBasedInjectionPOC/FeatureBasedInjectionPOC.csproj

@@ -0,0 +1,25 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net6.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.Extensions.Configuration.Json" Version="6.0.0" />
+    <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="6.0.0" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\..\src\Microsoft.FeatureManagement\Microsoft.FeatureManagement.csproj" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <None Update="appsettings.json">
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </None>
+  </ItemGroup>
+
+</Project>

examples/FeatureBasedInjectionPOC/IAlgorithm.cs

@@ -0,0 +1,7 @@
+namespace FeatureBasedInjectionPOC
+{
+    public interface IAlgorithm
+    {
+        public string Name {  get; }
+    }
+}

examples/FeatureBasedInjectionPOC/OnDemandTargetingContextAccessor.cs

@@ -0,0 +1,14 @@
+using Microsoft.FeatureManagement.FeatureFilters;
+
+namespace FeatureBasedInjectionPOC
+{
+    class OnDemandTargetingContextAccessor : ITargetingContextAccessor
+    {
+        public TargetingContext Current { get; set; }
+
+        public ValueTask<TargetingContext> GetContextAsync()
+        {
+            return new ValueTask<TargetingContext>(Current);
+        }
+    }
+}

examples/FeatureBasedInjectionPOC/Program.cs

@@ -0,0 +1,48 @@
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.FeatureManagement;
+using Microsoft.FeatureManagement.FeatureFilters;
+using FeatureBasedInjectionPOC;
+
+
+IConfiguration configuration = new ConfigurationBuilder()
+    .AddJsonFile("appsettings.json")
+    .Build();
+
+IServiceCollection services = new ServiceCollection();
+
+services.AddSingleton<IAlgorithm, AlgorithmAlpha>();
+services.AddSingleton<IAlgorithm, AlgorithmBeta>();
+services.AddSingleton<IAlgorithm, AlgorithmSigma>();
+services.AddSingleton<IAlgorithm>(sp => new AlgorithmOmega("Omega"));
+
+services.AddSingleton(configuration)
+        .AddFeatureManagement()
+        .AddFeatureFilter<TargetingFilter>()
+        .AddFeaturedService<IAlgorithm>("MyFeature");
+
+var targetingContextAccessor = new OnDemandTargetingContextAccessor();
+
+services.AddSingleton<ITargetingContextAccessor>(targetingContextAccessor);
+
+using ServiceProvider serviceProvider = services.BuildServiceProvider();
+
+IVariantFeatureManager featureManager = serviceProvider.GetRequiredService<IVariantFeatureManager>();
+
+IFeaturedService<IAlgorithm> featuredAlgorithm = serviceProvider.GetRequiredService<IFeaturedService<IAlgorithm>>();
+
+string[] userIds = { "Guest", "UserBeta", "UserSigma", "UserOmega" };
+
+foreach (string userId in userIds)
+{
+    targetingContextAccessor.Current = new TargetingContext
+    {
+        UserId = userId
+    };
+
+    IAlgorithm algorithm = await featuredAlgorithm.GetAsync(CancellationToken.None);
+
+    Variant variant = await featureManager.GetVariantAsync("MyFeature", CancellationToken.None);
+
+    Console.WriteLine($"Get algorithm {algorithm?.Name ?? "Null"} because the feature variant is {variant?.Name ?? "Null"}");
+}

examples/FeatureBasedInjectionPOC/appsettings.json

@@ -0,0 +1,52 @@
+{
+  "FeatureManagement": {
+    "MyFeature": {
+      "EnabledFor": [
+        {
+          "Name": "Targeting",
+          "Parameters": {
+            "Audience": {
+              "Users": [
+                "UserOmega", "UserSigma", "UserBeta"
+              ]
+            }
+          }
+        }
+      ],
+      "Variants": [
+        {
+          "Name": "AlgorithmBeta"
+        },
+        {
+          "Name": "Sigma",
+          "ConfigurationValue": "AlgorithmSigma"
+        },
+        {
+          "Name": "Omega"
+        }
+      ],
+      "Allocation": {
+        "User": [
+          {
+            "Variant": "AlgorithmBeta",
+            "Users": [
+              "UserBeta"
+            ]
+          },
+          {
+            "Variant": "Omega",
+            "Users": [
+              "UserOmega"
+            ]
+          },
+          {
+            "Variant": "Sigma",
+            "Users": [
+              "UserSigma"
+            ]
+          }
+        ]
+      }
+    }
+  }
+}

src/Microsoft.FeatureManagement.Telemetry.ApplicationInsights/TelemetryClientExtensions.cs

@@ -0,0 +1,57 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+//
+using Microsoft.ApplicationInsights;
+using Microsoft.ApplicationInsights.DataContracts;
+using Microsoft.FeatureManagement.FeatureFilters;
+
+namespace Microsoft.FeatureManagement.Telemetry.ApplicationInsights
+{
+    /// <summary>
+    /// Provides extension methods for tracking events with <see cref="TargetingContext"/>.
+    /// </summary>
+    public static class TelemetryClientExtensions
+    {
+        /// <summary>
+        /// Extension method to track an event with <see cref="TargetingContext"/>.
+        /// </summary>
+        public static void TrackEvent(this TelemetryClient telemetryClient, string eventName, TargetingContext targetingContext, IDictionary<string, string> properties = null, IDictionary<string, double> metrics = null)
+        {
+            ValidateTargetingContext(targetingContext);
+
+            if (properties == null)
+            {
+                properties = new Dictionary<string, string>();
+            }
+
+            properties["TargetingId"] = targetingContext.UserId;
+
+            telemetryClient.TrackEvent(eventName, properties, metrics);
+        }
+
+        /// <summary>
+        /// Extension method to track an <see cref="EventTelemetry"/> with <see cref="TargetingContext"/>.
+        /// </summary>
+        public static void TrackEvent(this TelemetryClient telemetryClient, EventTelemetry telemetry, TargetingContext targetingContext)
+        {
+            ValidateTargetingContext(targetingContext);
+
+            if (telemetry == null)
+            {
+                telemetry = new EventTelemetry();
+            }
+
+            telemetry.Properties["TargetingId"] = targetingContext.UserId;
+
+            telemetryClient.TrackEvent(telemetry);
+        }
+
+        private static void ValidateTargetingContext(TargetingContext targetingContext)
+        {
+            if (targetingContext == null)
+            {
+                throw new ArgumentNullException(nameof(targetingContext));
+            }
+        }
+    }
+}