/* ======================================================================== * Copyright (c) 2005-2025 The OPC Foundation, Inc. All rights reserved. * * OPC Foundation MIT License 1.00 * * Permission is hereby granted, free of charge, to any person * obtaining a copy of this software and associated documentation * files (the "Software"), to deal in the Software without * restriction, including without limitation the rights to use, * copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the * Software is furnished to do so, subject to the following * conditions: * * The above copyright notice and this permission notice shall be * included in all copies or substantial portions of the Software. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR * OTHER DEALINGS IN THE SOFTWARE. * * The complete license agreement can be found here: * http://opcfoundation.org/License/MIT/1.00/ * ======================================================================*/ using System; using System.Threading; using System.Threading.Tasks; using BenchmarkDotNet.Attributes; using Microsoft.Extensions.Logging; using Moq; using NUnit.Framework; using Opc.Ua.Client.TestFramework; namespace Opc.Ua.Client.ComplexTypes.Tests { /// /// Node cache resolver tests. /// [TestFixture] [Category("Client")] [SetCulture("en-us")] [SetUICulture("en-us")] [TestFixtureSource(nameof(FixtureArgs))] [MemoryDiagnoser] [DisassemblyDiagnoser] public class NodeCacheResolverTests : ClientTestFramework { public NodeCacheResolverTests() : base(Utils.UriSchemeOpcTcp) { } public NodeCacheResolverTests(string uriScheme = Utils.UriSchemeOpcTcp) : base(uriScheme) { } public static readonly NodeId[] TypeSystems = [ ObjectIds.OPCBinarySchema_TypeSystem, ObjectIds.XmlSchema_TypeSystem ]; /// /// Set up a Server and a Client instance. /// [OneTimeSetUp] public override Task OneTimeSetUpAsync() { SupportsExternalServerUrl = true; return base.OneTimeSetUpAsync(); } /// /// Tear down the Server and the Client. /// [OneTimeTearDown] public override Task OneTimeTearDownAsync() { return base.OneTimeTearDownAsync(); } /// /// Test setup. /// [SetUp] public override Task SetUpAsync() { return base.SetUpAsync(); } /// /// Test teardown. /// [TearDown] public override Task TearDownAsync() { return base.TearDownAsync(); } [Test] [Order(100)] public async Task LoadStandardDataTypeSystemAsync() { var nodeResolver = new NodeCacheResolver(Session, Telemetry); ServiceResultException sre = Assert .ThrowsAsync(async () => { System.Collections.Generic.IReadOnlyDictionary t = await nodeResolver .LoadDataTypeSystem(ObjectIds.ObjectAttributes_Encoding_DefaultBinary) .ConfigureAwait(false); }); Assert.That(sre.StatusCode, Is.EqualTo(StatusCodes.BadNodeIdInvalid)); System.Collections.Generic.IReadOnlyDictionary typeSystem = await nodeResolver .LoadDataTypeSystem() .ConfigureAwait(false); Assert.That(typeSystem, Is.Not.Null); typeSystem = await nodeResolver .LoadDataTypeSystem(ObjectIds.OPCBinarySchema_TypeSystem) .ConfigureAwait(false); Assert.That(typeSystem, Is.Not.Null); typeSystem = await nodeResolver.LoadDataTypeSystem(ObjectIds.XmlSchema_TypeSystem) .ConfigureAwait(false); Assert.That(typeSystem, Is.Not.Null); } [Test] public async Task LoadDataTypesAsyncStopsOnCyclicSubtypeGraphAsync() { var root = new NodeId("Root", 2); var childA = new NodeId("A", 2); var childB = new NodeId("B", 2); var nodeCache = new Mock(MockBehavior.Strict); nodeCache.SetupGet(x => x.NamespaceUris).Returns(Session.NamespaceUris); nodeCache.Setup(x => x.GetReferencesAsync( It.IsAny>(), It.IsAny>(), false, false, It.IsAny())) .Returns((ArrayOf ids, ArrayOf _, bool _, bool _, CancellationToken _) => { var result = new System.Collections.Generic.List(); foreach (NodeId nodeId in ids) { if (nodeId == root) { result.Add(new Node { NodeId = childA, BrowseName = new QualifiedName("A") }); } else if (nodeId == childA) { result.Add(new Node { NodeId = childB, BrowseName = new QualifiedName("B") }); } else if (nodeId == childB) { result.Add(new Node { NodeId = childA, BrowseName = new QualifiedName("A") }); } } return new ValueTask>( new ArrayOf(result.ToArray().AsMemory())); }); var nodeResolver = new NodeCacheResolver(Session, nodeCache.Object, Telemetry); ArrayOf dataTypes = await nodeResolver.LoadDataTypesAsync( NodeId.ToExpandedNodeId(root, Session.NamespaceUris), nestedSubTypes: true, filterUATypes: false, ct: CancellationToken.None).ConfigureAwait(false); Assert.That(dataTypes.Count, Is.EqualTo(2)); Assert.That(dataTypes[0].BrowseName.Name, Is.EqualTo("A")); Assert.That(dataTypes[1].BrowseName.Name, Is.EqualTo("B")); } [Test] public async Task GetEnumTypeArrayAsyncUsesNamedPropertyAsync() { var typeId = new NodeId("MyEnum", 2); var unrelatedPropertyId = new NodeId("NodeVersion", 2); var enumValuesPropertyId = new NodeId("EnumValues", 2); var expected = new ArrayOf(); var nodeCache = new Mock(MockBehavior.Strict); nodeCache.SetupGet(x => x.NamespaceUris).Returns(Session.NamespaceUris); nodeCache.Setup(x => x.GetReferencesAsync( typeId, ReferenceTypeIds.HasProperty, false, false, It.IsAny())) .Returns(new ValueTask>(new ArrayOf( new INode[] { new Node { NodeId = unrelatedPropertyId, BrowseName = new QualifiedName("NodeVersion") }, new Node { NodeId = enumValuesPropertyId, BrowseName = new QualifiedName("EnumValues") } }.AsMemory()))); nodeCache.Setup(x => x.GetValueAsync( enumValuesPropertyId, It.IsAny())) .Returns(new ValueTask(new DataValue(new Variant(expected)))); var resolver = new NodeCacheResolver(Session, nodeCache.Object, Telemetry); Variant result = await resolver.GetEnumTypeArrayAsync( NodeId.ToExpandedNodeId(typeId, Session.NamespaceUris), CancellationToken.None).ConfigureAwait(false); Assert.That(result.TryGetValue(out ArrayOf actual), Is.True); Assert.That(actual, Is.EqualTo(expected)); } [Test] [Order(110)] [TestCaseSource(nameof(TypeSystems))] public async Task LoadAllServerDataTypeSystemsAsync(NodeId dataTypeSystem) { // find the dictionary for the description. var browser = new Browser(Session) { BrowseDirection = BrowseDirection.Forward, ReferenceTypeId = ReferenceTypeIds.HasComponent, IncludeSubtypes = false, NodeClassMask = 0 }; ArrayOf references = await browser.BrowseAsync(dataTypeSystem).ConfigureAwait(false); Assert.That(references.IsNull, Is.False); ILogger logger = Telemetry.CreateLogger(); if (logger.IsEnabled(LogLevel.Information)) { logger.LogInformation(" Found {Count} references", references.Count); } // read all type dictionaries in the type system var nodeResolver = new NodeCacheResolver(Session, Telemetry); foreach (ReferenceDescription r in references.ToList()) { var dictionaryId = ExpandedNodeId.ToNodeId(r.NodeId, Session.NamespaceUris); if (logger.IsEnabled(LogLevel.Information)) { logger.LogInformation(" ReadDictionary {Name} {Id}", r.BrowseName.Name, dictionaryId); } DataDictionary dictionaryToLoad = await nodeResolver .LoadDictionaryAsync(dictionaryId, r.BrowseName.Name!) .ConfigureAwait(false); // internal API for testing only byte[] dictionary = await nodeResolver.ReadDictionaryAsync(dictionaryId) .ConfigureAwait(false); dictionaryToLoad.Validate(dictionary, true, logger); } } } }