MOQL--操作数(Operand) (一)

        OperandMOQL语法结构的重要组成部分,语法结构中那些需要被分析处理的数据列或数据值都被称之为Operand。如select后跟的数据列,where条件中描述的条件字段以及需要匹配的常数值等都被称之为Operand。如下面语句中的红色字体部分,均表示是一个Operand。通过对其计算,我们可以获得数据结果,并形成最终我们求解的数据结果集。

select count(a.id) cnt,sum(a.num) sum, a.num%500 mod from BeanA a group by3 having mod >10 order by 1

        在MOQL中,Operand不仅能在完整的语法结构中使用,还可以单独使用。MOQL提供了方法可以直接创建一个操作数,并利用此操作数完成数据的求解。如下:

EntityMap entityMap = new EntityMapImpl();

entityMap.putEntity("num", 12);

entityMap.putEntity("num1", 3);

entityMap.putEntity("num2", 4);

try {

    Operand arithmetic = MoqlUtils.createOperand("(num * num1) / num2 * 2.2 + 2 - 1");

    System.out.println(arithmetic.operate(entityMap));

} catch (MoqlException e) {

    e.printStackTrace();

}

        该例中为表达式"(num * num1) / num2 * 2.2 + 2 -1"创建了一个操作数,该操作数利用传入的实体Map对表达式进行了求解,并输出了执行结果,结果为20.8MoqlUtilscreateOperand方法可以创建一个操作数,传给该方法的参数为一个操作数表达式字符串,返回的对象为一个Operand接口,该接口位于org.moql的包路径下,定义如下:

publicinterface Operand {

    /*获得操作数的类型*/

    OperandType getOperandType();

    /*返回操作数的名字*/

    String getName();

    /*返回操作数在文本串中的位置,返回对象类型为org.antlr.runtime.Token */

    Object getSource();

    /*根据给定的实体Map传入的值,计算操作数的值*/

    Object operate(EntityMap entityMap);

    /*根据给定的实体Map传入的值,计算操作数的布尔值。*/

    boolean booleanOperate(EntityMap  entityMap);

    /*操作数的返回值是否为一固定常量。*/

    boolean isConstantReturn();

    /*重置操作数,将操作数状态置为初始状态。*/

    void reset();

}

        getOperandType()方法用于返回Operand的类型OperandTypeOperandType为枚举类型,也位于org.moql的包路径下,定义格式如下:

publicenum OperandType {

    UNKNOWN,   

    CONSTANT,  

    VARIABLE,

    FUNCTION,

    EXPRESSION,

    COLUMNSELECTOR

}

其包括的Operand类型有常量(CONSTANT)、变量(VARIABLE)、函数(FUNCTION)、表达式(EXPRESSION)及列筛选器(COLUMNSELECTOR)五类(:Operand的类型将在后面详细介绍),当Operand不属于以上任何一类时用UNKNOWN未知表示。

        getName()方法用于获得Operand的名字。除了函数类型的Operand的名字为函数名外,其它类型的Operand的名字就是生成Operand的字符串本身。如:“sum(a.num)”整体被解析为一个函数Operand,其名字为“sum”,其内嵌了一个由“a.num”解析而成的表达式Operand作为参数,该Operand名字为“a.num”;再如:“123”被解析为常量Operand,其名字为“123”等。

        getSource()方法用于返回操作数在文本串中的位置。如:“sum(a.num)”会被解析为多个操作数,对每个操作数调用该方法就可以定位操作数在文本串中的位置了。

        operate(EntityMapentityMap)方法是Operand提供的主要方法,利用该方法操作数可以对给定的参数进行求值。EntityMap是一个装有实体对象的Map,其实体名若与变量Operand的名字一致,那么实体对象便会被变量Operand绑定用来求解。

        booleanOperate(EntityMapentityMap)方法是operate(EntityMap entityMap)方法的扩展。用于将Operand的计算结果以布尔值的形式返回。若operate方法返回值的类型是java.lang.Boolean,则该方法返回调用Boolean.booleanValue()所得的值;若operate方法返回值的类型不是java.lang.Boolean,返回值为null时,返回false,否则返回true

        isConstantReturn()方法用于告诉调用者在调用Operandoperate方法后是否总能返回一个不变得常量值。若该Operand是一个常量类型的Operand,则该调用总是返回true,表示调用常量类型Operandoperate方法总是返回同一个常量值。而对于该方法更有意义的用途是在函数类型Operand以及表达式类型Operand中的调用。这两种类型的Operand在初始化时会判断所有其相关的Operand的该方法调用,返回是否都是true。若都是true,则表示该操作数的执行结果与operate调用时传入的EntityMap参数无关,那么就可以预先对该操作数进行求解,而不用等到每次调用operate方法时现去求解了。这样可以在一定程度上提升Operand的执行效率。若对该方法的调用感兴趣,可以查看源代码中

org.moql.operand.function.AbstractFunction类以及org.moql.operand.expression.arithmetic.AbstractArithmeticExpression类的相关初始化实现。

       reset()方法用于重置Operand,将Operand的状态恢复为初始状态。Operand在计算时分为有状态和无状态两种情况。有状态是指当对Operandoperate方法进行多次调用时,其计算结果受以前调用结果的影响;而无状态是指多次调用不会受以前调用结果的影响。对于有状态的Operand需要通过调用reset方法将其状态恢复为初始状态。如:“sum(a.num)”对应的Operand,会累计每次调用operate方法的结果,对每次调用的值求和。若需要重新开始计数,需要调用reset方法将该Operand恢复为初始值。类似的Operand还有countavgmaxmin等聚合函数。

项目地址:http://sourceforge.net/projects/moql/

                      代码路径:svn://svn.code.sf.net/p/moql/code/trunk

新项目地址:https://github.com/colorknight/moql

你可能感兴趣的:(MOQL,Java,LINQ,Memory,SQL)