mirror of
https://gitee.com/langsisi_admin/serein-flow
synced 2026-03-03 00:00:49 +08:00
468 lines
17 KiB
C#
468 lines
17 KiB
C#
using Serein.Library.Api;
|
||
using Serein.Library.Utils;
|
||
using Serein.Library.Utils.SereinExpression;
|
||
using System;
|
||
using System.Collections.Generic;
|
||
using System.Diagnostics;
|
||
using System.Linq;
|
||
using System.Reflection;
|
||
using System.Threading;
|
||
using System.Threading.Tasks;
|
||
namespace Serein.Library
|
||
{
|
||
|
||
|
||
|
||
/// <summary>
|
||
/// 节点入参参数详情
|
||
/// </summary>
|
||
[NodeProperty(ValuePath = NodeValuePath.Parameter)]
|
||
public partial class ParameterDetails
|
||
{
|
||
// private readonly IFlowEnvironment env;
|
||
|
||
/// <summary>
|
||
/// 所在的节点
|
||
/// </summary>
|
||
[PropertyInfo(IsProtection = true)]
|
||
private IFlowNode _nodeModel;
|
||
|
||
/// <summary>
|
||
/// 参数索引
|
||
/// </summary>
|
||
[PropertyInfo]
|
||
private int _index;
|
||
|
||
/// <summary>
|
||
/// <para>是否为显式参数（固定值/表达式）</para>
|
||
/// <para>如果为 true ，则使用输入的文本值作为入参数据。</para>
|
||
/// <para>如果为 false ，则在当前流程上下文中，根据 ArgDataSourceNodeGuid 查找到对应节点，并根据 ArgDataSourceNodeGuid 判断如何获取其返回的数据，以此作为入参数据。</para>
|
||
/// </summary>
|
||
[PropertyInfo(IsNotification = true)]
|
||
private bool _isExplicitData ;
|
||
|
||
///// <summary>
|
||
///// 转换器 IEnumConvertor<,>
|
||
///// </summary>
|
||
//[PropertyInfo]
|
||
//private Func<object, object> _convertor ;
|
||
|
||
/// <summary>
|
||
/// 方法入参若无相关转换器特性标注，则无需关注该变量。该变量用于需要用到枚举BinValue转换器时，指示相应的入参变量需要转为的类型。
|
||
/// </summary>
|
||
[Obsolete("转换器特性将在下一个大版本中移除")]
|
||
[PropertyInfo]
|
||
private Type _explicitType ;
|
||
|
||
/// <summary>
|
||
/// 目前存在三种状态：Select/Bool/Value
|
||
/// <para>Select : 枚举值/可选值</para>
|
||
/// <para>Bool : 布尔类型</para>
|
||
/// <para>Value ：除以上类型之外的任意参数</para>
|
||
/// </summary>
|
||
[PropertyInfo]
|
||
private ParameterValueInputType _inputType ;
|
||
|
||
/// <summary>
|
||
/// 入参数据来源。默认使用上一节点作为入参数据。
|
||
/// </summary>
|
||
[PropertyInfo(IsNotification = true)]
|
||
private ConnectionArgSourceType _argDataSourceType = ConnectionArgSourceType.GetPreviousNodeData;
|
||
|
||
/// <summary>
|
||
/// 当 ArgDataSourceType 不为 GetPreviousNodeData 时（从运行时上一节点获取数据）。
|
||
/// 则通过当前上下文，获取该Guid对应的数据作为预处理的入参参数。
|
||
/// </summary>
|
||
[PropertyInfo]
|
||
private string _argDataSourceNodeGuid;
|
||
|
||
/// <summary>
|
||
/// 方法入参需要的类型。
|
||
/// </summary>
|
||
[PropertyInfo]
|
||
private Type _dataType ;
|
||
|
||
/// <summary>
|
||
/// 方法入参参数名称
|
||
/// </summary>
|
||
[PropertyInfo(IsNotification = true)]
|
||
private string _name ;
|
||
|
||
/// <summary>
|
||
/// 入参注释
|
||
/// </summary>
|
||
[PropertyInfo]
|
||
private string _description;
|
||
|
||
/// <summary>
|
||
/// 自定义的方法入参数据
|
||
/// </summary>
|
||
[PropertyInfo(IsNotification = true)] // IsPrint = true
|
||
private string _dataValue;
|
||
|
||
/// <summary>
|
||
/// 只有当 InputType 为 Select 时，才会需要该成员。
|
||
/// </summary>
|
||
[PropertyInfo(IsNotification = true)]
|
||
private string[] _items ;
|
||
|
||
/// <summary>
|
||
/// 指示该属性是可变参数的其中一员（可变参数为数组类型）
|
||
/// </summary>
|
||
[PropertyInfo]
|
||
private bool _isParams;
|
||
}
|
||
|
||
|
||
|
||
|
||
public partial class ParameterDetails
|
||
{
|
||
|
||
|
||
|
||
|
||
|
||
|
||
/// <summary>
|
||
/// 用于创建元数据
|
||
/// </summary>
|
||
public ParameterDetails()
|
||
{
|
||
|
||
}
|
||
|
||
/// <summary>
|
||
/// 为节点实例化新的入参描述
|
||
/// </summary>
|
||
public ParameterDetails(IFlowNode nodeModel)
|
||
{
|
||
this.NodeModel = nodeModel;
|
||
}
|
||
|
||
public ParameterDetails(ParameterData pdInfo, int argIndex)
|
||
{
|
||
this.Index = argIndex;
|
||
this.DataType = typeof(object);
|
||
this.ArgDataSourceNodeGuid = pdInfo.SourceNodeGuid;
|
||
this.ArgDataSourceType = EnumHelper.ConvertEnum<ConnectionArgSourceType>(pdInfo.SourceType);
|
||
this.DataValue = pdInfo.Value;
|
||
this.InputType = ParameterValueInputType.Input;
|
||
this.IsExplicitData = pdInfo.State;
|
||
this.Name = pdInfo.ArgName;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 通过参数信息加载实体，用于加载项目文件、远程连接的场景
|
||
/// </summary>
|
||
/// <param name="info">参数信息</param>
|
||
public ParameterDetails(ParameterDetailsInfo info)
|
||
{
|
||
Index = info.Index;
|
||
Name = info.Name;
|
||
DataType = Type.GetType(info.DataTypeFullName);
|
||
ExplicitType = Type.GetType(info.ExplicitTypeFullName);
|
||
InputType = info.InputType.ConvertEnum<ParameterValueInputType>();
|
||
Items = info.Items;
|
||
IsParams = info.IsParams;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 转为描述
|
||
/// </summary>
|
||
/// <returns></returns>
|
||
public ParameterDetailsInfo ToInfo()
|
||
{
|
||
return new ParameterDetailsInfo
|
||
{
|
||
Index = this.Index,
|
||
IsParams = this.IsParams,
|
||
DataTypeFullName = this.DataType.FullName,
|
||
Name = this.Name,
|
||
ExplicitTypeFullName = this.ExplicitType?.FullName,
|
||
InputType = this.InputType.ToString(),
|
||
Items = this.Items?.Select(it => it).ToArray(),
|
||
};
|
||
}
|
||
|
||
/// <summary>
|
||
/// 为某个节点从元数据中拷贝方法描述的入参描述
|
||
/// </summary>
|
||
/// <param name="nodeModel">对应的节点</param>
|
||
/// <returns></returns>
|
||
public ParameterDetails CloneOfModel(IFlowNode nodeModel)
|
||
{
|
||
var pd = new ParameterDetails(nodeModel)
|
||
{
|
||
Index = this.Index,
|
||
IsExplicitData = this.IsExplicitData,
|
||
ExplicitType = this.ExplicitType,
|
||
InputType = this.InputType,
|
||
//Convertor = this.Convertor,
|
||
DataType = this.DataType,
|
||
Name = this.Name,
|
||
DataValue = this.DataValue,
|
||
Items = this.Items?.Select(it => it).ToArray(),
|
||
IsParams = this.IsParams,
|
||
Description = this.Description,
|
||
};
|
||
return pd;
|
||
}
|
||
|
||
public async Task<object> ToMethodArgData(IFlowContext context)
|
||
{
|
||
// 1. 从缓存获取
|
||
if (context.TryGetParamsTempData(NodeModel.Guid, Index, out var data))
|
||
return data;
|
||
|
||
// 2. 特定快捷类型
|
||
if (typeof(IFlowEnvironment).IsAssignableFrom(DataType)) return NodeModel.Env;
|
||
if (typeof(IFlowContext).IsAssignableFrom(DataType)) return context;
|
||
if (typeof(IFlowNode).IsAssignableFrom(DataType)) return NodeModel;
|
||
|
||
// 3. 显式常量参数
|
||
if (IsExplicitData && !DataValue.StartsWith("@", StringComparison.OrdinalIgnoreCase))
|
||
return DataValue.ToConvert(DataType);
|
||
|
||
// 4. 来自其他节点
|
||
object inputParameter = null;
|
||
var env = NodeModel.Env;
|
||
|
||
if (ArgDataSourceType == ConnectionArgSourceType.GetPreviousNodeData)
|
||
{
|
||
var prevNodeGuid = context.GetPreviousNode(NodeModel.Guid);
|
||
inputParameter = prevNodeGuid != null ? context.GetFlowData(prevNodeGuid)?.Value : null;
|
||
}
|
||
else
|
||
{
|
||
|
||
var prevNodeGuid = context.GetPreviousNode(NodeModel.Guid);
|
||
|
||
if (!env.TryGetNodeModel(ArgDataSourceNodeGuid, out var sourceNode))
|
||
throw new Exception($"[arg{Index}] 节点[{ArgDataSourceNodeGuid}]不存在");
|
||
|
||
if (sourceNode.IsPublic // 如果运行上一节点是[FlowCall]节点（则从该节点获取入参）
|
||
&& env.TryGetNodeModel(prevNodeGuid, out var prevNode)
|
||
&& prevNode.ControlType == NodeControlType.FlowCall
|
||
&& env.TryGetNodeModel(context.GetPreviousNode(NodeModel.Guid), out var sourceNodeTemp)
|
||
)
|
||
sourceNode = sourceNodeTemp;
|
||
|
||
if (ArgDataSourceType == ConnectionArgSourceType.GetOtherNodeData)
|
||
inputParameter = context.GetFlowData(sourceNode.Guid)?.Value;
|
||
else if (ArgDataSourceType == ConnectionArgSourceType.GetOtherNodeDataOfInvoke) // 立刻执行目标节点获取参数
|
||
inputParameter = (await sourceNode.ExecutingAsync(context, CancellationToken.None)).Value;
|
||
else
|
||
throw new Exception("无效的 ArgDataSourceType");
|
||
}
|
||
|
||
// 5. 表达式处理
|
||
if (IsExplicitData && DataValue.StartsWith("@", StringComparison.OrdinalIgnoreCase))
|
||
{
|
||
var lower = DataValue.ToLowerInvariant();
|
||
if (lower.StartsWith("@get") || lower.StartsWith("@dtc") || lower.StartsWith("@data"))
|
||
{
|
||
inputParameter = SerinExpressionEvaluator.Evaluate(DataValue, inputParameter, out _);
|
||
}
|
||
}
|
||
|
||
// 6. 类型转换
|
||
if (!DataType.IsValueType && inputParameter is null)
|
||
throw new Exception($"[arg{Index}] 参数不能为null");
|
||
|
||
if (DataType == typeof(string))
|
||
return inputParameter.ToString();
|
||
|
||
var actualType = inputParameter.GetType();
|
||
if (DataType.IsAssignableFrom(actualType))
|
||
return inputParameter;
|
||
|
||
if (DataType.IsSubclassOf(actualType))
|
||
return ObjectConvertHelper.ConvertParentToChild(inputParameter, DataType);
|
||
|
||
throw new Exception($"[arg{Index}] 类型不匹配：目标类型为 {DataType}，实际类型为 {actualType}");
|
||
}
|
||
|
||
/// <summary>
|
||
/// 转为方法入参数据
|
||
/// </summary>
|
||
/// <returns></returns>
|
||
public async Task<object> ToMethodArgData2(IFlowContext context)
|
||
{
|
||
|
||
var nodeModel = NodeModel;
|
||
var env = nodeModel.Env;
|
||
|
||
#region 流程运行上下文预设的参数
|
||
if (context.TryGetParamsTempData(NodeModel.Guid, Index, out var data))
|
||
{
|
||
return data;
|
||
}
|
||
#endregion
|
||
|
||
#region 显然的流程基本类型
|
||
// 返回运行环境
|
||
if (typeof(IFlowEnvironment).IsAssignableFrom(DataType))
|
||
{
|
||
return env;
|
||
}
|
||
// 返回流程上下文
|
||
if (typeof(IFlowContext).IsAssignableFrom(DataType))
|
||
{
|
||
return context;
|
||
}
|
||
// 返回流程上下文
|
||
if (typeof(IFlowNode).IsAssignableFrom(DataType))
|
||
{
|
||
return NodeModel;
|
||
}
|
||
// 显式设置的参数
|
||
if (IsExplicitData && !DataValue.StartsWith("@", StringComparison.OrdinalIgnoreCase))
|
||
{
|
||
return DataValue.ToConvert(DataType); // 并非表达式，同时是显式设置的参数
|
||
}
|
||
#endregion
|
||
|
||
|
||
|
||
|
||
|
||
/*#region “枚举-类型”转换器
|
||
if (ExplicitType is not null && ExplicitType.IsEnum && DataType != ExplicitType)
|
||
{
|
||
var resultEnum = Enum.Parse(ExplicitType, DataValue);
|
||
// 获取绑定的类型
|
||
var type = EnumHelper.GetBoundValue(ExplicitType, resultEnum, attr => attr.Value);
|
||
if (type is Type enumBindType && !(enumBindType is null))
|
||
{
|
||
var value = nodeModel.Env.IOC.CreateObject(enumBindType);
|
||
return value;
|
||
}
|
||
}
|
||
#endregion*/
|
||
|
||
// 需要获取预入参数据
|
||
object inputParameter;
|
||
#region （默认的）从运行时上游节点获取其返回值
|
||
|
||
if (ArgDataSourceType == ConnectionArgSourceType.GetPreviousNodeData)
|
||
{
|
||
var previousNode = context.GetPreviousNode(nodeModel.Guid);
|
||
if (previousNode is null)
|
||
{
|
||
inputParameter = null;
|
||
}
|
||
else
|
||
{
|
||
var flowData = context.GetFlowData(previousNode);
|
||
inputParameter = flowData.Value; // 当前传递的数据
|
||
}
|
||
}
|
||
else
|
||
{
|
||
|
||
|
||
if(!env.TryGetNodeModel(ArgDataSourceNodeGuid, out var argSourceNodeModel))
|
||
{
|
||
throw new Exception($"[arg{Index}][{Name}][{DataType}]需要节点[{ArgDataSourceNodeGuid}]的参数，但节点不存在");
|
||
}
|
||
|
||
// 如果是公开的节点，需要判断上下文调用中是否存在流程接口节点
|
||
if (argSourceNodeModel.IsPublic)
|
||
{
|
||
var pnGuid = context.GetPreviousNode(NodeModel.Guid);
|
||
var pn = env.TryGetNodeModel(pnGuid, out var tmpNode) ? tmpNode : null;
|
||
if (pn.ControlType == NodeControlType.FlowCall)
|
||
{
|
||
argSourceNodeModel = pn;
|
||
}
|
||
}
|
||
|
||
if (ArgDataSourceType == ConnectionArgSourceType.GetOtherNodeData)
|
||
{
|
||
var flowData = context.GetFlowData(argSourceNodeModel.Guid);
|
||
if(flowData is null)
|
||
{
|
||
inputParameter = null;
|
||
}
|
||
else
|
||
{
|
||
|
||
inputParameter = flowData.Value;
|
||
}
|
||
}
|
||
else if (ArgDataSourceType == ConnectionArgSourceType.GetOtherNodeDataOfInvoke)
|
||
{
|
||
// 立刻调用对应节点获取数据。
|
||
var cts = new CancellationTokenSource();
|
||
var result = await argSourceNodeModel.ExecutingAsync(context, cts.Token);
|
||
cts?.Cancel();
|
||
cts?.Dispose();
|
||
inputParameter = result.Value;
|
||
}
|
||
else
|
||
{
|
||
throw new Exception("节点执行方法获取入参参数时，ConnectionArgSourceType枚举是意外的枚举值");
|
||
}
|
||
}
|
||
#endregion
|
||
#region 判断是否执行表达式
|
||
if (IsExplicitData)
|
||
{
|
||
// @Get 表达式 （从上一节点获取对象）
|
||
if (DataValue.StartsWith("@get", StringComparison.OrdinalIgnoreCase))
|
||
{
|
||
inputParameter = SerinExpressionEvaluator.Evaluate(DataValue, inputParameter, out _);
|
||
}
|
||
|
||
// @DTC 表达式 （Data type conversion）
|
||
else if (DataValue.StartsWith("@dtc", StringComparison.OrdinalIgnoreCase))
|
||
{
|
||
inputParameter = SerinExpressionEvaluator.Evaluate(DataValue, inputParameter, out _);
|
||
}
|
||
|
||
// @Data 表达式 （获取全局数据）
|
||
else if (DataValue.StartsWith("@data", StringComparison.OrdinalIgnoreCase))
|
||
{
|
||
inputParameter = SerinExpressionEvaluator.Evaluate(DataValue, inputParameter, out _);
|
||
}
|
||
|
||
}
|
||
|
||
#endregion
|
||
|
||
// 对引用类型检查 null
|
||
if (!DataType.IsValueType && inputParameter is null)
|
||
{
|
||
throw new Exception($"[arg{Index}][{Name}][{DataType}]参数不能为null");
|
||
}
|
||
if (DataType == typeof(string)) // 转为字符串
|
||
{
|
||
return inputParameter.ToString();
|
||
}
|
||
var inputParameterType = inputParameter.GetType();
|
||
if (DataType.IsSubclassOf(inputParameterType)) // 入参类型 是 预入参数据类型 的 子类/实现类
|
||
{
|
||
// 方法入参中，父类不能隐式转为子类，这里需要进行强制转换
|
||
return ObjectConvertHelper.ConvertParentToChild(inputParameter, DataType);
|
||
}
|
||
if (DataType.IsAssignableFrom(inputParameterType)) // 入参类型 是 预入参数据类型 的 父类/接口
|
||
{
|
||
return inputParameter;
|
||
}
|
||
|
||
throw new Exception($"[arg{Index}][{Name}][{DataType}]入参类型不符合，当前预入参类型为{inputParameterType}");
|
||
}
|
||
|
||
public override string ToString()
|
||
{
|
||
return $"[{this.Index}] {(string.IsNullOrWhiteSpace(this.Description) ? string.Empty : $"({this.Description})")}{this.Name} : {this.DataType?.FullName}";
|
||
}
|
||
}
|
||
|
||
|
||
|
||
|
||
|
||
}
|
