Skip to content

一款基于WPF(Dotnet 8)的动态节点流可视化编辑器(需二次开发) ----- A dynamic node flow visual editor based on WPF (Dotnet 8) (secondary development required)

License

Notifications You must be signed in to change notification settings

fhhyyp/serein-flow

Repository files navigation

自述

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

计划任务 2024年10月28日更新

  • 正在重写节点的实现方式
  • 准备新增基础节点“属性包装器”,用来收集各个节点的数据,包装成匿名对象/Json类型(暂时未想到如何设计)
  • 后续拓展远程管理与远程客户端的功能(目前仅支持远程修改节点属性、添加/移除节点、启动流程、停止流程)
  • 计划实现单步执行(暂未想到如何在不影响异步流程的前提下停止流程)
  • 计划实现节点树视图、IOC容器对象视图(目前残废版)
  • 计划实现不停机更新类库(更新整个DLL/某个节点),但似乎难度过大

如何加载我的DLL?

使用 DynamicFlow 特性标记你的类,可以参照 Net461DllTest 的实现。编译为 Dll文件 后,拖入到软件中即可。 如果你不想下载整个工程文件,“FLowEdit”目录下放有“FlowEdit可视化流程编辑器.zip”压缩包,可以直接解压使用(但可能需要你安装 .Net8 运行环境)。

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

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

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

关于 DynamicNodeType 枚举的补充说明。

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

  • Init - 初始化方法

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

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

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

    • 基本说明:IDynamicContext是动态上下文接口,内部提供全局单例的IFlowEnvironment环境接口,用以注册、获取实例(单例模式),一般情况下,你无须关注IFlowEnvironment对外暴露的属性方法。

2. 基础节点

  • 待更新

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

  • Action - 动作

    • 入参:自定义。如果传入IDynamicContext,会传入当前的上下文;如果传入NodeBase,会传入节点对应的Model。如果不显式指定参数来源,参数会尝试获取运行时上一节点返回值,并根据当前入参类型尝试进行类型转换。
    • 返回值:自定义,返回值由对应的Model类的object? FlowData变量接收。支持异步等待。
    • 描述:同步执行对应的方法。
  • Flipflop - 触发器

    • 全局触发器
      • 入参:依照Action节点。
      • 返回值:Task<IFlipflopContext<TResult>>
      • 描述:运行开始时,所有无上级节点的触发器节点(在当前分支中作为起始节点),分别建立新的线程运行,然后异步等待触发(如果有)。这种触发器拥有独自的DynamicContext上下文(共用同一个Ioc),执行完成之后,会重新从分支起点的触发器开始等待。
    • 分支中的触发器
      • 入参:依照Action节点。
      • 返回值:Task<IFlipflopContext<TResult>>
      • 描述:接收上一节点传递的上下文,同样进入异步等待,但执行完成后不会再次等待自身(只会触发一次)。
    • IFlipflopContext<TResult>
      • 基本说明:IFlipflopContext是一个接口,你无须关心内部实现。
      • 参数描述:State,状态枚举描述(Succeed、Cancel、Error、Cancel),如果返回Cancel,则不会执行后继分支,如果返回其它状态,则会获取对应的后继分支,开始执行。
      • 参数描述:Type,触发状态描述(External外部触发,Overtime超时触发),当你在代码中的其他地方主动触发了触发器,则该次触发类型为External,当你在创建触发器后超过了指定时间(创建触发器时会要求声明超时时间),则会自动触发,但触发类型为Overtime,触发参数未你在创建触发器时指定的值)
      • 参数描述:Value,触发时传递的参数。
    • 使用场景:配合 FlowTrigger<TEnum> 使用,例如定时从PLC中获取状态,当某个变量发生改变时,会通知相应的触发器,如果需要,可以传递对应的数据。 演示: image image image image

About

一款基于WPF(Dotnet 8)的动态节点流可视化编辑器(需二次开发) ----- A dynamic node flow visual editor based on WPF (Dotnet 8) (secondary development required)

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages