Py4J 技术文档

1. 安装指南

1.1 环境要求

• Python 3.8及以上版本
• Java Development Kit (JDK) 1.8及以上版本

1.2 安装步骤

1. 从 PyPI 安装 Py4J：

   pip install py4j
   

2. 确保已安装 Java 并配置好环境变量。

3. 运行以下命令以验证安装：

   python -c "from py4j.java_gateway import JavaGateway; gateway = JavaGateway();"
   

如果未出现错误，表示 Py4J 已成功安装。

2. 项目使用说明

Py4J 允许 Python 程序在 Python 解释器中动态访问 Java 虚拟机中的 Java 对象。调用方法时，就像 Java 对象驻留在 Python 解释器中一样，Java 集合也可以通过标准的 Python 集合方法进行访问。Py4J 还允许 Java 程序回调 Python 对象。

2.1 基本用法

1. 创建一个 JavaGateway 实例来连接到 JVM：

   from py4j.java_gateway import JavaGateway
   gateway = JavaGateway()
   

2. 创建一个 Java 类的实例：

   from py4j.java_gateway import JavaGateway
   gateway = JavaGateway()
   random = gateway.jvm.java.util.Random()
   

3. 调用 Java 对象的方法：

   number1 = random.nextInt(10)
   number2 = random.nextInt(10)
   print(number1, number2)
   

4. 访问 Java 集合：

   list = gateway.jvm.java.util.ArrayList()
   list.add("Hello")
   list.add("World")
   for item in list:
       print(item)
   

5. 关闭 JavaGateway：

   gateway.close()
   

3. 项目API使用文档

Py4J 提供了以下主要类和方法：

JavaGateway 类

• JavaGateway(): 创建一个新的 JavaGateway 实例。
• close(): 关闭 JavaGateway 连接。
• jvm: 访问 JVM 中的 Java 类和方法。

4. 项目安装方式

除了通过 PyPI 安装外，您还可以通过以下方式安装 Py4J：

4.1 源代码安装

1. 从 Py4J 的 GitHub 仓库克隆代码：

   git clone https://github.com/py4j/py4j.git
   

2. 切换到项目目录：

   cd py4j
   

3. 安装项目依赖：

   pip install -r requirements.txt
   

4. 编译 Java 代码：

   cd py4j-java
   gradlew clean
   gradlew assemble
   

5. 返回项目目录，安装 Python 代码：

   cd py4j-python
   pip install .
   

完成以上步骤后，Py4J 即可使用。