LiteFlow LiteFlow
💒首页
  • v2.13.2(当前版本)
  • What's New

    • 🌈What' s New In LiteFlow v2.13.2?
  • 历史版本

    • v2.12.X
    • v2.11.X
    • v2.10.X
    • v2.9.X
    • v2.8.X
  • 升级指南

    • 🌈2.13.0升级指南
    • 2.12.4升级指南
    • 2.12.0升级指南
    • 升级到2.9.3说明
    • 升级到2.9.X说明
    • 升级到2.8.X说明
    • 升级到2.7.X说明
👑LF CLUB社区
  • 常见问题
  • 专题解释

    • 如何理解上下文这个概念?
    • Slot是一个什么样的概念,在框架中起到什么样的作用?
💖赞助
🧩插件
🔥PPT
  • 项目介绍
  • 项目成员
  • 更新记录
  • 参与开发
👥加入群聊
🧤谁在使用
  • Gitee (opens new window)
  • GitCode (opens new window)
  • Github (opens new window)

广告采用随机轮播方式显示 ❤️成为赞助商
💒首页
  • v2.13.2(当前版本)
  • What's New

    • 🌈What' s New In LiteFlow v2.13.2?
  • 历史版本

    • v2.12.X
    • v2.11.X
    • v2.10.X
    • v2.9.X
    • v2.8.X
  • 升级指南

    • 🌈2.13.0升级指南
    • 2.12.4升级指南
    • 2.12.0升级指南
    • 升级到2.9.3说明
    • 升级到2.9.X说明
    • 升级到2.8.X说明
    • 升级到2.7.X说明
👑LF CLUB社区
  • 常见问题
  • 专题解释

    • 如何理解上下文这个概念?
    • Slot是一个什么样的概念,在框架中起到什么样的作用?
💖赞助
🧩插件
🔥PPT
  • 项目介绍
  • 项目成员
  • 更新记录
  • 参与开发
👥加入群聊
🧤谁在使用
  • Gitee (opens new window)
  • GitCode (opens new window)
  • Github (opens new window)
  • 🍤LiteFlow简介
  • 🍓项目特性
  • 🧁环境支持

  • 🍟快速开始(Hello world)

  • 🍢配置项

  • 🔗组件

  • 🧩EL规则

    • 🍄说明
    • 🌴串行编排
    • 🎋并行编排
    • 🌾选择编排
    • 🌵条件编排
    • 🌳循环编排
    • 🥦异步循环模式
    • 🎃捕获异常表达式
    • 🍄与或非表达式
    • 🍁使用子流程
    • 🍂使用子变量
    • 💐复杂编排例子
    • 🍒前置和后置编排
    • 🍉组件参数语法

      • 说明
      • tag语法
      • data语法
      • bind语法
        • 绑定静态数据
        • 绑定动态数据
        • bind语法的覆盖用法
    • 🫐重试语法
    • ⏱️超时控制语法
    • 🥯链路继承
    • 🔆验证规则
    • 🌰关于注释
    • 🌻关于分号
    • 🐚组件名包装
  • 🌮上下文

  • 🛩执行器

  • 🍋脚本组件

  • 🗂规则配置源

  • 🍼元数据管理

  • 🌌异步中的线程池

  • 🎲动态构造

  • 🧮决策路由

  • 😸生命周期

  • 🎨高级特性

  • ⛱测试用例以及示例

  • 🪂性能表现
  • v2.13.X文档
  • 🧩EL规则
  • 🍉组件参数语法
铂赛东
2025-02-21
目录

bind语法

版本支持:v2.13.0+

# 绑定静态数据

LiteFlow还提供了bind语法关键字,它和data使用场景是一致的,但是它和data关键不同的是,它允许绑定KV键值对,比如

<chain id="chain1">
    THEN(a.bind("k1", "test"), b);
</chain>

你可以在组件中通过getBindData方法来获取:

@LiteflowComponent("a")
public class ACmp extends NodeComponent {
	@Override
	public void process() {
		String bindValue = this.getBindData("k1", String.class);
		...
	}
}

