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

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

    • v2.13.X
    • 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是一个什么样的概念,在框架中起到什么样的作用?
💖赞助
🧩IDEA插件
🔥PPT
  • 项目介绍
  • 项目成员
  • 更新记录
  • 参与开发
👥加入群聊
🧤谁在使用
  • Gitee (opens new window)
  • GitCode (opens new window)
  • Github (opens new window)

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

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

    • v2.13.X
    • 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是一个什么样的概念,在框架中起到什么样的作用?
💖赞助
🧩IDEA插件
🔥PPT
  • 项目介绍
  • 项目成员
  • 更新记录
  • 参与开发
👥加入群聊
🧤谁在使用
  • Gitee (opens new window)
  • GitCode (opens new window)
  • Github (opens new window)
  • 🍤LiteFlow简介
  • 🍓项目特性
  • 🧁环境支持

    • 🗣环境支持说明
    • ☕️JDK支持度
    • 🌿Springboot支持度
    • 🌱Spring的支持度
  • 🍟快速开始(Hello world)

    • 🍄说明
    • 🌿Springboot场景安装运行

      • 🧬依赖
      • ⚙️配置
      • 🛫执行
    • 🌱Spring场景安装运行

      • 🧬依赖
      • ⚙️配置
      • 🛫执行
    • 🍩Solon场景安装运行

      • 🧬依赖
      • ⚙️配置
      • 🛫执行
    • 🌵其他场景安装运行

      • 🍄说明
      • 🧬依赖
      • ⚙️配置
      • 🛫执行
  • 🍢配置项

    • 🍄说明
    • 🌿Springboot下的配置项
    • 🌱Spring下的配置项
    • 🍩Solon下的配置项
    • 🌵其他场景代码设置配置项
  • 🔗组件

    • 🛍继承式组件

      • 📎普通组件
      • ✂️选择组件
      • ⛓布尔组件
      • 🧬次数循环组件
      • ⌛️迭代循环组件
      • 🏄LiteflowComponent
      • 🛀组件内方法覆盖和调用
    • 🎁声明式组件

      • 🥭什么叫声明式组件
      • 🧅类级别式声明
      • 🥥方法级别式声明
  • 🧩EL规则

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

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

    • 🍄说明
    • 🌯数据上下文的定义和使用
    • 🪶用初始化好的上下文传入
    • 🥨给上下文设置别名
    • 🥙上下文参数注入
    • 🪴用表达式获取上下文参数
  • 🛩执行器

    • 🍄说明
    • 🎡执行方法
    • 🎢流程入参
    • 🎈LiteflowResponse对象
  • 🍋脚本组件

    • 🌭脚本语言介绍
    • 🍫脚本语言种类

      • ☕️Java脚本引擎
      • 🥏Groovy脚本引擎
      • 🧀Javascript脚本引擎
      • 🥞QLExpress脚本引擎
      • 🍧Python脚本引擎
      • 🍝Lua脚本引擎
      • 🥐Aviator脚本引擎
      • 🥠Kotlin脚本引擎
    • 🍣脚本与Java进行交互
    • 🍱多脚本语言混合共存
    • 🌯文件脚本的定义
    • 🍘动态刷新脚本
    • 🍦验证脚本
    • 🗑卸载脚本
  • 🗂规则配置源

    • 📕本地规则文件配置
    • 📘SQL数据库配置源
    • 📗ZK规则文件配置源
    • 📋Nacos配置源
    • 🗄Etcd配置源
    • 📜Apollo配置源
    • 📑Redis配置源

      • 配置说明
      • 轮询模式配置
      • 订阅模式配置
    • 📙自定义配置源
  • 🍼元数据管理

    • ⛰元数据操作器
    • 🍖平滑热刷新
    • 🍮启动不检查规则
    • 🥨启动不检查脚本
  • 🌌异步中的线程池

    • 💧说明
    • 🐋FlowExecutor层面的线程池
    • 🐠组件异步层面的线程池
  • 🎲动态构造

    • 🍄说明
    • 🥜构造Node
    • 🌰构造EL
    • 🍞构造Chain
  • 🧮决策路由

    • 🏖概念以及介绍
    • 🍽决策路由用法
  • 😸生命周期

    • 🐮启动时生命周期
    • 🐳执行时生命周期
  • 🎨高级特性

    • 🍌本地规则文件监听
    • 🥠组件降级
    • 🍑组件别名
    • 🥝组件事件回调
    • 🐋组件回滚
    • 🥑隐式子流程
    • 🍕私有投递
    • 🍪组件切面
    • 🍡步骤信息
    • 🧊异常
    • 🧇打印信息详解
    • 🧁自定义请求Id
    • 🫕快速解析模式
    • 🌭不同格式规则加载
    • 🍿自定义组件执行器
    • 🍥简单监控
    • 🧉XML的DTD
  • ⛱测试用例以及示例

    • 🪁测试用例
    • 🪀DEMO案例
  • 🪂性能表现
  • 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/08/28, 11:38:35
data语法
🫐重试语法

← data语法 🫐重试语法→

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