feat: 增加 BootstrapBlazorRootRegisterService 服务

Author: ArgoZhang

src/BootstrapBlazor/Extensions/BootstrapBlazorServiceCollectionExtensions.cs

@@ -36,6 +36,9 @@ public static IServiceCollection AddBootstrapBlazor(this IServiceCollection serv
         services.TryAddSingleton<IZipArchiveService, DefaultZipArchiveService>();
         services.TryAddSingleton(typeof(IDispatchService<>), typeof(DefaultDispatchService<>));
 
+        // BootstrapBlazorRootRegisterService 服务
+        services.AddScoped<BootstrapBlazorRootRegisterService>();
+
         // Html2Pdf 服务
         services.TryAddSingleton<IHtml2Pdf, DefaultHtml2PdfService>();
 

src/BootstrapBlazor/Services/BootstrapBlazorRootRegisterService.cs

@@ -0,0 +1,130 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the Apache 2.0 License
+// See the LICENSE file in the project root for more information.
+// Maintainer: Argo Zhang([email protected]) Website: https://www.blazor.zone
+
+namespace BootstrapBlazor.Components;
+
+/// <summary>
+/// BootstrapBlazorRootRegisterService
+/// </summary>
+public class BootstrapBlazorRootRegisterService
+{
+    private readonly Dictionary<object, BootstrapBlazorRootOutlet> _subscribersByIdentifier = [];
+    private readonly Dictionary<object, List<BootstrapBlazorRootContent>> _providersByIdentifier = [];
+
+    /// <summary>
+    /// add provider
+    /// </summary>
+    /// <param name="identifier"></param>
+    /// <param name="provider"></param>
+    public void AddProvider(object identifier, BootstrapBlazorRootContent provider)
+    {
+        if (!_providersByIdentifier.TryGetValue(identifier, out var providers))
+        {
+            providers = [];
+            _providersByIdentifier.Add(identifier, providers);
+        }
+
+        providers.Add(provider);
+    }
+
+    /// <summary>
+    /// remove provider
+    /// </summary>
+    /// <param name="identifier"></param>
+    /// <param name="provider"></param>
+    public void RemoveProvider(object identifier, BootstrapBlazorRootContent provider)
+    {
+        if (!_providersByIdentifier.TryGetValue(identifier, out var providers))
+        {
+            throw new InvalidOperationException($"There are no content providers with the given root ID '{identifier}'.");
+        }
+
+        var index = providers.LastIndexOf(provider);
+        if (index < 0)
+        {
+            throw new InvalidOperationException($"The provider was not found in the providers list of the given root ID '{identifier}'.");
+        }
+
+        providers.RemoveAt(index);
+        if (index == providers.Count)
+        {
+            // We just removed the most recently added provider, meaning we need to change
+            // the current content to that of second most recently added provider.
+            var contentProvider = GetCurrentProviderContentOrDefault(providers);
+            NotifyContentChangedForSubscriber(identifier, contentProvider);
+        }
+    }
+
+    /// <summary>
+    /// get all providers by identifier
+    /// </summary>
+    /// <param name="identifier"></param>
+    /// <returns></returns>
+    public List<BootstrapBlazorRootContent> GetProviders(object identifier)
+    {
+        _providersByIdentifier.TryGetValue(identifier, out var providers);
+        return providers ?? [];
+    }
+
+    /// <summary>
+    /// subscribe
+    /// </summary>
+    /// <param name="identifier"></param>
+    /// <param name="subscriber"></param>
+    public void Subscribe(object identifier, BootstrapBlazorRootOutlet subscriber)
+    {
+        if (_subscribersByIdentifier.ContainsKey(identifier))
+        {
+            throw new InvalidOperationException($"There is already a subscriber to the content with the given root ID '{identifier}'.");
+        }
+
+        _subscribersByIdentifier.Add(identifier, subscriber);
+    }
+
+    /// <summary>
+    /// 取消订阅
+    /// </summary>
+    /// <param name="identifier"></param>
+    public void Unsubscribe(object identifier)
+    {
+        if (!_subscribersByIdentifier.Remove(identifier))
+        {
+            throw new InvalidOperationException($"The subscriber with the given root ID '{identifier}' is already unsubscribed.");
+        }
+    }
+
+    /// <summary>
+    /// Notify content provider changed
+    /// </summary>
+    /// <param name="identifier"></param>
+    /// <param name="provider"></param>
+    public void NotifyContentProviderChanged(object identifier, BootstrapBlazorRootContent provider)
+    {
+        if (!_providersByIdentifier.TryGetValue(identifier, out var providers))
+        {
+            throw new InvalidOperationException($"There are no content providers with the given root ID '{identifier}'.");
+        }
+
+        // We only notify content changed for subscribers when the content of the
+        // most recently added provider changes.
+        if (providers.Count != 0 && providers[^1] == provider)
+        {
+            NotifyContentChangedForSubscriber(identifier, provider);
+        }
+    }
+
+    private static BootstrapBlazorRootContent? GetCurrentProviderContentOrDefault(List<BootstrapBlazorRootContent> providers)
+        => providers.Count != 0
+            ? providers[^1]
+            : null;
+
+    private void NotifyContentChangedForSubscriber(object identifier, BootstrapBlazorRootContent? provider)
+    {
+        if (_subscribersByIdentifier.TryGetValue(identifier, out var subscriber))
+        {
+            subscriber.ContentUpdated(provider);
+        }
+    }
+}