Set up options and track changes in management SDK.

build/dependencies.props

@@ -46,6 +46,7 @@
     <MicrosoftConfigurationUserSecretVersion>2.2.0</MicrosoftConfigurationUserSecretVersion>
     <MicrosoftConfigurationEnvironmentVariablesVersion>2.2.0</MicrosoftConfigurationEnvironmentVariablesVersion>
     <MicrosoftAspNetCoreSignalRProtocolsMessagePackPackageVersion>1.0.11</MicrosoftAspNetCoreSignalRProtocolsMessagePackPackageVersion>
+    <MicrosoftExtensionsOptionsConfigurationExtensionsVersion>2.1.0</MicrosoftExtensionsOptionsConfigurationExtensionsVersion>
 
     <!-- Signing -->
     <MicroBuildCorePackageVersion>0.3.0</MicroBuildCorePackageVersion>

src/Microsoft.Azure.SignalR.Management/Configuration/CascadeOptionsSetup.cs

@@ -0,0 +1,47 @@
+// Copyright (c) Microsoft. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.FileProviders;
+using Microsoft.Extensions.Options;
+using Microsoft.Extensions.Primitives;
+
+namespace Microsoft.Azure.SignalR.Management.Configuration
+{
+    /// <summary>
+    /// Sets up TargetOptions from ServiceManagerOptions and tracks changes .
+    /// </summary>
+    internal abstract class CascadeOptionsSetup<TargetOptions> : IConfigureOptions<TargetOptions>, IOptionsChangeTokenSource<TargetOptions>
+        where TargetOptions : class
+    {
+        private readonly ServiceManagerOptions _initialSource;
+        private readonly IConfiguration _configuration;
+
+        //Making 'configuration' optional avoids error when 'tokenSource' is unavailable.
+        public CascadeOptionsSetup(IOptions<ServiceManagerOptions> initialSource, IConfiguration configuration = null)
+        {
+            _initialSource = initialSource.Value;
+            _configuration = configuration;
+        }
+
+        public string Name => Options.DefaultName;
+
+        public void Configure(TargetOptions target)
+        {
+            if (_configuration == null)
+            {
+                Convert(target, _initialSource);
+            }
+            else
+            {
+                var sourceOption = _configuration.GetSection(ServiceManagerOptions.Section).Get<ServiceManagerOptions>();
+                Convert(target, sourceOption);
+            }
+        }
+
+        protected abstract void Convert(TargetOptions target, ServiceManagerOptions source);
+
+        public IChangeToken GetChangeToken() => _configuration?.GetReloadToken() ?? NullChangeToken.Singleton;
+
+    }
+}

src/Microsoft.Azure.SignalR.Management/ServiceManagerContext.cs → src/Microsoft.Azure.SignalR.Management/Configuration/ServiceManagerContext.cs

@@ -18,16 +18,5 @@ internal class ServiceManagerContext
         public IWebProxy Proxy { get; set; }
 
         public ServiceTransportType ServiceTransportType { get; set; } = ServiceTransportType.Transient;
-
-        public void SetValueFromOptions(ServiceManagerOptions options)
-        {
-            ServiceEndpoints = options.ServiceEndpoints ?? (options.ServiceEndpoint != null
-                    ? (new ServiceEndpoint[] { options.ServiceEndpoint })
-                    : (new ServiceEndpoint[] { new ServiceEndpoint(options.ConnectionString) }));
-            ApplicationName = options.ApplicationName;
-            ConnectionCount = options.ConnectionCount;
-            Proxy = options.Proxy;
-            ServiceTransportType = options.ServiceTransportType;
-        }
     }
-}
+}

src/Microsoft.Azure.SignalR.Management/Configuration/ServiceManagerContextSetup.cs

