要正确地访问类对象的成员属性(字段)及成员方法,最重要的一点是一定要给出正确的签名,在Java中对于数据类型和方法的签名有如下的约定:
数据类型/方法 |
签名 |
byte |
B |
char |
C |
double |
D |
float |
F |
int |
I |
long |
J (注意:是J不是L) |
short |
S |
void |
V |
boolean |
Z(注意:是Z不是B) |
类类型 |
L跟完整类名,如Ljava/lang/String; (注意:以L开头,要包括包名,以斜杠分隔,最后有一个分号作为类型表达式的结束) |
数组type[] |
[type,例如 float[]的签名就是[float,如果是二维数组,如float[][],则签名为[[float,(注意:这里是两个 [ 符号)。 |
方法 |
(参数类型签名)返回值类型签名,例如方法: float fun(int a,int b),它的签名为(II)F,(注意:两个I之间没有逗号!),而对于方法String toString(),则是()Ljava/lang/String;。 |
通过上面的例子,我们了解了访问对象参数的成员属性或方法的基本步骤和多个Get方法的使用。TJNIEnv同时提供了多个Set方法,可以修改传入的对象参数的字段值,因为Java对象参数都是以传址的方式进行传递的,所以修改的结果可以在Java程序中得到反映。TJNIEnv提供的Get/Set方法,都需要两个基本参数:对象实例(JObject类型)和字段ID(JField类型),就可以根据提供的对象和字段ID来获取或设置这个对象的这个字段的值。
现在我们了解了在Delphi代码中使用以及修改Java对象的操作步骤。进一步,如果需要在Delphi中从无到有地创建一个新的Java对象,可以吗?再来看一个例子,在Delphi中创建Java类的实例,操作方法其实也非常简单。
先在Java代码中增加一个本地方法,如下:
public native Book findBook(String t); |
然后,修改Delphi代码,增加一个函数(因为有返回值,所以不再是过程而是函数了):
function Java_HelloWorld_findBook(PEnv: PJNIEnv; Obj: JObject; t:JString):JObject; stdcall; var JVM: TJNIEnv; c: JClass; fid:JFieldID; b:JObject; mid:JMethodID; begin JVM := TJNIEnv.Create(PEnv);
c:=JVM.FindClass('Book'); mid:=JVM.GetMethodID(c,'<init>','()V'); b:=JVM.NewObjectV(c,mid,nil); fid:=JVM.GetFieldID(c,'title','Ljava/lang/String;'); JVM.SetObjectField(b,fid,t); fid:=JVM.GetFieldID(c,'price','D'); JVM.SetDoubleField(b,fid,99.8); Result:=b;
JVM.Free; end; |
这里先用FindClass方法根据类名查找到类,然后获取构造函数的方法ID,构造函数名称固定为“<init>”,注意签名为“()V”说明使用了Book类的一个空的构造函数。然后就是使用方法NewObjectV根据类和构造函数的方法ID来创建类的实例。创建了类实例,再对它进行操作就与前面的例子没有什么两样了。对于非空的构造函数,则略为复杂一点。需要设置它的参数表。还是上面的例子,在Book类中增加一个非空构造函数:
public Book(Strint t,double p){ this.title=t; this.price=p; } |
在Delphi代码中,findBook函数修改获取方法ID的代码如下:
mid:=JVM.GetMethodID(c,'<init>','(Ljava/lang/String;D)V'); |
构造函数名称仍是“<init>”,方法签名表示它有两个参数,分别是String和double。然后就是参数的传入了,在Delphi调用Java对象的方法如果需要传入参数,都需要构造出一个参数数组。在变量声明中加上:
args : array[0..1] of JValue; |
注意!参数都是JValue类型,不管它是基本数据类型还是对象,都作为JValue的数组来处理。在代码实现中为参数设置值,并将数组的地址作为参数传给NewObjectA方法:
args[0].l:=t; // t是传入的JString参数 args[1].d:=9.8;
b:=JVM.NewObjectA(c,mid,@args); |
为JValue类型的数据设置值的语句有点特殊,是吧?我们打开jni.pas,查看一下JValue的定义,原来它是一个packed record,已经包括了多种数据类型,JValue的定义如下:
JValue = packed record case Integer of 0: (z: JBoolean); 1: (b: JByte ); 2: (c: JChar ); 3: (s: JShort ); 4: (i: JInt ); 5: (j: JLong ); 6: (f: JFloat ); 7: (d: JDouble ); 8: (l: JObject ); end; |
下面再来看一下错误处理,在调试前面的例子中,大家也许看到了一旦在Delphi的执行过程中发生了错误,控制台就会输出一大堆错误信息,如果想要屏蔽这些信息,也就是说希望在Delphi中捕获错误并直接处理它,应该怎么做?也很简单,在TJNIEnv中提供了两个方法可以方便地处理在访问Java对象时发生的错误。
var … … ae:JThrowable; begin … … ae:=JVM.ExceptionOccurred; if ( ae<>nil ) then begin Writeln(Format('Exception handled in Main.cpp: %d', [longword(ae)])); JVM.ExceptionDescribe; JVM.ExceptionClear; end; … … |
用方法ExceptionOccurred可以捕获Java抛出的错误,并存入JThrowable类型的变量中。用ExceptionDescribe可以显示出Java的错误信息,而ExceptionClear显然就是清除错误,让它不再被抛出。
至此,我们已经把从Java代码通过JNI技术访问Delphi本地代码的步骤做了初步的探讨。在jni.pas中也提供了从Delphi中打开Java虚拟机执行Java代码的方法,有兴趣的读者不妨自己研究一下。