在现代软件开发中，跨语言集成是常见的需求，尤其是在机器学习领域。许多高效的机器学习模型和库都是用 python 开发的，但核心业务逻辑可能运行在 java 平台上。为了在 java 应用中利用这些 python 模型，我们需要一种可靠的机制来实现两者之间的通信和调用。jython 作为 python 在 java 虚拟机（jvm）上的实现，提供了一种直接在 java 环境中执行 python 代码的有效途径。
Jython 简介与集成原理
Jython 是 Python 语言在 Java 平台上的一个实现。它允许开发者用 Python 语言编写程序，并在 JVM 上运行。Jython 的主要优势在于能够无缝地与 Java 代码进行交互：Python 代码可以导入和使用 Java 类库，反之，Java 代码也可以实例化和调用 Python 对象。这种双向互操作性使得 Jython 成为在 Java 应用中集成 Python 模块，特别是机器学习模型的理想选择。
其核心原理是，Jython 解释器在 JVM 内部运行，将 Python 代码编译成 Java 字节码，或者直接解释执行。通过 Jython，Java 程序可以获得一个 Python 解释器实例，然后利用该实例加载并执行 Python 脚本，进而获取 Python 对象（如模型实例或函数）的引用，并像调用普通 Java 对象一样调用其方法。
核心集成步骤
在 Java 应用中集成 Python 机器学习模型主要涉及以下几个步骤：
- 准备 Python 模型代码： 确保 Python 代码是纯 Python 实现，不依赖 C 扩展（如 NumPy、TensorFlow 等的底层 C/C++ 实现），因为 Jython 无法直接运行这些 C 扩展。
- 配置 Jython 依赖： 将 Jython 的 JAR 包添加到 Java 项目的类路径中。
- 在 Java 中创建 Python 解释器： 实例化 PythonInterpreter 类。
- 执行 Python 脚本： 使用解释器加载并执行包含模型定义的 Python 文件。
- 获取 Python 对象： 从解释器中获取 Python 模型实例或函数的引用。
- 调用 Python 方法： 通过获取到的引用，在 Java 中调用 Python 对象的方法，并处理返回值。
1. Python 模型准备
首先，我们需要一个简单的 Python 分类器模型。为了演示目的，我们创建一个不依赖 C 扩展的纯 Python 类。
立即学习“Java免费学习笔记（深入）”；
classifier_model.py
# classifier_model.py
class SimpleClassifier:
"""
一个简单的分类器类，用于演示在Java中调用Python对象。
"""
def __init__(self, offset=1):
self.offset = offset
def classify(self, input_value: int) -> int:
"""
根据输入值进行分类，这里只是简单地加上一个偏移量。
:param input_value: 输入的整数值
:return: 分类结果
"""
print(f"Python: Classifying input {input_value} with offset {self.offset}")
return input_value + self.offset
# 在脚本中实例化分类器，以便Java可以直接获取其引用
# 注意：在实际应用中，您可能需要一个工厂函数来创建模型实例
# 或者在Java中通过反射调用Python类的构造函数。
classifier_instance = SimpleClassifier(offset=10)
# 如果需要，也可以定义一个独立的函数
def predict_score(value: int) -> int:
"""
一个独立的预测函数。
"""
return value * 22. Java 代码实现
接下来，我们编写 Java 代码来加载并调用上述 Python 模型。
iWebMall 是一款高性能高扩展能力的开源 LAMP 电子商务软件，定位为大中型电子商务平台软件，服务于有建立电子商务需求的商业客户。这些商业客户不必学习任何计算机编程代码知识，只需要使用 iWebMall 软件他们就可以轻松建立一个功能强大的网上商城，实现用户注册、产品展示、在线定购、在线支付等电子商务功能；iWebMall 集成了产品发布与查询、会员注册登录、购物车、在线订单、在线支付、在
首先，确保你的项目中已经添加了 Jython 的依赖。如果你使用 Maven，可以在 pom.xml 中添加：
org.python jython-standalone 2.7.3
如果你是手动添加 JAR 包，请下载 jython-standalone-2.7.3.jar（或最新版本）并将其添加到项目的类路径中。
src/main/java/com/example/Main.java
package com.example;
import org.python.core.PyException;
import org.python.core.PyInteger;
import org.python.core.PyObject;
import org.python.util.PythonInterpreter;
public class Main {
public static void main(String[] args) {
// 创建一个 Python 解释器实例
// PythonInterpreter interp = new PythonInterpreter(); // 默认构造函数
// 也可以配置解释器，例如设置sys.path等
PythonInterpreter interp = new PythonInterpreter();
try {
// 加载并执行 Python 脚本文件
// 确保 classifier_model.py 在 Java 应用程序的类路径或工作目录下
// 或者提供完整路径
System.out.println("Java: Executing Python script 'classifier_model.py'...");
interp.execfile("classifier_model.py");
System.out.println("Java: Python script executed.");
// 1. 获取 Python 中定义的类实例 (classifier_instance)
System.out.println("Java: Getting Python object 'classifier_instance'...");
PyObject classifier = interp.get("classifier_instance");
if (classifier == null) {
System.err.println("Java: Failed to get 'classifier_instance' from Python interpreter.");
return;
}
// 准备输入参数
int inputValue = 5;
PyInteger pyInput = new PyInteger(inputValue);
// 调用 Python 对象的方法
System.out.println("Java: Invoking Python method 'classify' with input " + inputValue + "...");
PyObject result = classifier.invoke("classify", pyInput);
// 将 Python 返回值转换为 Java 类型
int classifiedValue = result.asInt();
System.out.println("Java: Python 'classify' method returned: " + classifiedValue);
System.out.println("Expected: " + (inputValue + 10)); // 因为Python中设置了offset=10
System.out.println("\n--- Demonstrating calling a standalone function ---");
// 2. 获取 Python 中定义的独立函数 (predict_score)
PyObject predictFunction = interp.get("predict_score");
if (predictFunction == null) {
System.err.println("Java: Failed to get 'predict_score' from Python interpreter.");
return;
}
int scoreInput = 7;
PyInteger pyScoreInput = new PyInteger(scoreInput);
System.out.println("Java: Invoking Python function 'predict_score' with input " + scoreInput + "...");
PyObject scoreResult = predictFunction.invoke(pyScoreInput);
int predictedScore = scoreResult.asInt();
System.out.println("Java: Python 'predict_score' function returned: " + predictedScore);
System.out.println("Expected: " + (scoreInput * 2));
} catch (PyException e) {
System.err.println("Java: An error occurred during Python execution: " + e.getMessage());
e.printStackTrace();
} finally {
// 关闭解释器，释放资源
interp.cleanup();
}
}
}代码运行说明
- 将 classifier_model.py 文件放置在 Java 项目的资源目录（例如 src/main/resources）或者可以直接访问的路径下。如果放在资源目录，execfile 可能需要调整路径或使用 getResourceAsStream。最简单的方式是将其放在与 Java Main.java 编译后的 .class 文件相同的根目录下，或者在启动 Java 应用时确保其在当前工作目录。
- 编译并运行 Main.java。
预期输出示例：
Java: Executing Python script 'classifier_model.py'... Java: Python script executed. Java: Getting Python object 'classifier_instance'... Java: Invoking Python method 'classify' with input 5... Python: Classifying input 5 with offset 10 Java: Python 'classify' method returned: 15 Expected: 15 --- Demonstrating calling a standalone function --- Java: Getting Python object 'predict_score'... Java: Invoking Python function 'predict_score' with input 7... Java: Python 'predict_score' function returned: 14 Expected: 14
注意事项
- C 扩展限制： Jython 最大的限制是它不能运行依赖于 C 语言实现的 Python 库，例如 NumPy、Pandas、TensorFlow、PyTorch 等。这些库的底层通常是 C/C++ 代码，Jython 无法直接处理。这意味着，如果你的机器学习模型严重依赖这些库，Jython 可能不是最佳选择。
- 性能考量： 尽管 Jython 提供了无缝集成，但在某些性能敏感的场景下，Python 代码在 Jython 上的执行速度可能不如原生 Python 解释器。
- Jython 版本兼容性： 确保使用的 Jython 版本与你的 Python 代码兼容。Jython 2.7.x 系列对应 Python 2.7，目前没有完整的 Python 3.x 系列的 Jython 版本。
- 错误处理： 在 Java 代码中，需要妥善处理 PyException，以便捕获和记录 Python 脚本执行过程中可能出现的错误。
-
替代方案： 如果模型依赖 C 扩展，或者需要更好的性能和隔离性，可以考虑以下替代方案：
- REST API / gRPC： 将 Python 模型部署为一个独立的微服务（例如使用 Flask, FastAPI 或 gRPC），Java 应用通过 HTTP/gRPC 调用该服务。这是最常见且推荐的方案。
- ONNX / PMML： 将训练好的模型导出为 ONNX (Open Neural Network Exchange) 或 PMML (Predictive Model Markup Language) 等通用格式。Java 应用可以使用相应的库（如 ONNX Runtime for Java）直接加载和执行这些模型，无需 Python 环境。
- Java 重写： 如果模型逻辑不复杂，可以考虑直接用 Java 重写模型。
- Runtime.exec()： 在 Java 中通过 Runtime.exec() 调用外部 Python 脚本。这种方法隔离性强，但管理复杂，且数据传输效率低。
总结
Jython 为 Java 应用程序提供了一种直接、简洁的方式来集成和调用纯 Python 代码，特别适用于那些不依赖 C 扩展的机器学习模型或业务逻辑。通过创建 Python 解释器、执行 Python 脚本并获取 Python 对象的引用，Java 开发者可以无缝地利用 Python 生态系统的优势。然而，在选择 Jython 方案时，务必考虑其对 C 扩展的限制以及潜在的性能影响，并根据实际需求权衡是否采用其他更适合的跨语言集成策略。