@@ -0,0 +1,27 @@
+// Copyright (c) Microsoft. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+using Microsoft.Azure.SignalR.Management.Configuration;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.Options;
+
+namespace Microsoft.Azure.SignalR.Management
+{
+    internal class ServiceManagerContextSetup : CascadeOptionsSetup<ServiceManagerContext>
+    {
+        public ServiceManagerContextSetup(IOptions<ServiceManagerOptions> initialSource, IConfiguration configuration = null) : base(initialSource, configuration)
+        {
+        }
+
+        protected override void Convert(ServiceManagerContext target, ServiceManagerOptions source)
+        {
+            target.ServiceEndpoints = source.ServiceEndpoints ?? (source.ServiceEndpoint != null
+                    ? (new ServiceEndpoint[] { source.ServiceEndpoint })
+                    : (new ServiceEndpoint[] { new ServiceEndpoint(source.ConnectionString) }));
+            target.ApplicationName = source.ApplicationName;
+            target.ConnectionCount = source.ConnectionCount;
+            target.Proxy = source.Proxy;
+            target.ServiceTransportType = source.ServiceTransportType;
+        }
+    }
+}

src/Microsoft.Azure.SignalR.Management/ServiceManagerOptions.cs → src/Microsoft.Azure.SignalR.Management/Configuration/ServiceManagerOptions.cs

@@ -3,6 +3,7 @@
 
 using System;
 using System.Net;
