Files
serein-flow/README.md

4.1 KiB
Raw Blame History

自述

基于WPFDotnet 8的流程可视化编辑器需二次开发。 不定期在Bilibili个人空间上更新相关的视频。 https://space.bilibili.com/33526379

计划任务 2024年9月17日更新

  • (重要+优先实现断点功能查看运行中节点的数据、ioc容器对象
  • 计划新增基础节点“属性包装器”,用来收集各个节点的数据,包装成匿名对象/Json类型
  • 计划编写网络方面的通讯,方便传出、传入数据
  • 包装数据类型, 优化传递效率(尽可能避免拆箱、装箱)

如何加载我的DLL

使用 DynamicFlow 特性标记你的类,可以参照 MyDllSereinWAT 的实现。编译为 Dll文件 后,拖入到软件中即可。

如何让我的方法成为节点?

使用 NodeAction 特性标记你的方法。

  • 动作节点 - Action
  • 触发器节点 - Flipflop

关于 DynamicNodeType 枚举的补充说明。

1. 不生成节点控件的枚举值:

  • Init - 初始化方法

    • 入参:DynamicContext(有且只有一个参数)。
    • 返回值:自定义,但软件目前不支持接收返回值。
    • 描述在运行时首先被调用。语义类似于构造方法。建议在Init方法内初始化类、注册类等一切需要在构造函数中执行的方法。
  • Loading - 加载方法

    • 入参:DynamicContext(有且只有一个参数)。
    • 返回值:自定义,但软件目前不支持接收返回值。
    • 描述当所有Dll的Init方法调用完成后首先调用、也才会调用DLL的Loading方法。建议在Loading方法内进行业务上的初始化例如启动Web启动第三方服务
  • Exit - 结束方法

    • 入参:DynamicContext(有且只有一个参数)。
    • 返回值:自定义,但软件目前不支持接收返回值。
    • 描述:当结束/手动结束运行时会调用所有Dll的Exit方法。使用场景类似于终止内部的其它线程通知其它进程关闭例如停止第三方服务。

2. 基础节点

  • 待更新

3. 从DLL生成控件的枚举值

  • Action - 动作

    • 入参自定义。如果传入DynamicContext会传入当前的上下文如果传入NodeBase会传入节点对应的Model。第一个非[Explicit]特性的参数会尝试从上一节点的获取FlowData变量并根据当前入参类型尝试进行类型转换。
    • 返回值自定义返回值由对应的Model类的[object?]FlowData变量接收。
    • 描述:同步执行对应的方法。
  • Flipflop - 触发器

    • 全局触发器
      • 入参依照Action节点。
      • 返回值Task
      • 描述运行开始时所有无上级节点的触发器节点在当前分支中作为起始节点分别建立新的线程运行然后异步等待触发如果有。这种触发器拥有独自的DynamicContext上下文共用同一个Ioc执行完成之后会重新从分支起点的触发器开始等待。
    • 分支中的触发器
      • 入参依照Action节点。
      • 返回值Task
      • 描述:接收上一节点传递的上下文,同样进入异步等待,但执行完成后不会再次等待自身(只会触发一次)。
    • FlipflopContext
      • 描述内部有一套枚举描述Succeed、Cancel如果返回Succeed会通过所有下级节点集合创建Task集合然后调用WaitAll()进行等待每个Task会新建新的DynamicContext上下文共用同一个Ioc。如果返回Cancel则什么也不做。
    • 使用场景配合TcsSignal使用定时从PLC中获取状态当某个变量发生改变时会通知持有TaskCompletionSource的触发器如果需要可以传递对应的数据。 演示: image image