25.仿简道云公式函数实战-数学函数-FIXED

1. FIXED函数

舍入指定位数 表达式：FIXED(number, decimals) 将数字舍入到指定的小数位数，以十进制数格式对该数进行格式设置，并以数字形式返回结果

入参：

number: 必需。 要进行舍入并转换为文本的数字 decimals: 必需。 小数点右边的位数

返回值：

类型：数值 返回值规则：返回的值舍入到指定小数位数 公式目的：将数字舍入到指定第2个小数位数

2. 函数用法

FIXED(number, [decimals])

3. 函数示例

将数字舍入到指定的小数位数，以十进制数格式对该数进行格式设置，并以文本形式返回结果。 number: 必需。 要进行舍入并转换为文本的数字。 decimals: 可选。 小数点右边的位数。

4. 代码实战

首先我们在function包下创建math包，在math包下创建FixedFunction类，代码如下：

package com.ql.util.express.self.combat.function.math;

import com.ql.util.express.Operator;
import com.ql.util.express.self.combat.exception.FormulaException;

import java.math.BigDecimal;
import java.text.DecimalFormat;

/**
 * 类描述: FIXED函数
 *
 * @author admin
 * @version 1.0.0
 * @date 2023/11/23 11:04
 */
public class FixedFunction extends Operator {

    public FixedFunction(String name) {
        this.name = name;
    }

    @Override
    public Object executeInner(Object[] list) throws Exception {

        if (list.length != 2) {
            throw new FormulaException("操作数异常");
        }

        int decimals = 0;
        if (list[1] instanceof Integer) {
            decimals = Integer.parseInt(list[1].toString());
        } else {
            throw new FormulaException("FIXED公式的第二个参数只适用于Integer"+list[1]);
        }

        BigDecimal number = new BigDecimal(list[0].toString());

        BigDecimal result = roundToDecimals(number, decimals);
        String formattedNumber = formatNumber(result, decimals);

        return formattedNumber;
    }

    public static BigDecimal roundToDecimals(BigDecimal number, int decimals) {
        return number.setScale(decimals, BigDecimal.ROUND_HALF_UP);
    }

    public static String formatNumber(BigDecimal number, int decimals) {
        StringBuilder zeros = new StringBuilder();
        for (int i = 0; i < decimals; i++) {
            zeros.append("0");
        }
        DecimalFormat decimalFormat = new DecimalFormat("#." + zeros.toString());
        return decimalFormat.format(number);
    }
}

把FixedFunction类注册到公式函数入口类中，代码如下：

package com.ql.util.express.self.combat.ext;

import com.ql.util.express.ExpressRunner;
import com.ql.util.express.IExpressResourceLoader;
import com.ql.util.express.parse.NodeTypeManager;
import com.ql.util.express.self.combat.function.logic.*;
import com.ql.util.express.self.combat.function.math.*;

/**
 * 类描述: 仿简道云公式函数实战入口类
 *
 * @author admin
 * @version 1.0.0
 * @date 2023/11/21 15:29
 */
public class FormulaRunner extends ExpressRunner {

    public FormulaRunner() {
        super();
    }

    public FormulaRunner(boolean isPrecise, boolean isTrace) {
        super(isPrecise,isTrace);
    }

    public FormulaRunner(boolean isPrecise, boolean isStrace, NodeTypeManager nodeTypeManager) {
        super(isPrecise,isStrace,nodeTypeManager);
    }

    public FormulaRunner(boolean isPrecise, boolean isTrace, IExpressResourceLoader iExpressResourceLoader, NodeTypeManager nodeTypeManager) {
        super(isPrecise,isTrace,iExpressResourceLoader,nodeTypeManager);
    }

    @Override
    public void addSystemFunctions() {
        // ExpressRunner 的内部系统函数
        super.addSystemFunctions();
        // 扩展公式函数
        this.customFunction();
    }
    /***
     * 自定义公式函数
     */
    public void customFunction() {

        // 逻辑公式函数
        this.addLogicFunction();

        // 数学公式函数
        this.addMathFunction();
    }

    public void addLogicFunction() {
        // AND函数
        this.addFunction("AND",new AndFunction("AND"));

        // IF函数
        this.addFunction("IF",new IfFunction("IF"));

        // IFS函数
        this.addFunction("IFS",new IfsFunction("IFS"));

        // XOR函数
        this.addFunction("XOR",new XorFunction("XOR"));

        // TRUE函数
        this.addFunction("TRUE",new TrueFunction("TRUE"));

        // FALSE函数
        this.addFunction("FALSE",new FalseFunction("FALSE"));

        // NOT函数
        this.addFunction("NOT",new NotFunction("NOT"));

        // OR函数
        this.addFunction("OR",new OrFunction("OR"));
    }

    public void addMathFunction() {
        // ABS函数
        this.addFunction("ABS",new AbsFunction("ABS"));

        // AVERAGE函数
        this.addFunction("AVERAGE",new AvgFunction("AVERAGE"));

        // CEILING函数
        this.addFunction("CEILING",new CeilingFunction("CEILING"));

        // RADIANS函数
        this.addFunction("RADIANS",new RadiansFunction("RADIANS"));

        // COS函数
        this.addFunction("COS",new CosFunction("COS"));

        // COT函数
        this.addFunction("COT",new CotFunction("COT"));

        // COUNT函数
        this.addFunction("COUNT",new CountFunction("COUNT"));

        // COUNTIF函数
        this.addFunction("COUNTIF",new CountIfFunction("COUNTIF"));

        // FIXED函数
        this.addFunction("FIXED",new FixedFunction("FIXED"));

    }
}

创建测试用例

package com.ql.util.express.self.combat;

import com.ql.util.express.DefaultContext;
import com.ql.util.express.self.combat.ext.FormulaRunner;
import org.junit.Test;

/**
 * 类描述: 实战测试类
 *
 * @author admin
 * @version 1.0.0
 * @date 2023/11/21 15:45
 */
public class CombatTest {

    @Test
    public void FIXED() throws Exception{

        FormulaRunner formulaRunner = new FormulaRunner(true,true);
        // 创建上下文
        DefaultContext context = new DefaultContext<>();
        String express = "FIXED(成绩, 2)";
        context.put("成绩",3.1415);
        Object object = formulaRunner.execute(express, context, null, true, true);
        System.out.println(object);

    }

}

运行结果