公式组件概述

公式组件是以接口的方式提供算数、字符串运算能力的组件。使用者定义公式和变量，公式组件根据公式和变量值进行运算并返回运算结果。

整体设计

依赖环境

组件采用Maven进行编译和打包发布，其对外提供的依赖方式如下：

    <dependency>
      <groupId>com.yonyou.iuap</groupId>
      <artifactId>iuap-formula</artifactId>
      <version>${iuap.modules.version}</version>
    </dependency>

${iuap.modules.version} 为平台在maven私服上发布的组件的version。

功能说明

1. 支持公式定义和执行；
2. 支持公式批量执行；
3. 提供数学运算、字符串运算能力
4. 支持自定义函数功能扩展公式；

使用说明

说明简介

下文主要是对公式组件的基本使用进行简要说明，对公式函数中的一些特殊情况加以说明，并对公式函数自定义扩展功能予以介绍

调用说明

通过FormulaParseFather执行公式。

示例：

        String formula = "a->abs(data)";
        FormulaParseFather f = new FormulaParse();;
        f.setExpress(formula);
        f.addVariable("data", new Object[] { 1, -2, 0 });
        Object[][] result = f.getValueOArray();
        assertEquals("应该相等", 1, result[0][0]);
        assertEquals("应该相等", 2, result[0][1]);
        assertEquals("应该相等", 0, result[0][2]);

函数介绍

1.字符串函数

1.1 charat(string,index)

公式含义

得到字符串string中第index个字符

对应类：nc.vo.pub.formulaset.function.CharAt

类型返回值表

1.2 endswith(string, end)

公式含义

判断字符串string是否以字符串end结尾

对应类：nc.vo.pub.formulaset.function.EndsWith

类型返回值表

1.3 equalsIgnoreCase(string1, string2)

公式含义

判断忽略大小写字符串string1是否与字符串string2相等

对应类：nc.vo.pub.formulaset.function.EqualsIgnoreCase

类型返回值表

1.4 indexOf(st1, st2)

公式含义

判断字符串st1中第一个字符串st2所在的位置,比如lastIndexOf("HI,UAP2006, UAP","UAP")返回3.

对应类：nc.vo.pub.formulaset.function.IndexOf

类型返回值表

1.6 lastIndexOf(st1, st2)

公式含义

判断字符串st1中最后一个字符串st2所在的位置,比如lastIndexOf("HI,UAP2006,UAP","UAP")返回11.

对应类：nc.vo.pub.formulaset.function.LastIndexOf

类型返回值表

1.7 left(st, index)

公式含义

求字符串st左边前index个字符组成的字符串 对应类：nc.vo.pub.formulaset.function.Left

类型返回值表

1.8 leftStr(st,len,defaultStr)

公式含义

求字符串st左边前len个字符组成的字符串，如果字符串长度小于len，则用defaultStr补齐,比如leftStr("abc",6,"@")将返回abc@@@.

对应类：nc.vo.pub.formulaset.function.LeftStr

类型返回值表

1.9 length(st)

公式含义

求字符串st的长度

对应类：nc.vo.pub.formulaset.function.Length

类型返回值表

1.10 mid(String st, int start, int end)

公式含义

求字符串st左边前第start个字符至第end个字符之间的字符串

对应类：nc.vo.pub.formulaset.function.Mid

类型返回值表

1.11 right(String st, int index)

公式含义

求字符串st右边前index个字符组成的字符串 对应类：nc.vo.pub.formulaset.function.Right

类型返回值表

1.12 rightStr(st,len,defaultStr)

公式含义

求字符串st右边后len个字符组成的字符串，如果字符串长度小于len，则用defaultStr补齐,比如rightStr("abc",6,"@")将返回abc@@@. 对应类：nc.vo.pub.formulaset.function.RightStr

类型返回值表

1.13 startsWith(String st, String start)

公式含义

判断字符串st是否以字符串start开头

对应类：nc.vo.pub.formulaset.function.StartsWith 类型返回值表

1.14 toLowerCase(String st)

公式含义

求字符串st的小写形式,比如toLowerCase("Abc")返回"abc"。

对应类：nc.vo.pub.formulaset.function.ToLowerCase 类型返回值表

1.16 toUpperCase(String st)

公式含义

求字符串st的大写形式。

对应类：nc.vo.pub.formulaset.function.ToUpperCase

类型返回值表

注：参数不能为null

2.10 ln(x)

公式含义

返回给定数值x的自然对数；

对应类：nc.vo.pub.formulaset.function.NaturalLogarithm

类型返回值表

注：参数不能为null，Comparable：java.lang.Comparable。

2.13 min(x, y)

公式含义

求x,y两者中的最小值；

对应类：nc.vo.pub.formulaset.function.Min

类型返回值表

2.14 mul(num1,num2)

公式含义

用于高精度乘法运算；

对应类：nc.vo.pub.formulaset.function.MultiplyBigNumber

类型返回值表

注：其他情况下，会使用*操作进行运算

2.15 round(double num, int index)

公式含义

对num保留index位小数(四舍五入)；

对应类：nc.vo.pub.formulaset.function.Round

类型返回值表

注：其他的情况下，将会用普通-的方式进行运算

2.20 tan(x)

公式含义

返回给定角度x的正切值；

对应类：nc.vo.pub.formulaset.function.Tangent

类型返回值表

2.24 angle(x,y)

公式含义

以弧度为单位计算并返回点y/x的角度。

对应类：nc.vo.pub.formulaset.function.Angle

类型返回值表

2.25 asinh(param)

公式含义

asinh(z) = log(z + sqrt(z*z + 1))

对应类：nc.vo.pub.formulaset.function.ArcSineH

类型返回值表

2.26 atanh(param)

公式含义

asinh(z) = log(z + sqrt(z*z + 1))

对应类：nc.vo.pub.formulaset.function.ArcTanH

类型返回值表

2.27 cosh(param)

公式含义

cosh(z) = ( exp(z) + exp(-z) ) / 2

对应类：nc.vo.pub.formulaset.function.CosineH

类型返回值表

2.28 mod(x, y)

公式含义

求模运算

对应类：nc.vo.pub.formulaset.function.Modulus

类型返回值表

2.29 rand()

公式含义

生成随机数

对应类：nc.vo.pub.formulaset.function.Random

类型返回值 返回new Double(Math.random())

2.30 sinh(param)

公式含义

sinh(z) = ( exp(z) - exp(-z) ) / 2

对应类：nc.vo.pub.formulaset.function.SineH

类型返回值表

2.31 sum(x,y)

公式含义

计算两个数的和

对应类：nc.vo.pub.formulaset.function.Sum

类型返回值表

2.32 tanh(param)

公式含义

tanh(z) = sinh(z) / cosh(z)

对应类：nc.vo.pub.formulaset.function.TanH

类型返回值表

自定义公式扩展说明

公式提供自定义函数功能。自定义函数配置文件目录如下：

WEB-INF\classes\formulaconfig

配置文件格式如下：

    <?xml version="1.0" encoding="utf-8"?>
    <formula-array>
    <formula>
      <customType>0</customType>
      <functionName>FORMATADDRESS</functionName>
      <functionClass>nc.ui.bd.pubinfo.address.FormatAddress</functionClass>
    </formula>
    </formula-array>

自定义公式的实现方法可以参见nc.vo.pub.formulaset.function.Max这个类