Turns the Phase 6.1 Stream B.4 pure-logic ScheduledRecycleScheduler (shipped in PR #79) into a running background feature. A Tier C driver registers its scheduler at startup; the hosted service ticks every TickInterval (default 1 min) and invokes TickAsync on each registered scheduler. Server.Hosting: - ScheduledRecycleHostedService : BackgroundService. AddScheduler(s) must be called before StartAsync — registering post-start throws InvalidOperationException to avoid "some ticks saw my scheduler, some didn't" races. ExecuteAsync loops on Task.Delay(TickInterval, _timeProvider, stoppingToken) + delegates to a public TickOnceAsync method for one tick. - TickOnceAsync extracted as the unit-of-work so tests drive it directly without needing to synchronize with FakeTimeProvider + BackgroundService timing semantics. - Exception isolation: if one scheduler throws, the loop logs + continues to the next scheduler. A flaky supervisor can't take down the tick for every other Tier C driver. - Diagnostics: TickCount + SchedulerCount properties for tests + logs. Tests (7 new ScheduledRecycleHostedServiceTests, all pass): - TickOnce before interval doesn't fire; TickCount still advances. - TickOnce at/after interval fires the underlying scheduler exactly once. - Multiple ticks accumulate count. - AddScheduler after StartAsync throws. - Throwing scheduler doesn't poison its neighbours (logs + continues). - SchedulerCount matches registrations. - Empty scheduler list ticks cleanly (no-op + counter advances). Full solution dotnet test: 1193 passing (was 1186, +7). Pre-existing Client.CLI Subscribe flake unchanged. Production wiring (Program.cs): builder.Services.AddSingleton<ScheduledRecycleHostedService>(); builder.Services.AddHostedService(sp => sp.GetRequiredService<ScheduledRecycleHostedService>()); // During DI configuration, once Tier C drivers + their ScheduledRecycleSchedulers // are resolved, call host.AddScheduler(scheduler) for each. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
153 lines
5.5 KiB
C#
153 lines
5.5 KiB
C#
using Microsoft.Extensions.Logging.Abstractions;
|
|
using Shouldly;
|
|
using Xunit;
|
|
using ZB.MOM.WW.OtOpcUa.Core.Abstractions;
|
|
using ZB.MOM.WW.OtOpcUa.Core.Stability;
|
|
using ZB.MOM.WW.OtOpcUa.Server.Hosting;
|
|
|
|
namespace ZB.MOM.WW.OtOpcUa.Server.Tests;
|
|
|
|
[Trait("Category", "Unit")]
|
|
public sealed class ScheduledRecycleHostedServiceTests
|
|
{
|
|
private static readonly DateTime T0 = new(2026, 4, 19, 0, 0, 0, DateTimeKind.Utc);
|
|
|
|
private sealed class FakeClock : TimeProvider
|
|
{
|
|
public DateTime Utc { get; set; } = T0;
|
|
public override DateTimeOffset GetUtcNow() => new(Utc, TimeSpan.Zero);
|
|
}
|
|
|
|
private sealed class FakeSupervisor : IDriverSupervisor
|
|
{
|
|
public string DriverInstanceId => "tier-c-fake";
|
|
public int RecycleCount { get; private set; }
|
|
public Task RecycleAsync(string reason, CancellationToken cancellationToken)
|
|
{
|
|
RecycleCount++;
|
|
return Task.CompletedTask;
|
|
}
|
|
}
|
|
|
|
private sealed class ThrowingSupervisor : IDriverSupervisor
|
|
{
|
|
public string DriverInstanceId => "tier-c-throws";
|
|
public Task RecycleAsync(string reason, CancellationToken cancellationToken)
|
|
=> throw new InvalidOperationException("supervisor unavailable");
|
|
}
|
|
|
|
[Fact]
|
|
public async Task TickOnce_BeforeInterval_DoesNotFire()
|
|
{
|
|
var clock = new FakeClock();
|
|
var supervisor = new FakeSupervisor();
|
|
var scheduler = new ScheduledRecycleScheduler(
|
|
DriverTier.C, TimeSpan.FromMinutes(5), T0, supervisor,
|
|
NullLogger<ScheduledRecycleScheduler>.Instance);
|
|
|
|
var host = new ScheduledRecycleHostedService(NullLogger<ScheduledRecycleHostedService>.Instance, clock);
|
|
host.AddScheduler(scheduler);
|
|
|
|
clock.Utc = T0.AddMinutes(1);
|
|
await host.TickOnceAsync(CancellationToken.None);
|
|
|
|
supervisor.RecycleCount.ShouldBe(0);
|
|
host.TickCount.ShouldBe(1);
|
|
}
|
|
|
|
[Fact]
|
|
public async Task TickOnce_AfterInterval_Fires()
|
|
{
|
|
var clock = new FakeClock();
|
|
var supervisor = new FakeSupervisor();
|
|
var scheduler = new ScheduledRecycleScheduler(
|
|
DriverTier.C, TimeSpan.FromMinutes(5), T0, supervisor,
|
|
NullLogger<ScheduledRecycleScheduler>.Instance);
|
|
|
|
var host = new ScheduledRecycleHostedService(NullLogger<ScheduledRecycleHostedService>.Instance, clock);
|
|
host.AddScheduler(scheduler);
|
|
|
|
clock.Utc = T0.AddMinutes(6);
|
|
await host.TickOnceAsync(CancellationToken.None);
|
|
|
|
supervisor.RecycleCount.ShouldBe(1);
|
|
}
|
|
|
|
[Fact]
|
|
public async Task TickOnce_MultipleTicks_AccumulateCount()
|
|
{
|
|
var clock = new FakeClock();
|
|
var host = new ScheduledRecycleHostedService(NullLogger<ScheduledRecycleHostedService>.Instance, clock);
|
|
|
|
await host.TickOnceAsync(CancellationToken.None);
|
|
await host.TickOnceAsync(CancellationToken.None);
|
|
await host.TickOnceAsync(CancellationToken.None);
|
|
|
|
host.TickCount.ShouldBe(3);
|
|
}
|
|
|
|
[Fact]
|
|
public async Task AddScheduler_AfterStart_Throws()
|
|
{
|
|
var host = new ScheduledRecycleHostedService(NullLogger<ScheduledRecycleHostedService>.Instance);
|
|
using var cts = new CancellationTokenSource();
|
|
cts.Cancel();
|
|
|
|
await host.StartAsync(cts.Token); // flips _started true even with cancelled token
|
|
await host.StopAsync(CancellationToken.None);
|
|
|
|
var scheduler = new ScheduledRecycleScheduler(
|
|
DriverTier.C, TimeSpan.FromMinutes(5), DateTime.UtcNow, new FakeSupervisor(),
|
|
NullLogger<ScheduledRecycleScheduler>.Instance);
|
|
|
|
Should.Throw<InvalidOperationException>(() => host.AddScheduler(scheduler));
|
|
}
|
|
|
|
[Fact]
|
|
public async Task OneSchedulerThrowing_DoesNotStopOthers()
|
|
{
|
|
var clock = new FakeClock();
|
|
var good = new FakeSupervisor();
|
|
var bad = new ThrowingSupervisor();
|
|
|
|
var goodSch = new ScheduledRecycleScheduler(
|
|
DriverTier.C, TimeSpan.FromMinutes(5), T0, good,
|
|
NullLogger<ScheduledRecycleScheduler>.Instance);
|
|
var badSch = new ScheduledRecycleScheduler(
|
|
DriverTier.C, TimeSpan.FromMinutes(5), T0, bad,
|
|
NullLogger<ScheduledRecycleScheduler>.Instance);
|
|
|
|
var host = new ScheduledRecycleHostedService(NullLogger<ScheduledRecycleHostedService>.Instance, clock);
|
|
host.AddScheduler(badSch);
|
|
host.AddScheduler(goodSch);
|
|
|
|
clock.Utc = T0.AddMinutes(6);
|
|
await host.TickOnceAsync(CancellationToken.None);
|
|
|
|
good.RecycleCount.ShouldBe(1, "a faulting scheduler must not poison its neighbours");
|
|
}
|
|
|
|
[Fact]
|
|
public void SchedulerCount_MatchesAdded()
|
|
{
|
|
var host = new ScheduledRecycleHostedService(NullLogger<ScheduledRecycleHostedService>.Instance);
|
|
var sup = new FakeSupervisor();
|
|
host.AddScheduler(new ScheduledRecycleScheduler(DriverTier.C, TimeSpan.FromMinutes(5), DateTime.UtcNow, sup, NullLogger<ScheduledRecycleScheduler>.Instance));
|
|
host.AddScheduler(new ScheduledRecycleScheduler(DriverTier.C, TimeSpan.FromMinutes(10), DateTime.UtcNow, sup, NullLogger<ScheduledRecycleScheduler>.Instance));
|
|
|
|
host.SchedulerCount.ShouldBe(2);
|
|
}
|
|
|
|
[Fact]
|
|
public async Task EmptyScheduler_List_TicksCleanly()
|
|
{
|
|
var clock = new FakeClock();
|
|
var host = new ScheduledRecycleHostedService(NullLogger<ScheduledRecycleHostedService>.Instance, clock);
|
|
|
|
// No registered schedulers — tick is a no-op + counter still advances.
|
|
await host.TickOnceAsync(CancellationToken.None);
|
|
|
|
host.TickCount.ShouldBe(1);
|
|
}
|
|
}
|