QLExpress学习笔记：初识它

环境

java：1.8+
Intellij IDEA：2021.1.4
QLExpress：3.2.4

对着官方文档学习，对一些需要注意的点，进行记录；

自定义Operator

//定义一个继承自com.ql.util.express.Operator的操作符
public class JoinOperator extends Operator{
	public Object executeInner(Object[] list) throws Exception {
		Object opdata1 = list[0];
		Object opdata2 = list[1];
		if(opdata1 instanceof java.util.List){
			((java.util.List)opdata1).add(opdata2);
			return opdata1;
		}else{
			java.util.List result = new java.util.ArrayList();
			result.add(opdata1);
			result.add(opdata2);
			return result;				
		}
	}
}

使用自定义的Operator

//(3)addFunction
ExpressRunner runner = new ExpressRunner();
DefaultContext<String, Object> context = new DefaultContext<String, Object>();
runner.addFunction("join",new JoinOperator());
Object r = runner.execute("join(1,2,3)", context, null, false, false);
System.out.println(r);

如果真把上面的代码执行一遍，你会发现，其返回的是[1, 2]，并不是[1,2,3]。
为什么呢？
因为给的代码有点问题：

public Object executeInner(Object[] list) throws Exception {
		Object opdata1 = list[0];
		Object opdata2 = list[1];
... ...

这里，其只获取了数组的前两个；我们修改下：

@Override
    public Object executeInner(Object[] list) throws Exception {
        List result = new ArrayList();
        for (Object obj : list) {
            result.add(obj);
        }
        return result;
    }

改好后，就可以返回[1,2,3]。

如何调用接口方法

获取到对象的Class，然后通过反射获取到相应方法的Method对象，接着调用invoke方法。

为什么在context中注入全类名没有用？

String statement = "OrderQuery.test();";
DefaultContext<String, Object> context = new DefaultContext<>();
context.put("OrderQuery", "com.example.boot.express.data.query.OrderQuery");
try {
    Object r = qlExpressUtil.execute(statement, context);
    System.out.println(r);

} catch (Exception e) {
    e.printStackTrace();
}

上面的写法会报错，因为通过OrderQuery，找到com.example.boot.express.data.query.OrderQuery后，代码逻辑是通过com.example.boot.express.data.query.OrderQuery.class的方式来获取OrderQuery的Class对象，然后再去找Method，如果需要获取，则需要改写为：

context.put("OrderQuery", new OrderQuery());

为什么要宏里写有用？

runner.addMacro("OrderQuery", "com.example.boot.express.data.query.OrderQuery");
String statement = "OrderQuery.test();";
DefaultContext<String, Object> context = new DefaultContext<>();
Object r = qlExpressUtil.execute(statement, context);

它能成功的原因是：因为解析宏时，会用Class.forName()进行加载；而之所以会被这样处理，因为宏中定义的东西，会被解析成OperatorXXX相应的类，而在context中注入的东西，其统一当做字符串处理。

---

官方地址：

https://gitee.com/cuibo119/QLExpress