/* ======================================================================== * 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.Diagnostics.CodeAnalysis; using System.Threading; using System.Threading.Channels; using System.Threading.Tasks; using Microsoft.Extensions.Options; namespace Opc.Ua { /// /// Convert option changes to queue of changels /// /// /// internal sealed class OptionsReader where TChange : struct where TOptions : class { /// /// Create change monitor /// /// /// public OptionsReader(IOptionsMonitor options, Func convert) { m_changes = Channel.CreateUnbounded( new UnboundedChannelOptions { SingleReader = true }); options.OnChange((o, n) => { TChange? change = convert(o); if (change != null) { m_changes.Writer.TryWrite(change.Value); } }); } /// /// Wait for changes /// /// /// public ValueTask WaitAsync(CancellationToken ct) { return m_changes.Reader.WaitToReadAsync(ct); } /// /// Get next change /// /// /// public bool TryGetNextChange(out TChange change) { return m_changes.Reader.TryRead(out change); } private readonly Channel m_changes; } /// /// Convert option changes to queue of changels /// /// internal sealed class OptionsReader<[DynamicallyAccessedMembers( DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)] TOptions> where TOptions : class { /// /// Create change monitor /// /// /// public OptionsReader(IOptionsMonitor options, int capacity = 5) { m_changes = Channel.CreateBounded( new BoundedChannelOptions(capacity) { SingleReader = true, FullMode = BoundedChannelFullMode.DropOldest }); options.OnChange((o, n) => { if (o == null) { return; } TOptions? last = Interlocked.Exchange(ref m_current, o); if (o.Equals(last)) { return; } m_changes.Writer.TryWrite(o); }); } /// /// Wait for changes /// /// /// public ValueTask WaitAsync(CancellationToken ct) { return m_changes.Reader.WaitToReadAsync(ct); } /// /// Get next change /// /// /// public bool TryGet([MaybeNullWhen(false)] out TOptions? change) { return m_changes.Reader.TryRead(out change); } private readonly Channel m_changes; private TOptions? m_current; } }