函数

外部函数

并非通过 DataQL 语句定义的函数都是外部函数。使用外部函数通常需要编写 Java 代码，然后在 DataQL 查询中将其导入之后才可以使用。

例如：下面这个函数就是返回一个 DataBean 对象：

public class DemoUdf implements Udf {
    @Override
    public Object call(Hints readOnly, Object[] params) {
        return new DataBean();
    }
}

然后通过 import 语句导入，导入之后就可以正常使用这个函数了。

import 'net.demo.packages.DemoUdf' as demo;
var data = demo() => { ... };
...

提示

使用外部函数需要用到的语句是 import 语句，更多外部函数的技巧需要在开发手册中查阅。

定义函数

在 DataQL 查询中可以定义一个函数，然后在后续查询中使用它。一个典型的场景就是对性别字段的转换。定义函数的语法如下：

var foo = (param1,param2,...) -> {
    <语句1>;
    <语句2>
    <语句3>
}

其中 foo 是函数名，param1、param2是函数的参数。``{ … } 花括号中间是函数体。定义的函数和外部函数的用法完全一样，只是函数的逻辑部分是通过 DataQL 来编写的。这有点类似 存储过程。

var foo = () -> {
    return { ... } // 返回一个数据体
}
var data = foo() => { ... }; // 对 foo 数据体进行结构变换
...

Lambda

例如在使用 net.hasor.dataql.sdk.CollectionUdfSource 函数包进行数据过滤时，需要指定一个过滤函数。在不使用 Lambda 表达式之前需要定义一个函数。

import 'net.hasor.dataql.sdk.CollectionUdfSource' as collect;
var dataSet = ...
var foo = (dat) -> {
    return test.parent_id == null; // 返回一个数据体
}
return collect.filter(dataSet, foo);

Lambda 可以帮助减少对函数的声明，例如简写为：

import 'net.hasor.dataql.sdk.CollectionUdfSource' as collect;
var dataSet = ...
return collect.filter(dataSet, (dat) -> { return test.parent_id == null; });