一.JPype简述
1.JPype是什么?
JPype是一个能够让 python 代码方便地调用 Java 代码的工具,从而克服了 python 在某些领域(如服务器端编程)中的不 足。
2.JPype与Jython(JPython后继者)的区别?
1)运行环境不同:jython运行在jvm上,而JPype的实际运行环境仍然是python runtime,只是在运行期间启动了一个嵌入的jvm;
2)使用者不同:jython是给java程序玩的,JPype是给python程序员玩的。
二.安装jpype
2.1 pip安装:pip install jpype1 (后面要加一个1)
2.2 exe方式安装:
1.先安装Python2.7和JAVA1.6(必须是javaSE-1.6)
2.安装JPype-0.5.4.2.win32-py2.7.exe(http://sourceforge.net/projects/jpype/files/JPype/0.5.4/)
3.Ubuntu12.04安装命令:sudo apt-get install python-jpype
三.启动JVM
JPype 提供的 startJVM() 函数的作用是启动 JAVA 虚拟机,所以在后续的任何 JAVA 代码被调用前,必须先调用此方法启动 JAVA 虚拟机。
3.1) jpype.startJVM() 的定义:
startJVM(jvm, *args)
3.2) 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
四.关闭JVM
当使用完 JVM 后,可以通过 jpype.shutdownJVM() 来关闭 JVM,该函数没有输入参数。当 python 程序退出时,JVM 会自动关闭。
五.引用第三方Java扩展包
python 项目中需要调用第三方的 Java 扩展包,这也是 JPype 的一个重要用途:。
通过在 JVM 启动参数增加:-Djava.class.path=ext_classpath,实现在 python 代码中调用已有的 Java 扩展包。
六.访问JAVA的系统属性
有时,某些 Java 应用需要设置或者获取 JVM 中的系统属性。
在 JVM 启动时设置系统变量示例:
在 JVM 的启动参数中加入如下参数:
-Dproperty=value
举例
1.简单的直接调用JAVA API
from jpype import *
startJVM("C:/KFSofts/jre6/bin/client/jvm.dll", "-ea")
java.lang.System.out.println("Hello World")
shutdownJVM()
2. 将JAVA代码打包成第三方jar包
1)JAVA自定义第三方jar包:将project1demo类打包为project1.jar文件并存储到指定目录下:
1.java代码内容:
package project1;
public class sort {
public static void main(String[] args) {
sort t2= new sort();
System.out.println(t2.calc(1, 2));
}
public int calc(int a, int b) {
return a + b;
}
}
2.java.exe程序打包为.jar过程:
2.1第一步:在project1demo鼠标右键,选择expoort:
2.2第二步:如图选择,完成后点击
2.3第三步:如图选择,完成后点击“finish”(注意此页面还可以选择文件导出路径,刚好被注意2处下拉框遮住了)
#注意注意:使用eclipse版本不同,可能界面有差异,不过大致步骤和流程一样的。
3.Python调用第三方JAVA jar包程序
#coding=utf-8
import jpype
import os.path
jarpath = os.path.join(os.path.abspath('.'), 'C:/Users/Administrator/Desktop/pyjava/NewLibrary/')
jpype.startJVM("C:/KFSofts/jre6/bin/client/jvm.dll","-ea", "-Djava.class.path=%s" % (jarpath + 'project2.jar'))
#多个jar包:
#startJVM(getDefaultJVMPath(),"-ea","-Djava.class.path=%s;%s"%(jarpath,jarpath2))
#jpype.java.lang.System.out.println("Hello World")
JDClass = jpype.JClass("project1.sort") #jpype.JClass("包名.类名")
jd = JDClass()#实例化对象
print jd.calc(1,2)
注意事项:
1-JDClass = jpype.JClass("project1.sort") #jpype.JClass("包名.类名")
2-jd=JDClass()#实例化对象要根据jar中方法决定是否实例化,如果静态(static)方式定义函数,不需实例化
3-#多个jar包:
#startJVM(getDefaultJVMPath(),"-ea","-Djava.class.path=%s;%s"%(jarpath,jarpath2))
错误处理
1.RuntimeError: No matching overloads found for XXX in find. at native\common\jp_method.cpp:127
或是 RuntimeError: No matching overloads found for XXX in find. at native\common\jp_method.cpp:121 (需要实例化)
如果如下写:
test = JPackage("com").Main()
out = test.sayBye("yoyo")
print("sayBye-->",out)
# 错误信息:
RuntimeError: No matching overloads found for sayBye in find. at native\common\jp_method.cpp:127
上面 java代码中 sayBye() 是一个静态函数,因此不需要实例化就可以使用,正确方法:
test2 = JPackage("com").Main
out = test2.sayBye("wtf")
print("sayBye2-->",out)
# 输出:
sayBye2--> Bye wtf
访问JAVA的系统属性
假设你要设置的属性名为 yourProperty,属性值为 yourValue 。
1)JVM启动时设置系统变量示例
import jpype
jvmPath = jpype.getDefaultJVMPath()
jvmArg = "-DyourProperty=yourValue "
if not jpype.isJVMStarted():
jpype.startJVM(jvmPath,jvmArg)
2)在程序中设置系统变量示例
import jpype
prop = "yourProperty"
value = "yourValue"
system = jpype.JClass("java.lang.System")
system.setProperty(str(prop),str(value))
3)在程序中获取系统变量示例
import jpype
prop = "yourProperty"
system = jpype.JClass("java.lang.System")
value = system.getProperty(str(prop))