/* ========================================================================
* 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.Tasks;
using Moq;
using NUnit.Framework;
// CA2000: test code; the manager is short-lived and torn down per test.
#pragma warning disable CA2000
namespace Opc.Ua.Server.Tests.NodeManager
{
///
/// Deterministic, offline unit tests for
/// covering the
/// validation, monitoring-mode and unsubscribe branches without spinning
/// up sampling timers.
///
[TestFixture]
[Category("NodeManager")]
[Category("SamplingGroupMonitoredItemManager")]
[Parallelizable(ParallelScope.All)]
public class SamplingGroupMonitoredItemManagerTests
{
private static ApplicationConfiguration CreateConfiguration()
{
return new ApplicationConfiguration
{
ServerConfiguration = new ServerConfiguration
{
MaxNotificationQueueSize = 100,
MaxDurableNotificationQueueSize = 200,
AvailableSamplingRates = new ArrayOf()
}
};
}
private static SamplingGroupMonitoredItemManager CreateManager(
out Mock mockServer,
out ServerSystemContext context)
{
mockServer = DeterministicServerMock.Create(out _);
context = mockServer.Object.DefaultSystemContext;
var mockNodeManager = new Mock();
return new SamplingGroupMonitoredItemManager(
mockNodeManager.Object,
mockServer.Object,
CreateConfiguration());
}
private static Mock CreateItem(uint id)
{
var item = new Mock();
item.SetupGet(m => m.Id).Returns(id);
return item;
}
[Test]
public void DeleteMonitoredItemUnknownIdReturnsBadMonitoredItemIdInvalid()
{
using SamplingGroupMonitoredItemManager manager = CreateManager(out _, out ServerSystemContext ctx);
Mock item = CreateItem(1);
StatusCode result = manager.DeleteMonitoredItem(ctx, item.Object, null!);
Assert.That(result, Is.EqualTo(StatusCodes.BadMonitoredItemIdInvalid));
}
[Test]
public void DeleteMonitoredItemReferenceMismatchReturnsBadMonitoredItemIdInvalid()
{
using SamplingGroupMonitoredItemManager manager = CreateManager(out _, out ServerSystemContext ctx);
Mock existing = CreateItem(1);
manager.MonitoredItems[1] = existing.Object;
Mock other = CreateItem(1);
StatusCode result = manager.DeleteMonitoredItem(ctx, other.Object, null!);
Assert.That(result, Is.EqualTo(StatusCodes.BadMonitoredItemIdInvalid));
}
[Test]
public void DeleteMonitoredItemRemovesOwnedItem()
{
using SamplingGroupMonitoredItemManager manager = CreateManager(out _, out ServerSystemContext ctx);
Mock existing = CreateItem(5);
manager.MonitoredItems[5] = existing.Object;
StatusCode result = manager.DeleteMonitoredItem(ctx, existing.Object, null!);
Assert.That(result, Is.EqualTo(StatusCodes.Good));
Assert.That(manager.MonitoredItems.ContainsKey(5), Is.False);
}
[Test]
public void ModifyMonitoredItemUnknownIdReturnsBadMonitoredItemIdInvalid()
{
using SamplingGroupMonitoredItemManager manager = CreateManager(out _, out ServerSystemContext ctx);
Mock item = CreateItem(1);
ServiceResult? result = manager.ModifyMonitoredItem(
ctx,
DiagnosticsMasks.None,
TimestampsToReturn.Both,
new MonitoringFilter(),
new Range(),
1000.0,
5,
item.Object,
new MonitoredItemModifyRequest());
Assert.That(result, Is.Not.Null);
Assert.That(
result!.StatusCode,
Is.EqualTo(StatusCodes.BadMonitoredItemIdInvalid));
}
[Test]
public void ModifyMonitoredItemReferenceMismatchReturnsBadMonitoredItemIdInvalid()
{
using SamplingGroupMonitoredItemManager manager = CreateManager(out _, out ServerSystemContext ctx);
Mock existing = CreateItem(2);
manager.MonitoredItems[2] = existing.Object;
Mock other = CreateItem(2);
ServiceResult? result = manager.ModifyMonitoredItem(
ctx,
DiagnosticsMasks.None,
TimestampsToReturn.Both,
new MonitoringFilter(),
new Range(),
1000.0,
5,
other.Object,
new MonitoredItemModifyRequest());
Assert.That(result, Is.Not.Null);
Assert.That(
result!.StatusCode,
Is.EqualTo(StatusCodes.BadMonitoredItemIdInvalid));
}
[Test]
public async Task SetMonitoringModeAsyncUnknownIdReturnsBadMonitoredItemIdInvalidAsync()
{
using SamplingGroupMonitoredItemManager manager = CreateManager(out _, out ServerSystemContext ctx);
Mock item = CreateItem(1);
(ServiceResult result, MonitoringMode? previous) = await manager
.SetMonitoringModeAsync(ctx, item.Object, MonitoringMode.Reporting, null!)
.ConfigureAwait(false);
Assert.That(
result.StatusCode,
Is.EqualTo(StatusCodes.BadMonitoredItemIdInvalid));
Assert.That(previous, Is.Null);
}
[Test]
public async Task SetMonitoringModeAsyncReferenceMismatchReturnsBadMonitoredItemIdInvalidAsync()
{
using SamplingGroupMonitoredItemManager manager = CreateManager(out _, out ServerSystemContext ctx);
Mock existing = CreateItem(3);
manager.MonitoredItems[3] = existing.Object;
Mock other = CreateItem(3);
(ServiceResult result, MonitoringMode? previous) = await manager
.SetMonitoringModeAsync(ctx, other.Object, MonitoringMode.Reporting, null!)
.ConfigureAwait(false);
Assert.That(
result.StatusCode,
Is.EqualTo(StatusCodes.BadMonitoredItemIdInvalid));
Assert.That(previous, Is.Null);
}
[Test]
public async Task SetMonitoringModeAsyncEnableFromDisabledQueuesInitialValueAsync()
{
using SamplingGroupMonitoredItemManager manager = CreateManager(out _, out ServerSystemContext ctx);
Mock item = CreateItem(4);
item.Setup(m => m.SetMonitoringMode(MonitoringMode.Reporting))
.Returns(MonitoringMode.Disabled);
item.SetupGet(m => m.ManagerHandle).Returns(new object());
item.SetupGet(m => m.AttributeId).Returns(Attributes.Value);
manager.MonitoredItems[4] = item.Object;
(ServiceResult result, MonitoringMode? previous) = await manager
.SetMonitoringModeAsync(ctx, item.Object, MonitoringMode.Reporting, null!)
.ConfigureAwait(false);
Assert.That(result.StatusCode, Is.EqualTo(StatusCodes.Good));
Assert.That(previous, Is.EqualTo(MonitoringMode.Disabled));
}
[Test]
public async Task SetMonitoringModeAsyncNoInitialValueWhenAlreadyEnabledAsync()
{
using SamplingGroupMonitoredItemManager manager = CreateManager(out _, out ServerSystemContext ctx);
Mock item = CreateItem(6);
item.Setup(m => m.SetMonitoringMode(MonitoringMode.Reporting))
.Returns(MonitoringMode.Sampling);
manager.MonitoredItems[6] = item.Object;
(ServiceResult result, MonitoringMode? previous) = await manager
.SetMonitoringModeAsync(ctx, item.Object, MonitoringMode.Reporting, null!)
.ConfigureAwait(false);
Assert.That(result.StatusCode, Is.EqualTo(StatusCodes.Good));
Assert.That(previous, Is.EqualTo(MonitoringMode.Sampling));
}
[Test]
public void SubscribeToEventsUnsubscribeUnknownNodeReturnsBadNodeIdUnknown()
{
using SamplingGroupMonitoredItemManager manager = CreateManager(out _, out ServerSystemContext ctx);
var source = new BaseObjectState(null)
{
NodeId = new NodeId("EventSource", 3)
};
var monitoredItem = new Mock();
(MonitoredNode2? node, ServiceResult result) = manager.SubscribeToEvents(
ctx, source, monitoredItem.Object, true);
Assert.That(node, Is.Null);
Assert.That(
result.StatusCode,
Is.EqualTo(StatusCodes.BadNodeIdUnknown));
}
[Test]
public void SubscribeToEventsUnsubscribeKeepsLinkedItemAndDisposesLastNode()
{
using SamplingGroupMonitoredItemManager manager = CreateManager(out _, out ServerSystemContext ctx);
var first = new BaseObjectState(null)
{
NodeId = new NodeId("Notifier1", 3),
EventNotifier = EventNotifiers.SubscribeToEvents
};
var second = new BaseObjectState(null)
{
NodeId = new NodeId("Notifier2", 3),
EventNotifier = EventNotifiers.SubscribeToEvents
};
var monitoredItem = new Mock();
monitoredItem.SetupGet(m => m.Id).Returns(7);
monitoredItem.SetupGet(m => m.MonitoringAllEvents).Returns(true);
(MonitoredNode2? firstNode, _) = manager.SubscribeToEvents(ctx, first, monitoredItem.Object, false);
(MonitoredNode2? secondNode, _) = manager.SubscribeToEvents(ctx, second, monitoredItem.Object, false);
(_, ServiceResult result) = manager.SubscribeToEvents(ctx, first, monitoredItem.Object, true);
Assert.That(result.StatusCode, Is.EqualTo(StatusCodes.Good));
Assert.That(manager.MonitoredItems.ContainsKey(7), Is.True);
Assert.That(manager.MonitoredNodes.ContainsKey(first.NodeId), Is.False);
Assert.That(
() => firstNode!.Add(monitoredItem.Object),
Throws.TypeOf());
(_, result) = manager.SubscribeToEvents(ctx, second, monitoredItem.Object, true);
Assert.That(result.StatusCode, Is.EqualTo(StatusCodes.Good));
Assert.That(manager.MonitoredItems.ContainsKey(7), Is.False);
Assert.That(
() => secondNode!.Add(monitoredItem.Object),
Throws.TypeOf());
}
///
/// Only an all-events item can be linked to several notifiers, so unsubscribing any other
/// event item releases it without scanning the other monitored nodes for links.
///
[Test]
public void SubscribeToEventsUnsubscribeReleasesNonAllEventsItemWithoutLinkScan()
{
using SamplingGroupMonitoredItemManager manager = CreateManager(out _, out ServerSystemContext ctx);
var first = new BaseObjectState(null)
{
NodeId = new NodeId("Notifier1", 3),
EventNotifier = EventNotifiers.SubscribeToEvents
};
var second = new BaseObjectState(null)
{
NodeId = new NodeId("Notifier2", 3),
EventNotifier = EventNotifiers.SubscribeToEvents
};
var monitoredItem = new Mock();
monitoredItem.SetupGet(m => m.Id).Returns(8);
monitoredItem.SetupGet(m => m.MonitoringAllEvents).Returns(false);
manager.SubscribeToEvents(ctx, first, monitoredItem.Object, false);
manager.SubscribeToEvents(ctx, second, monitoredItem.Object, false);
(_, ServiceResult result) = manager.SubscribeToEvents(ctx, first, monitoredItem.Object, true);
Assert.That(result.StatusCode, Is.EqualTo(StatusCodes.Good));
Assert.That(manager.MonitoredItems.ContainsKey(8), Is.False);
Assert.That(manager.MonitoredNodes.ContainsKey(second.NodeId), Is.True);
}
}
}