介绍

LiteFlow支持了用Java本身作为脚本语言的特性。用Java作为脚本语言也是LiteFlow首推的脚本语言。

也就是说，在写组件脚本时，你可以完全用Java自身的语法来写脚本。同样这部分的脚本，也是可以进行热刷新的。

LiteFlow提供了三种Java脚本的插件，分别为：

• liteflow-script-java：以Janino为底层来实现。版本支持：v2.11.0+，这个插件从v2.13.0开始起不再推荐使用，今后也不会有任何维护和更新
• liteflow-script-javax：以Liquor为底层来实现。版本支持：v2.12.4+
• liteflow-script-javax-pro：升级版本，完全同静态java写法一样。版本支持：v2.13.0+

以下针对于liteflow-script-javax和liteflow-script-javax-pro这2个插件进行说明。

如果你使用2.13.X系列版本，推荐使用liteflow-script-javax-pro。

如果你使用2.12.X系列版本，推荐使用liteflow-script-javax。

使用liteflow-script-javax

你需要额外依赖LiteFlow提供的脚本插件：

<dependency>
    <groupId>com.yomahub</groupId>
    <artifactId>liteflow-script-javax</artifactId>
    <version>2.13.1</version>
</dependency>

提示

使用以Liquor为核心的javax插件，部署运行的时候必须为JDK，而不能是JRE，这点要注意下。

使用liteflow-script-javax插件，需要像如下去定义，以下是个例子：

<node id="s1" name="普通脚本1" type="script" language="java">
    <![CDATA[
    import cn.hutool.core.collection.ListUtil;
    import com.alibaba.fastjson2.JSON;
    import com.yomahub.liteflow.script.body.CommonScriptBody;
    import com.yomahub.liteflow.slot.DefaultContext;
    import com.yomahub.liteflow.spi.holder.ContextAwareHolder;
    import com.yomahub.liteflow.test.script.javax.common.cmp.Person;
    import com.yomahub.liteflow.test.script.javax.common.cmp.TestDomain;
    import com.yomahub.liteflow.script.ScriptExecuteWrap;
    import java.util.List;
    import java.util.function.ToIntFunction;

    public class Demo implements CommonScriptBody {
        public Void body(ScriptExecuteWrap wrap) {
            int v1 = 2;
            int v2 = 3;
            DefaultContext ctx = wrap.getCmp().getFirstContextBean();
            ctx.setData("s1", v1 * v2);

            TestDomain domain = ContextAwareHolder.loadContextAware().getBean(TestDomain.class);
            System.out.println(domain);
            String str = domain.sayHello("jack");
            ctx.setData("hi", str);

            List<Person> personList = ListUtil.toList(
                    new Person("jack", 15000),
                    new Person("tom", 13500),
                    new Person("peter", 18600)
            );

            int totalSalary = personList.stream().mapToInt(Person::getSalary).sum();

            System.out.println(totalSalary);
            ctx.setData("salary", 47100);

            return null;
        }
    }
    ]]>
</node>

如果你要实现其他种类的组件，请替换实现的接口：

script：普通脚本节点，需要实现CommonScriptBody接口，脚本里返回null即可。

switch_script：选择脚本节点，需要实现SwitchScriptBody接口，脚本里需要返回选择的节点Id。

boolean_script：布尔脚本节点，需要实现BooleanScriptBody接口，脚本里需要返回true/false。

for_script：数量循环节点，需要实现ForScriptBody接口，脚本里需要返回数值类型，表示循环次数。

之前类方法通过this调用的，现在都用wrap.getCmp()来替换。

但是在这个插件中，你无法覆盖其他方法，比如说isAccess或者onSuccess等方法。

使用liteflow-script-javax-pro

你需要额外依赖LiteFlow提供的脚本插件：

<dependency>
    <groupId>com.yomahub</groupId>
    <artifactId>liteflow-script-javax-pro</artifactId>
    <version>2.13.1</version>
</dependency>

提示

使用以Liquor为核心的javax插件，部署运行的时候必须为JDK，而不能是JRE，这点要注意下。

这个为上一个插件的升级版本，在这个插件中，定义java完全是按照静态java类的方式去定义了，以下是一个例子：

<node id="s1" name="普通脚本1" type="script" language="java">
    <![CDATA[
    import cn.hutool.core.collection.ListUtil;
    import com.yomahub.liteflow.core.NodeComponent;
    import com.yomahub.liteflow.slot.DefaultContext;
    import com.yomahub.liteflow.spi.holder.ContextAwareHolder;
    import com.yomahub.liteflow.test.script.javaxpro.common.cmp.Person;
    import com.yomahub.liteflow.test.script.javaxpro.common.cmp.TestDomain;

    import java.util.List;

    public class Demo extends NodeComponent {
        @Override
        public void process() throws Exception {
            int v1 = 2;
            int v2 = 3;
            DefaultContext ctx = this.getFirstContextBean();
            ctx.setData("s1", v1 * v2);

            TestDomain domain = ContextAwareHolder.loadContextAware().getBean(TestDomain.class);
            System.out.println(domain);
            String str = domain.sayHello("jack");
            ctx.setData("hi", str);

            List<Person> personList = ListUtil.toList(
                    new Person("jack", 15000),
                    new Person("tom", 13500),
                    new Person("peter", 18600)
            );

            int totalSalary = personList.stream().mapToInt(Person::getSalary).sum();

            System.out.println(totalSalary);
            ctx.setData("salary", 47100);
        }
    }
    ]]>
</node>

可以看到，在升级版的插件中，其定义java的方式完全和类里定义的完全一致了。这意味着，你可以用this来进行调用，你也可以覆盖其他方法如isAccess，beforeProcess等。

提示

即便是java脚本组件，目前还依旧不可以定义迭代循环组件。这意味着即使你用了java-pro插件，你现在可以继承NodeIteratorComponent，但是你依旧无法正确执行。

请用for_script组件来代替。

如何取Spring上下文中的数据

值得注意的是，以上2个脚本插件虽然完全是Java的语法，但是你无法用@Resource或者@Autowired来进行注入spring的bean。

LiteFlow提供一个方法，用来获取Spring中的bean数据，如下示例：

UserDomain domain = ContextAwareHolder.loadContextAware().getBean(UserDomain.class);

这样就可以获得在spring上下文中注入的UserDomain对象了。