David P.G
c4a840c8b8
1. 简化接口: OpcUaService 的 SubscribeToNode 和 UnsubscribeFromNode 方法的参数类型从 OpcUaNode 对象更改为 string 类型的节点ID。这使得上层服务在调用时无需构造完整的 OpcUaNode 对象，降低了接口的复杂性。 2. 更新实现: OpcUaService 和 OpcUaServiceManager 的内部实现已更新，以兼容新的基于字符串的接口。 3. 优化变量更新: OpcUaServiceManager 中的 OnVariableChanged 事件处理逻辑被修改，现在能够更细粒度地处理单个变量的激活状态和轮询间隔的变化，避免了不必要的整个设备订阅的重新加载。
103 lines
4.0 KiB
C#
103 lines
4.0 KiB
C#
using DMS.Infrastructure.Models;
|
||
using System;
|
||
using System.Collections.Generic;
|
||
using System.Threading.Tasks;
|
||
|
||
namespace DMS.Infrastructure.Interfaces.Services
|
||
{
|
||
/// <summary>
|
||
/// OPC UA服务接口，定义了与OPC UA服务器进行通信所需的方法
|
||
/// </summary>
|
||
public interface IOpcUaService
|
||
{
|
||
/// <summary>
|
||
/// 获取当前连接状态
|
||
/// </summary>
|
||
bool IsConnected { get; }
|
||
|
||
/// <summary>
|
||
/// 异步连接到OPC UA服务器
|
||
/// </summary>
|
||
/// <returns>表示异步操作的任务</returns>
|
||
Task ConnectAsync(string serverUrl);
|
||
|
||
/// <summary>
|
||
/// 异步断开与OPC UA服务器的连接
|
||
/// </summary>
|
||
/// <returns>表示异步操作的任务</returns>
|
||
Task DisconnectAsync();
|
||
|
||
/// <summary>
|
||
/// 浏览指定节点的子节点
|
||
/// </summary>
|
||
/// <param name="nodeToBrowse">要浏览的节点，如果为null则浏览根节点</param>
|
||
/// <returns>表示异步操作的任务，包含子节点列表</returns>
|
||
Task<List<OpcUaNode>> BrowseNode(OpcUaNode? nodeToBrowse);
|
||
|
||
/// <summary>
|
||
/// 订阅单个节点的数据变化
|
||
/// </summary>
|
||
/// <param name="nodeId">要订阅的节点ID</param>
|
||
/// <param name="onDataChange">数据变化时的回调方法</param>
|
||
/// <param name="publishingInterval">发布间隔（毫秒）</param>
|
||
/// <param name="samplingInterval">采样间隔（毫秒）</param>
|
||
void SubscribeToNode(string nodeId, Action<OpcUaNode> onDataChange, int publishingInterval = 1000, int samplingInterval = 500);
|
||
|
||
/// <summary>
|
||
/// 订阅多个节点的数据变化
|
||
/// </summary>
|
||
/// <param name="nodeIds">要订阅的节点ID列表</param>
|
||
/// <param name="onDataChange">数据变化时的回调方法</param>
|
||
/// <param name="publishingInterval">发布间隔（毫秒）</param>
|
||
/// <param name="samplingInterval">采样间隔（毫秒）</param>
|
||
void SubscribeToNode(List<string> nodeIds, Action<OpcUaNode> onDataChange, int publishingInterval = 1000, int samplingInterval = 500);
|
||
|
||
/// <summary>
|
||
/// 取消订阅单个节点
|
||
/// </summary>
|
||
/// <param name="nodeId">要取消订阅的节点的ID</param>
|
||
void UnsubscribeFromNode(string nodeId);
|
||
|
||
/// <summary>
|
||
/// 取消订阅多个节点
|
||
/// </summary>
|
||
/// <param name="nodeIds">要取消订阅的节点ID列表</param>
|
||
void UnsubscribeFromNode(List<string> nodeIds);
|
||
|
||
/// <summary>
|
||
/// 获取当前已订阅的所有节点
|
||
/// </summary>
|
||
/// <returns>已订阅节点的列表</returns>
|
||
List<OpcUaNode> GetSubscribedNodes();
|
||
|
||
/// <summary>
|
||
/// 异步读取单个节点的值
|
||
/// </summary>
|
||
/// <param name="node">要读取的节点</param>
|
||
/// <returns>表示异步操作的任务</returns>
|
||
Task ReadNodeValueAsync(OpcUaNode node);
|
||
|
||
/// <summary>
|
||
/// 异步读取多个节点的值
|
||
/// </summary>
|
||
/// <param name="nodes">要读取的节点列表</param>
|
||
/// <returns>表示异步操作的任务</returns>
|
||
Task ReadNodeValuesAsync(List<OpcUaNode> nodes);
|
||
|
||
/// <summary>
|
||
/// 异步写入单个节点的值
|
||
/// </summary>
|
||
/// <param name="node">要写入的节点</param>
|
||
/// <param name="value">要写入的值</param>
|
||
/// <returns>表示异步操作的任务，如果写入成功返回true，否则返回false</returns>
|
||
Task<bool> WriteNodeValueAsync(OpcUaNode node, object value);
|
||
|
||
/// <summary>
|
||
/// 异步写入多个节点的值
|
||
/// </summary>
|
||
/// <param name="nodesToWrite">要写入的节点及其对应值的字典</param>
|
||
/// <returns>表示异步操作的任务，如果所有写入都成功返回true，否则返回false</returns>
|
||
Task<bool> WriteNodeValuesAsync(Dictionary<OpcUaNode, object> nodesToWrite);
|
||
}
|
||
}
|