Python调用Java代码的桥梁：JPype

jopen 10年前

JPype 是 Python 代码调用 Java 代码的桥梁。利用它可以使 Python 程序方便的调用 Java 代码，从而扩充 Python 语言的能力，弥补 Python 语言的不足。

概览

JPype 是一个能够让 python 代码方便地调用 Java 代码的工具，从而克服了 python 在某些领域（如服务器端编程）中的不足。

下载

JPype 可以从 sourceforge 网站上下载：http://sourceforge.net/projects/jpype/ 目前 JPype 最新的版本为 0.5.4，支持 python 2.5 和 2.6. 本文以 Windows XP 平台，python 2.5.4 为例阐述。

安装

安装 JPype 前需要先安装 python 。从 http://www.python.org/download 下载 python 并安装，安装路径选择 C:\Python25\，安装完成后在本地 C 盘应有 C:\Python25 目录，该目录下有 python.exe 文件。 Python 安装完后，双击下载的 JPype 安装文件即可安装 JPype 。

许可证

JPype 遵循的许可证是 Apache License V2.0 。

JPype 的使用

一个简单的 hello world 程序

下面是一个简单的 python 程序，通过 JPype 调用 Java 的打印函数，打印出字符串。

清单 1. hello world

import jpype
jvmPath = jpype.getDefaultJVMPath()
jpype.startJVM(jvmPath)
jpype.java.lang.System.out.println( “ hello world! ” )
jpype.shutdownJVM()

启动 JVM

JPype 提供的 startJVM() 函数的作用是启动 JAVA 虚拟机，所以在后续的任何 JAVA 代码被调用前，必须先调用此方法启动 JAVA 虚拟机。

    jpype.startJVM() 的定义

    startJVM(jvm, *args)

    jpype.startJVM() 的参数

    参数 1： jvm, 描述你系统中 jvm.dll 文件所在的路径，如“ C:\Program Files\IBM\Java50\jre\bin\j9vm\jvm.dll ”。可以通过调用 jpype.getDefaultJVMPath() 得到默认的 JVM 路径。

    参数 2： args, 为可选参数，会被 JPype 直接传递给 JVM 作为 Java 虚拟机的启动参数。此处适合所有合法的 JVM 启动参数，例如：

    -agentlib:libname[=options]
     -classpath classpath
     -verbose
     -Xint

清单 2. jpype.startJVM() 的用法示例

import jpype
jvmPath = jpype.getDefaultJVMPath()
jvmArg = “ -Xint ”
jpype.startJVM(jvmPath，jvmArg)

判断 JVM 是否启动

JPype 提供的 jpype.isJVMStarted() 函数的作用是判断 JVM 是否已启动。

    jpype.isJVMStarted() 的定义
    isJVMStarted()
    jpype.isJVMStarted() 的返回值
    返回值为 True 表示 JVM 已经启动，返回值为 False 表示 JVM 还未启动

清单 3. jpype.isJVMStarted() 的用法示例

import jpype
jvmPath = jpype.getDefaultJVMPath()
jvmArg = “ -Xint ”
if not jpype.isJVMStarted():
    jpype.startJVM(jvmPath，jvmArg)

关闭 JVM

当使用完 JVM 后，可以通过 jpype.shutdownJVM() 来关闭 JVM，该函数没有输入参数。当 python 程序退出时，JVM 会自动关闭。

引用第三方的 Java 扩展包

很多时候，在 python 项目中需要调用第三方的 Java 扩展包，这也是 JPype 的一个重要用途。为了使编程者方便地在 python 代码中调用已有的 Java 扩展包，我们可以再在 JVM 启动参数增加：

-Djava.class.path=ext_classpath

以下为调用第三方 Java 扩展包示例，（假设第三方 Java 扩展包的所在路径是 E:\JavaExt）

清单 4. 调用第三方 Java 扩展包示例

import jpype
jvmPath = jpype.getDefaultJVMPath()
ext_classpath = “ E:\JavaExt ”
jvmArg = “ -Djava.class.path = ” + ext_classpath
if not jpype.isJVMStarted():
    jpype.startJVM(jvmPath, jvmArg)

访问 Java 的系统属性

有时，某些 Java 应用需要设置或者获取 JVM 中的系统属性。

    在 JVM 启动时设置系统变量示例：
    在 JVM 的启动参数中加入如下参数：
    -Dproperty=value
    假设你要设置的属性名为 yourProperty，属性值为 yourValue 。

清单 5. JVM 启动时设置系统变量示例

import jpype
jvmPath = jpype.getDefaultJVMPath()
jvmArg = “ -DyourProperty=yourValue ”
if not jpype.isJVMStarted():
    jpype.startJVM(jvmPath，jvmArg)

清单 6. 在程序中设置系统变量示例

import jpype
prop = “ yourProperty ”
value = “ yourValue ”
system = jpype.JClass('java.lang.System')
system.setProperty(str(prop),str(value))

清单 7. 在程序中获取系统变量示例

import jpype
prop = “ yourProperty ”
system = jpype.JClass('java.lang.System')
value = system.getProperty(str(prop))

Java 类型到 python 类型的转换

表 1. Java 类型到 python 类型的转换
Java 类型转换成的 python 类型
byte, short and int int
long long
float and double float
boolean int of value 1 or 0
char unicode of length 1
String unicode
arrays JArray
other Java object JavaObject
Class JavaClass
array Class JavaArrayClass

Python调用Java代码的桥梁：JPype

相关经验

目录