feat(historian): backend registry, ServerHistorian:Backend, Host wiring via provider

Claude-Session: https://claude.ai/code/session_01Ef2ozxS7QPanGT8uoATbTe
2026-10-09 13:05:53 -04:00
parent 65e6352dad
commit 31d342eff3
7 changed files with 186 additions and 9 deletions
@@ -0,0 +1,62 @@
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Options;
+using Shouldly;
+using Xunit;
+using ZB.MOM.WW.OtOpcUa.Driver.Historian.Gateway;
+using ZB.MOM.WW.OtOpcUa.Driver.Historian.Gateway.Recorder;
+using ZB.MOM.WW.OtOpcUa.Host.Configuration;
+using ZB.MOM.WW.OtOpcUa.Runtime.Historian;
+
+namespace ZB.MOM.WW.OtOpcUa.Host.Tests.Configuration;
+
+public sealed class HistorianBackendRegistryTests
+{
+    private static readonly IConfiguration Cfg = new ConfigurationBuilder().Build();
+
+    private static ServerHistorianOptions Gateway(string backend = "Gateway") => new()
+    {
+        Backend = backend, Enabled = true, Endpoint = "http://localhost:5222", ApiKey = "histgw_id_secret", UseTls = false,
+    };
+
+    [Fact]
+    public void Default_backend_is_Gateway_and_resolves_the_gateway_provider()
+    {
+        new ServerHistorianOptions().Backend.ShouldBe("Gateway");
+        HistorianBackendRegistry.Resolve(new ServerHistorianOptions(), Cfg).ShouldBeOfType<GatewayHistorianProvider>();
+    }
+
+    [Theory]
+    [InlineData("gateway")]
+    [InlineData("GATEWAY")]
+    [InlineData("Gateway")]
+    public void Resolve_is_case_insensitive(string name) =>
+        HistorianBackendRegistry.Resolve(Gateway(name), Cfg).Name.ShouldBe("Gateway");
+
+    [Fact]
+    public void Unknown_backend_throws_naming_the_value_and_the_allowed_names()
+    {
+        var ex = Should.Throw<OptionsValidationException>(
+            () => HistorianBackendRegistry.Resolve(Gateway("Nope"), Cfg));
+        var msg = string.Join(" ", ex.Failures);
+        msg.ShouldContain("Nope");
+        msg.ShouldContain("Gateway");
+        msg.ShouldContain("ServerHistorian:Backend");
+    }
+
+    [Fact]
+    public void KnownBackends_lists_Gateway() => HistorianBackendRegistry.KnownBackends.ShouldContain("Gateway");
+
+    [Fact]
+    public void Gateway_provider_builds_the_same_concrete_seams_Program_used_to_build()
+    {
+        var sp = new ServiceCollection().BuildServiceProvider();
+        var p = HistorianBackendRegistry.Resolve(Gateway(), Cfg);
+
+        p.CreateDataSource(sp).ShouldBeOfType<GatewayHistorianDataSource>();
+        p.CreateValueWriter(sp).ShouldBeOfType<GatewayHistorianValueWriter>();
+        p.CreateAlarmWriter(sp).ShouldBeOfType<GatewayAlarmHistorianWriter>();
+        p.CreateProvisioning(sp).ShouldBeOfType<GatewayTagProvisioner>();
+        p.CreateUpdater(sp).ShouldBeNull();
+    }
+}