Java/Android解析数学表达式方法

本文详细阐述了如何在Java/Android环境中，利用Mozilla Rhino JavaScript引擎将包含加减乘除等数学符号的字符串表达式（如“5+5”）转换为可计算的数值类型。通过集成Rhino库，开发者可以安全有效地对字符串形式的数学表达式进行求值，并获取精确的整数或浮点数结果，从而解决标准类型转换方法无法直接处理复杂表达式的问题。

引言：字符串数学表达式求值的挑战

在Java或Android开发中，我们经常会遇到需要将字符串转换为数值类型（如int或double）的场景。然而，当字符串中不仅包含数字，还包含数学运算符（如+, -, *, /）时，标准的类型转换方法（如Integer.parseInt()或Double.parseDouble()）将无法直接处理，因为它们期望的是纯数字字符串。例如，尝试将字符串“5+5”直接转换为整数或双精度浮点数会导致NumberFormatException。此时，我们需要一种机制来“评估”或“计算”这个字符串所代表的数学表达式，而不仅仅是进行简单的类型转换。

解决方案：利用Rhino JavaScript引擎

为了解决这一问题，一个强大且灵活的方案是利用Mozilla Rhino JavaScript引擎。Rhino是一个用Java编写的开源JavaScript引擎，它允许Java应用程序执行JavaScript代码。这意味着我们可以将包含数学表达式的字符串视为JavaScript表达式，然后通过Rhino引擎进行求值。由于JavaScript本身能够处理数学运算，这种方法可以有效地计算字符串中的表达式并返回结果。

集成Rhino库

要在您的Java或Android项目中集成Rhino引擎，您需要将其作为依赖项添加到项目的构建文件中。对于Gradle项目，您可以在build.gradle文件中添加以下依赖：

implementation 'io.apisense:rhino-android:1.1.1'

请注意，io.apisense:rhino-android是Rhino的一个Android优化版本。如果您是在纯Java项目中使用，也可以考虑使用官方的org.mozilla:rhino库。

实现表达式求值

集成Rhino库后，您可以通过ScriptEngineManager类获取Rhino的ScriptEngine实例，并使用其eval()方法来评估字符串表达式。

以下是实现这一过程的详细步骤和示例代码：

1. 获取ScriptEngine实例： 使用ScriptEngineManager创建一个新的实例，并通过getEngineByName("rhino")获取Rhino引擎。如果引擎未找到，应抛出异常或进行适当的错误处理。
2. 评估表达式： 调用engine.eval(expressionString)方法，其中expressionString是您要计算的数学表达式字符串（例如“5+5”）。eval()方法会返回一个Object类型的结果。
3. 处理结果： eval()方法返回的结果是一个Java Object。您需要将其转换为适当的数值类型（如double或int）。
4. 异常处理： 在执行eval()方法时，可能会发生ScriptException或其他运行时异常，因此建议使用try-catch块来捕获并处理这些异常。

示例代码

import javax.script.ScriptEngine;
import javax.script.ScriptEngineManager;
import javax.script.ScriptException;
import android.util.Log; // 仅适用于Android项目，Java项目可使用System.out.println

public class ExpressionEvaluator {

    private static final String TAG = "ExpressionEvaluator";

