Implement LmxOpcUa server — all 6 phases complete

Full OPC UA server on .NET Framework 4.8 (x86) exposing AVEVA System Platform Galaxy tags via MXAccess. Mirrors Galaxy object hierarchy as OPC UA address space, translating contained-name browse paths to tag-name runtime references. Components implemented: - Configuration: AppConfiguration with 4 sections, validator - Domain: ConnectionState, Quality, Vtq, MxDataTypeMapper, error codes - MxAccess: StaComThread, MxAccessClient (partial classes), MxProxyAdapter using strongly-typed ArchestrA.MxAccess COM interop - Galaxy Repository: SQL queries (hierarchy, attributes, change detection), ChangeDetectionService with auto-rebuild on deploy - OPC UA Server: LmxNodeManager (CustomNodeManager2), LmxOpcUaServer, OpcUaServerHost with programmatic config, SecurityPolicy None - Status Dashboard: HTTP server with HTML/JSON/health endpoints - Integration: Full 14-step startup, graceful shutdown, component wiring 175 tests (174 unit + 1 integration), all passing. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-25 05:55:27 -04:00
commit a7576ffb38
283 changed files with 16493 additions and 0 deletions
--- a/tests/ZB.MOM.WW.LmxOpcUa.Tests/MxAccess/MxAccessClientConnectionTests.cs
+++ b/tests/ZB.MOM.WW.LmxOpcUa.Tests/MxAccess/MxAccessClientConnectionTests.cs
@@ -0,0 +1,110 @@
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using Shouldly;
+using Xunit;
+using ZB.MOM.WW.LmxOpcUa.Host.Configuration;
+using ZB.MOM.WW.LmxOpcUa.Host.Domain;
+using ZB.MOM.WW.LmxOpcUa.Host.Metrics;
+using ZB.MOM.WW.LmxOpcUa.Host.MxAccess;
+using ZB.MOM.WW.LmxOpcUa.Tests.Helpers;
+
+namespace ZB.MOM.WW.LmxOpcUa.Tests.MxAccess
+{
+    public class MxAccessClientConnectionTests : IDisposable
+    {
+        private readonly StaComThread _staThread;
+        private readonly FakeMxProxy _proxy;
+        private readonly PerformanceMetrics _metrics;
+        private readonly MxAccessClient _client;
+        private readonly List<(ConnectionState Previous, ConnectionState Current)> _stateChanges = new();
+
+        public MxAccessClientConnectionTests()
+        {
+            _staThread = new StaComThread();
+            _staThread.Start();
+            _proxy = new FakeMxProxy();
+            _metrics = new PerformanceMetrics();
+            var config = new MxAccessConfiguration();
+            _client = new MxAccessClient(_staThread, _proxy, config, _metrics);
+            _client.ConnectionStateChanged += (_, e) => _stateChanges.Add((e.PreviousState, e.CurrentState));
+        }
+
+        public void Dispose()
+        {
+            _client.Dispose();
+            _staThread.Dispose();
+            _metrics.Dispose();
+        }
+
+        [Fact]
+        public void InitialState_IsDisconnected()
+        {
+            _client.State.ShouldBe(ConnectionState.Disconnected);
+        }
+
+        [Fact]
+        public async Task Connect_TransitionsToConnected()
+        {
+            await _client.ConnectAsync();
+
+            _client.State.ShouldBe(ConnectionState.Connected);
+            _stateChanges.ShouldContain(s => s.Previous == ConnectionState.Disconnected && s.Current == ConnectionState.Connecting);
+            _stateChanges.ShouldContain(s => s.Previous == ConnectionState.Connecting && s.Current == ConnectionState.Connected);
+        }
+
+        [Fact]
+        public async Task Connect_RegistersCalled()
+        {
+            await _client.ConnectAsync();
+            _proxy.RegisterCallCount.ShouldBe(1);
+        }
+
+        [Fact]
+        public async Task Disconnect_TransitionsToDisconnected()
+        {
+            await _client.ConnectAsync();
+            await _client.DisconnectAsync();
+
+            _client.State.ShouldBe(ConnectionState.Disconnected);
+            _stateChanges.ShouldContain(s => s.Current == ConnectionState.Disconnecting);
+            _stateChanges.ShouldContain(s => s.Current == ConnectionState.Disconnected);
+        }
+
+        [Fact]
+        public async Task Disconnect_UnregistersCalled()
+        {
+            await _client.ConnectAsync();
+            await _client.DisconnectAsync();
+            _proxy.UnregisterCallCount.ShouldBe(1);
+        }
+
+        [Fact]
+        public async Task ConnectFails_TransitionsToError()
+        {
+            _proxy.ShouldFailRegister = true;
+
+            await Should.ThrowAsync<InvalidOperationException>(_client.ConnectAsync());
+            _client.State.ShouldBe(ConnectionState.Error);
+        }
+
+        [Fact]
+        public async Task DoubleConnect_NoOp()
+        {
+            await _client.ConnectAsync();
+            await _client.ConnectAsync(); // Should be no-op
+            _proxy.RegisterCallCount.ShouldBe(1);
+        }
+
+        [Fact]
+        public async Task Reconnect_IncrementsCount()
+        {
+            await _client.ConnectAsync();
+            _client.ReconnectCount.ShouldBe(0);
+
+            await _client.ReconnectAsync();
+            _client.ReconnectCount.ShouldBe(1);
+            _client.State.ShouldBe(ConnectionState.Connected);
+        }
+    }
+}