用Delphi开发JNI(Java Native Interface)应用(二)

要正确地访问类对象的成员属性（字段）及成员方法，最重要的一点是一定要给出正确的签名，在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代码的方法，有兴趣的读者不妨自己研究一下。