+using Microsoft.Extensions.Configuration;
 
 namespace Microsoft.Azure.SignalR.Management
 {
@@ -11,6 +12,11 @@ namespace Microsoft.Azure.SignalR.Management
     /// </summary>
     public class ServiceManagerOptions
     {
+        /// <summary>
+        /// The section name used to get <see cref="ServiceManagerOptions"/> value from <see cref="IConfiguration.GetSection(string)"/>
+        /// </summary>
+        public const string Section = "Azure:SignalR";
+
         /// <summary>
         /// Gets or sets the ApplicationName which will be prefixed to each hub name
         /// </summary>

src/Microsoft.Azure.SignalR.Management/Configuration/ServiceManagerOptionsSetup.cs

@@ -0,0 +1,35 @@
+// Copyright (c) Microsoft. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.FileProviders;
+using Microsoft.Extensions.Options;
+using Microsoft.Extensions.Primitives;
+
+namespace Microsoft.Azure.SignalR.Management.Configuration
+{
+    internal class ServiceManagerOptionsSetup : IConfigureOptions<ServiceManagerOptions>, IOptionsChangeTokenSource<ServiceManagerOptions>
+    {
+        private readonly IConfiguration _configuration;
+
+        public ServiceManagerOptionsSetup(IConfiguration configuration = null)
+        {
+            _configuration = configuration;
+        }
+
+        public string Name => Options.DefaultName;
+
+        public void Configure(ServiceManagerOptions options)
+        {
+            if (_configuration != null)
+            {
+                _configuration.GetSection(ServiceManagerOptions.Section).Bind(options);
+            }
+        }
+
+        public IChangeToken GetChangeToken()
+        {
+            return _configuration?.GetReloadToken() ?? NullChangeToken.Singleton;
+        }
+    }
+}

src/Microsoft.Azure.SignalR.Management/Configuration/ServiceOptionsSetup.cs

@@ -0,0 +1,26 @@
+// Copyright (c) Microsoft. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+using Microsoft.Azure.SignalR.Management.Configuration;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.Options;
+
+namespace Microsoft.Azure.SignalR.Management
+{
+    internal class ServiceOptionsSetup : CascadeOptionsSetup<ServiceOptions>
+    {
+        public ServiceOptionsSetup(IOptions<ServiceManagerOptions> initialSource, IConfiguration configuration = null) : base(initialSource, configuration)
+        {
+        }
+
+        protected override void Convert(ServiceOptions target, ServiceManagerOptions source)
+        {
+            target.ApplicationName = source.ApplicationName;
+            target.Endpoints = source.ServiceEndpoints ?? (source.ServiceEndpoint != null
+                    ? (new ServiceEndpoint[] { source.ServiceEndpoint })
+                    : (new ServiceEndpoint[] { new ServiceEndpoint(source.ConnectionString) }));
+            target.Proxy = source.Proxy;
+            target.ConnectionCount = source.ConnectionCount;
+        }
+    }
+}

src/Microsoft.Azure.SignalR.Management/DependencyInjectionExtensions.cs

@@ -0,0 +1,59 @@
+// Copyright (c) Microsoft. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+using System;
+using System.ComponentModel;
+using System.Reflection;
+using Microsoft.Azure.SignalR.Management.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Options;
+
+namespace Microsoft.Azure.SignalR.Management
+{
+    internal static class DependencyInjectionExtensions //TODO: not ready for public use
+    {
+        /// <summary>
+        /// Adds the essential SignalR Service Manager services to the specified services collection and configures <see cref="ServiceManagerOptions"/> with configuration instance registered in service collection.
+        /// </summary>
+        public static IServiceCollection AddSignalRServiceManager(this IServiceCollection services)
+        {
+            services.AddSingleton<ServiceManagerOptionsSetup>()
+                    .AddSingleton<IConfigureOptions<ServiceManagerOptions>>(sp => sp.GetService<ServiceManagerOptionsSetup>())
+                    .AddSingleton<IOptionsChangeTokenSource<ServiceManagerOptions>>(sp => sp.GetService<ServiceManagerOptionsSetup>());
+            services.PostConfigure<ServiceManagerOptions>(o => o.ValidateOptions());
+            services.AddSingleton<ServiceManagerContextSetup>()
+                    .AddSingleton<IConfigureOptions<ServiceManagerContext>>(sp => sp.GetService<ServiceManagerContextSetup>())
+                    .AddSingleton<IOptionsChangeTokenSource<ServiceManagerContext>>(sp => sp.GetService<ServiceManagerContextSetup>());
+            services.AddSingleton<ServiceOptionsSetup>()
+                    .AddSingleton<IConfigureOptions<ServiceOptions>>(sp => sp.GetService<ServiceOptionsSetup>())
+                    .AddSingleton<IOptionsChangeTokenSource<ServiceOptions>>(sp => sp.GetService<ServiceOptionsSetup>());
+            return services.TrySetProductInfo();
+        }
+
+        /// <summary>
+        /// Adds the essential SignalR Service Manager services to the specified services collection and registers an action used to configure <see cref="ServiceManagerOptions"/>
+        /// </summary>
+        public static IServiceCollection AddSignalRServiceManager(this IServiceCollection services, Action<ServiceManagerOptions> configure)
+        {
+            services.Configure(configure);
+            return services.AddSignalRServiceManager();
+        }
+
+        /// <summary>
+        /// Adds product info to <see cref="ServiceManagerContext"/>
+        /// </summary>
+        /// <returns></returns>
+        [EditorBrowsable(EditorBrowsableState.Never)]
+        public static IServiceCollection WithAssembly(this IServiceCollection services, Assembly assembly)
+        {
+            var productInfo = ProductInfo.GetProductInfo(assembly);
+            return services.Configure<ServiceManagerContext>(o => o.ProductInfo = productInfo);
+        }
+
+        private static IServiceCollection TrySetProductInfo(this IServiceCollection services)
+        {
+            var assembly = Assembly.GetExecutingAssembly();
+            var productInfo = ProductInfo.GetProductInfo(assembly);
+            return services.Configure<ServiceManagerContext>(o => o.ProductInfo = o.ProductInfo ?? productInfo);
+        }
+    }
+}

src/Microsoft.Azure.SignalR.Management/Microsoft.Azure.SignalR.Management.csproj

@@ -32,7 +32,8 @@
   </ItemGroup>
   <ItemGroup Condition=" '$(TargetFramework)' == 'netstandard2.0'">
     <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="$(MicrosoftExtensionsDependencyInjectionPackageVersion)" />
-	<PackageReference Include="Microsoft.Extensions.Http" Version="$(MicrosoftExtensionHttpVersion)" />
+    <PackageReference Include="Microsoft.Extensions.Http" Version="$(MicrosoftExtensionHttpVersion)" />
     <PackageReference Include="Microsoft.AspNetCore.SignalR" Version="$(MicrosoftAspNetCoreSignalRPackageVersion)" />
+    <PackageReference Include="Microsoft.Extensions.Options.ConfigurationExtensions" Version="$(MicrosoftExtensionsOptionsConfigurationExtensionsVersion)" />
   </ItemGroup>
 </Project>

src/Microsoft.Azure.SignalR.Management/ServiceManagerBuilder.cs

@@ -4,32 +4,47 @@
 using System;
 using System.ComponentModel;
 using System.Reflection;
-
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Options;
 namespace Microsoft.Azure.SignalR.Management
 {
     /// <summary>
     /// A builder for configuring <see cref="IServiceManager"/> instances.
     /// </summary>
-    public class ServiceManagerBuilder : IServiceManagerBuilder
+    public class ServiceManagerBuilder : IServiceManagerBuilder, IDisposable
     {
-        private readonly ServiceManagerOptions _options = new ServiceManagerOptions();
+        private readonly IServiceCollection _services = new ServiceCollection();
         private Assembly _assembly;
+        internal ServiceProvider ServiceProvider { get; private set; }
 
         /// <summary>
-        /// Configures the <see cref="IServiceManager"/> instances.
+        /// Registers an action used to configure <see cref="IServiceManager"/>.
         /// </summary>
         /// <param name="configure">A callback to configure the <see cref="IServiceManager"/>.</param>
         /// <returns>The same instance of the <see cref="ServiceManagerBuilder"/> for chaining.</returns>
         public ServiceManagerBuilder WithOptions(Action<ServiceManagerOptions> configure)
         {
-            configure?.Invoke(_options);
+            _services.Configure(configure);
+            return this;
+        }
+
+        /// <summary>
+        /// Registers a configuration instance to configure <see cref="IServiceManager"/>
+        /// </summary>
+        /// <param name="config">The configuration instance.</param>
+        /// <returns>The same instance of the <see cref="ServiceManagerBuilder"/> for chaining.</returns>
+        internal ServiceManagerBuilder WithConfiguration(IConfiguration config)
+        {
+            _services.AddSingleton(config);
             return this;
         }
 
         [EditorBrowsable(EditorBrowsableState.Never)]
         public ServiceManagerBuilder WithCallingAssembly()
         {
             _assembly = Assembly.GetCallingAssembly();
+            _services.WithAssembly(_assembly);
             return this;
         }
 
@@ -39,16 +54,26 @@ public ServiceManagerBuilder WithCallingAssembly()
         /// <returns>The instance of the <see cref="IServiceManager"/>.</returns>
         public IServiceManager Build()
         {
-            _options.ValidateOptions();
+            if (ServiceProvider != null)
+            {
+                throw new InvalidOperationException($"Mulitple invocation of the method is not allowed.");
+            }
 
+            _services.AddSignalRServiceManager();
+            ServiceProvider = _services.BuildServiceProvider();
+            var context = ServiceProvider.GetRequiredService<IOptions<ServiceManagerContext>>().Value;
             var productInfo = ProductInfo.GetProductInfo(_assembly);
-            var context = new ServiceManagerContext()
-            {
-                ProductInfo = productInfo
-            };
-            context.SetValueFromOptions(_options);
             var restClientBuilder = new RestClientFactory(productInfo);
             return new ServiceManager(context, restClientBuilder);
         }
+
+        /// <summary>
+        /// Dispose unmanaged resources accociated with the builder and the instance built from it.
+        /// </summary>
+        public void Dispose()
+        {
+            ServiceProvider?.Dispose();
+            ServiceProvider = null;
+        }
     }
 }