当然bind的时候也可以把value设置成json字符串,那么在取值的时候,第二个参数就可以传相应的VO的class,LiteFlow内部可以自动把Json转型成对象。

bind关键字也可以用作于表达式,子变量,chain上,其意义是被赋值的表达式/子变量/chain里所有的组件都绑定了相同的值,比如:

<chain id="chain1">
    THEN(a,b).bind("k1","test");
</chain>

<chain id="chain2">
    THEN(SWITCH(y).TO(d,c), WHEN(a, b), IF(x, c, d)).bind("k1", "test")
</chain>

<chain id="sub">
    THEN(a,IF(NOT(x), b, c));
</chain>

<chain id="chain3">
    THEN(d, sub.bind("k1", "test2"))
</chain>

# 绑定动态数据

LiteFlow还允许用bind关键字去绑定动态数据,这是tag和data关键字无法做到的。

所谓动态数据就是在编写规则EL的时候无法确定的,你可以bind一个表达式,LiteFlow会根据你bind的表达式去上下文中去搜索所需要的数据。

bind动态数据,value必须为一个表达式,且格式为${表达式}。

比如你的上下文如下:

public class OrderContext {
    private Integer id;
    private String orderCode;
    private Member member;
    //getter setter 省略   
}

// Member对象定义如下:
public class Member {
    private String memberCode;
    private String memberName;
    //getter setter 省略   
}

规则如下:

<chain id="chain1">
    THEN(a, b.bind("k1", "${orderCode}"))
</chain>

那么在b组件中就可以通过this.getBindData("k1", String.class)拿到上下文中orderCode的值。

如果想拿到上面OrderContext中Member对象中的memberName对象,你可以通过点操作符得到:

<chain id="chain1">
    THEN(a, b.bind("k1", "${member.memberName}"))
</chain>

如果你除了OrderContext还传了其他上下文,以上表达式也是可以得到的具体值的。因为LiteFlow会智能的根据你上下文中去匹配你的表达式。

但是如果有种极端情况,就是假设你传了OrderContext,又传了UserContext,两个上下文都有id属性,那么如果你写以下表达式:

<chain id="chain1">
    THEN(a, b.bind("k1", "${id}"))
</chain>

那么bind的到底是哪个上下文里的id呢?

这里如果你不指定,永远是bind第一个上下文的id,那么如果你要指定绑定UserContet里的id怎么办呢?

这时候就需要指定上下文了,你可以这样指定:

<chain id="chain1">
    THEN(a, b.bind("k1", "${userContext.id}"))
</chain>

这个userContext是UserContext的首字符小写的形式。你也可以通过@ContextBean去改变,比如你这样定义:

@ContextBean("userCx")
public class UserContext {
    private Integer id;
    private String address;
    //getter setter 省略   

那么你就可以这样去指定了:

<chain id="chain1">
    THEN(a, b.bind("k1", "${userCx.id}"))
</chain>

注意点1

其实在多上下文中属性名不冲突的情况,官方建议不要指定上下文,直接智能匹配。

注意点2

绑定动态数据除了绑定在节点上,同样可以绑定在表达式,子变量,chain上。

# bind语法的覆盖用法v2.13.1+

bind语法如果同时在节点和表达式上同时使用,是不会相互覆盖的,比如:

<chain id="chain1">
    THEN(a, b.bind("k","v1"), c).bind("k", "v2");
</chain>

上述表达式a拿到的是v2,b拿到的是v1,c拿到的是v2,b并不会被表达式上的bind给覆盖。

那如果想把b也强制覆盖成v2,则可以这么使用:

<chain id="chain1">
    THEN(a, b.bind("k","v1"), c).bind("k", "v2", true);
</chain>

bind最后一个参数传true的话,那么bind里的所有节点,都会被强制覆盖。以上表达式a,b,c拿到的都是v2了。

帮助我们改善此文档 (opens new window)
上次更新: 2025/03/31, 01:02:30
data语法
🫐重试语法

← data语法 🫐重试语法→

Theme by Vdoing | Copyright © 2020-2025 铂赛东 | MIT License
沪ICP备18012955号-2
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式