    /**
     * 评估一个包含数学符号的字符串表达式。
     *
     * @param expression 待评估的字符串表达式，例如 "5+5", "(10*2)/4", "7.5 + 2.1"
     * @return 表达式的计算结果，以double类型返回
     * @throws UnsupportedOperationException 如果Rhino JavaScript引擎未找到
     * @throws ScriptException 如果表达式评估失败
     * @throws NumberFormatException 如果结果无法转换为double
     */
    public double evaluateMathematicalExpression(String expression) 
            throws UnsupportedOperationException, ScriptException, NumberFormatException {

        Object result = null;
        ScriptEngine engine = new ScriptEngineManager().getEngineByName("rhino");

        if (engine == null) {
            // 如果Rhino引擎未找到，通常意味着依赖未正确配置或环境不支持
            throw new UnsupportedOperationException("JavaScript scripting engine 'rhino' not found. " +
                                                    "Please ensure the Rhino library is correctly added to your project dependencies.");
        }

        try {
            // 使用eval方法评估JavaScript表达式
            result = engine.eval(expression); 
            Log.i(TAG, "Expression: " + expression + ", Raw Result: " + result);

            // 将Object类型的结果转换为double
            // Rhino返回的数值通常是Double类型，但eval()的返回类型是Object
            double val = Double.parseDouble(result.toString());
            Log.i(TAG, "Evaluated Result: " + val);
            return val;

        } catch (ScriptException e) {
            // 捕获脚本执行期间的错误，例如语法错误
            Log.e(TAG, "Error evaluating expression '" + expression + "': " + e.getMessage(), e);
            throw e; // 重新抛出，让调用者处理
        } catch (NumberFormatException e) {
            // 捕获结果转换为double时的错误
            Log.e(TAG, "Error converting result '" + result + "' to double: " + e.getMessage(), e);
            throw e;
        } catch (Exception e) {
            // 捕获其他未知异常
            Log.e(TAG, "An unexpected error occurred: " + e.getMessage(), e);
            throw new RuntimeException("Unexpected error during expression evaluation", e);
        }
    }

    public static void main(String[] args) {
        ExpressionEvaluator evaluator = new ExpressionEvaluator();
        try {
            // 示例用法
            double result1 = evaluator.evaluateMathematicalExpression("5+5"); // 预期 10.0
            System.out.println("Result of '5+5': " + result1);

            double result2 = evaluator.evaluateMathematicalExpression("(10*2)/4 - 1.5"); // 预期 3.5
            System.out.println("Result of '(10*2)/4 - 1.5': " + result2);

            // 尝试一个包含变量的表达式 (Rhino支持，但需注意变量作用域)
            // engine.put("x", 10); // 如果要使用变量，需要先设置
            // double result3 = evaluator.evaluateMathematicalExpression("x * 2");
            // System.out.println("Result of 'x * 2' (x=10): " + result3);

        } catch (UnsupportedOperationException | ScriptException | NumberFormatException e) {
            System.err.println("Evaluation failed: " + e.getMessage());
        }
    }
}

在上述代码中，engine.eval("5+5")将计算出结果10，然后通过Double.parseDouble(result.toString())将其转换为double类型的10.0。如果您确定结果总是整数，也可以尝试转换为int类型。

注意事项

1. 安全性： Rhino引擎执行的是JavaScript代码。如果允许用户输入任意字符串进行评估，存在潜在的安全风险，因为用户可能会注入恶意JavaScript代码。在生产环境中，强烈建议对输入字符串进行严格的验证和沙箱化处理，以确保只执行合法的数学表达式，避免执行系统命令或访问敏感资源。
2. 性能： 每次创建ScriptEngineManager和ScriptEngine实例都会有一定的开销。如果需要频繁评估表达式，建议重用ScriptEngine实例，而不是每次都重新创建。
3. 错误处理： 务必实现健壮的错误处理机制。当表达式语法不正确或包含非法操作时，eval()方法会抛出ScriptException。
4. 类型转换： eval()方法返回Object类型。Rhino通常会将数值结果包装成java.lang.Double或java.lang.Integer对象。通过result.toString()获取字符串表示，再用Double.parseDouble()或Integer.parseInt()进行转换是一种可靠的方法。
5. 替代方案： 除了Rhino，还有其他专门用于解析和计算数学表达式的库，例如exp4j、JEP等。这些库可能在安全性、性能和表达式解析能力方面提供更专业的解决方案，尤其是在不需要完整JavaScript引擎功能的情况下。

总结

利用Mozilla Rhino JavaScript引擎是在Java/Android应用程序中评估包含数学符号的字符串表达式的有效方法。它通过将字符串视为JavaScript代码来执行求值，从而绕过了标准类型转换的限制。通过正确集成Rhino库并遵循最佳实践，开发者可以构建出能够处理动态数学表达式的强大功能。然而，在实际应用中，务必注意安全性、性能优化和全面的错误处理。