feat(sphistorianclient): port SDK source + tests, rebrand namespace to ZB.MOM.WW.SPHistorianClient

2026-06-19 05:45:06 -04:00
parent 965f5006f2
commit 63cddfb65b
105 changed files with 11454 additions and 0 deletions
@@ -0,0 +1,105 @@
+using System.Reflection;
+using System.ServiceModel;
+using ZB.MOM.WW.SPHistorianClient.Wcf;
+using ZB.MOM.WW.SPHistorianClient.Wcf.Contracts;
+
+namespace ZB.MOM.WW.SPHistorianClient.Tests;
+
+public sealed class WcfEvidenceTests
+{
+    [Fact]
+    public void ServiceContractsUseDecompiledNamesAndNamespace()
+    {
+        AssertServiceContract<IHistoryServiceContract>("Hist");
+        AssertServiceContract<IHistoryServiceContract2>("Hist");
+        AssertServiceContract<IRetrievalServiceContract>("Retr");
+        AssertServiceContract<IRetrievalServiceContract4>("Retr");
+        AssertServiceContract<IStatusServiceContract>("Stat");
+        AssertServiceContract<IStatusServiceContract2>("Stat");
+        AssertServiceContract<IStorageServiceContract>("Storage");
+        AssertServiceContract<ITransactionServiceContract>("Trx");
+    }
+
+    [Fact]
+    public void RelayEvidenceIdentifiesHistorySecurityEndpointNames()
+    {
+        Assert.Equal("HistCert", HistorianWcfServiceNames.HistoryCertificate);
+        Assert.Equal("Hist-Integrated", HistorianWcfServiceNames.HistoryIntegrated);
+    }
+
+    [Fact]
+    public void KnownOperationAliasesMatchManagedWrapperEvidence()
+    {
+        AssertOperation<IHistoryServiceContract>(nameof(IHistoryServiceContract.GetInterfaceVersion), "GetV");
+        AssertOperation<IHistoryServiceContract>(nameof(IHistoryServiceContract.OpenConnection), "Open");
+        AssertOperation<IHistoryServiceContract>(nameof(IHistoryServiceContract.ValidateClient), "VldC");
+        AssertOperation<IHistoryServiceContract>(nameof(IHistoryServiceContract.UpdateClientStatus), "UpdC");
+        AssertOperation<IHistoryServiceContract2>(nameof(IHistoryServiceContract2.OpenConnection2), "Open2");
+        AssertOperation<IHistoryServiceContract2>(nameof(IHistoryServiceContract2.ExchangeKey), "ExKey");
+        AssertOperation<IRetrievalServiceContract2>(nameof(IRetrievalServiceContract2.GetTagInfosFromId), "GetTg");
+        AssertOperation<IRetrievalServiceContract3>(nameof(IRetrievalServiceContract3.StartTagQuery), "QTB");
+        AssertOperation<IRetrievalServiceContract4>(nameof(IRetrievalServiceContract4.GetTagExtendedPropertiesFromName), "GetTepByNm");
+        AssertOperation<IStorageServiceContract>(nameof(IStorageServiceContract.OpenStorageConnection), "Open");
+        AssertOperation<IStorageServiceContract>(nameof(IStorageServiceContract.LoadBlocks), "LoadB");
+        AssertOperation<ITransactionServiceContract>(nameof(ITransactionServiceContract.GetInterfaceVersion), "GetV");
+        AssertDefaultOperation<IRetrievalServiceContract>(nameof(IRetrievalServiceContract.StartQuery));
+        AssertDefaultOperation<IRetrievalServiceContract4>(nameof(IRetrievalServiceContract4.StartEventQuery));
+        AssertDefaultOperation<IStatusServiceContract>(nameof(IStatusServiceContract.GetServerTime));
+        AssertDefaultOperation<IStatusServiceContract2>(nameof(IStatusServiceContract2.GetSystemParameter));
+        AssertOperation<IStatusServiceContract2>(nameof(IStatusServiceContract2.GetHistorianInfo), "GETHI");
+        AssertOperation<IStatusServiceContract2>(nameof(IStatusServiceContract2.PingServer), "PNGS");
+        AssertOperation<IStatusServiceContract2>(nameof(IStatusServiceContract2.PingPipe), "PNGP");
+    }
+
+    [Fact]
+    public void MdasBindingUsesNetTcpAndCustomContentType()
+    {
+        var binding = HistorianWcfBindingFactory.CreateMdasNetTcpBinding(TimeSpan.FromSeconds(5));
+        var encoder = binding.CreateBindingElements().Find<MdasMessageEncodingBindingElement>();
+        var endpoint = HistorianWcfBindingFactory.CreateEndpointAddress("localhost", HistorianWcfBindingFactory.DefaultPort, HistorianWcfServiceNames.History);
+
+        Assert.NotNull(encoder);
+        Assert.Equal("net.tcp://localhost:32568/Hist", endpoint.Uri.AbsoluteUri);
+        Assert.Equal(MdasMessageEncoder.MdasContentType, encoder.CreateMessageEncoderFactory().Encoder.ContentType);
+    }
+
+    [Fact]
+    public void CertificateBindingUsesMdasEncodingOverTransportSecurity()
+    {
+        var binding = HistorianWcfBindingFactory.CreateMdasNetTcpCertificateBinding(TimeSpan.FromSeconds(5));
+        var elements = binding.CreateBindingElements();
+        var encoder = elements.Find<MdasMessageEncodingBindingElement>();
+        var security = elements.Find<System.ServiceModel.Channels.SslStreamSecurityBindingElement>();
+
+        Assert.NotNull(encoder);
+        Assert.NotNull(security);
+        Assert.Equal(MdasMessageEncoder.MdasContentType, encoder.CreateMessageEncoderFactory().Encoder.ContentType);
+    }
+
+    private static void AssertServiceContract<TContract>(string name)
+    {
+        var attribute = typeof(TContract).GetCustomAttribute<ServiceContractAttribute>();
+
+        Assert.NotNull(attribute);
+        Assert.Equal(name, attribute.Name);
+        Assert.Equal("aa", attribute.Namespace);
+    }
+
+    private static void AssertOperation<TContract>(string methodName, string operationName)
+    {
+        var method = typeof(TContract).GetMethod(methodName);
+        var attribute = method?.GetCustomAttribute<OperationContractAttribute>();
+
+        Assert.NotNull(attribute);
+        Assert.Equal(operationName, attribute.Name);
+    }
+
+    private static void AssertDefaultOperation<TContract>(string methodName)
+    {
+        var method = typeof(TContract).GetMethod(methodName);
+        var attribute = method?.GetCustomAttribute<OperationContractAttribute>();
+
+        Assert.NotNull(attribute);
+        Assert.Null(attribute.Name);
+    }
+}