二、JavaScript Native Interface
JavaScript本地接口JSNI。
1）声明一个本地方法
在JSNI中声明一个本地方法时，使用Java的标准native关键字，就像在JNI（Java Native Interface）中一样。在JNI中，本地C代码是一个单独的文件，独立编译且在运行时动态加载。
在JSNI中，本地JavaScript代码用一种特殊的注释格式直接嵌入到Java源代码中。
JSNIProject/src/com/xyz/client/Alert.java
--------------------------------------
public class Alert{
public static native void alert(String msg) /*-{
$wnd.alert(msg);
}-*/;
}
--------------------------------------
JSNI注释块以“/*-{”开头，以“}-*/”结束。
这个例子显示，当用JSNI访问浏览器窗口和文档对象时，必须分别用$wnd和$doc引用它们。在嵌套的框架中运行已编译的脚本时，$wnd和$doc会自动的初始化，用主机页窗口和文档来代替框架。
2）它的工作机制
在WEB模式中，GWT编译器把客户端一半的Java程序转换成JavaScript。
正常情况，当编译器看到方法声明时，其括号内部的代码必须经历解释过程。如果方法是本地方法，编译器处理更为简单。它直接复制JavaScript本地代码到已编译的结果中。
一旦JavaScript被解释后，JavaScript代码中的任何错误就只能在运行时才能发现。
3）从Java中调用JSNI
在Java中调用JSNI与调用其它Java方法没有什么不同。
JSNIProject/src/com/xyz/client/LSNIExample.java
--------------------------------------
button1.addClickListener(new ClickListener(){
public void onClick(Widget sender){
Alert.alert("Clicked!");
}
});
--------------------------------------
4）从JSNI中调用Java
假定你传递一个对象到JSNI方法，你需要访问一个字段或在对象中调用一个方法。你还需知道GWT编译器怎样弄糟Java域和方法名，因此你可以在JavaScript代码中访问它们。
（1）访问Java域（field）
访问Java域的语法如下：
--------------------------------------
obj.@class::field
--------------------------------------
obj 是引用对象的实例
class 是具有full-qualified的类
field 访问域的域名
（2）调用Java方法
调用Java方法的语法和访问Java域的语法相似，语法如下：
--------------------------------------
obj.@class::method(sig)(args)
--------------------------------------
method 调用方法的方法名
sig 内部的Java方法签名
args 方法传递的参数列表
（3）方法签名（Method Signature）
JSNI方法签名确切地说和JNI方法签名一样，除了方法返回类型有所不同。
下面的表显示了这些方法签名
--------------------------------------
Type Signature Java Type
--------------------------------------
Z boolean
B byte
C char
S short
I int
J long
F float
D double
[type type()
Lfully-qualified-class; fully-qualified-class
--------------------------------------
例如：Java方法：
long f(int n, String s, int[] arr);
有如下的类型签名：
ILjava/lang/String;[I)
（4）例子
下面的代码显示了通过JSNI访问Java域和方法的例子。它说明了传递数字、字符串、布尔型和Java对象到JavaScript。它还显示了JavaScript方法怎样调用传递过来的Java对象。
--------------------------------------
Java类型 它是怎样出现在JavaScript代码中的
a Java numeric primitive var x=42;
String var s="my string";
boolean var b=true;
JavaScriptObject 从JavaScript代码中初始化，典型的是作为其它JSNI方法的返回值
Java Object 通过特殊语法得到的不透明的值
--------------------------------------
JSNIProject/src/com/xyz/client/j2js.java
----------------------------------------------------------
public class J2JS{
/** Pass a Java numeric primitive */
public static void testJ2JSNumeric(){
int x=42;
jsNumeric(x);
}
privae static native void jsNumeric(int x)/*-{
$wnd.alert("x is "+x);
}-*/;
/** Pass a Java String */
public static void testJ2JSString(){
String s="my string";
jsString(s);
}
private static native void jsString(String s) /*-{
$wnd.alert("s is "+s);
}-*/;
/** Pass a boolean */
public static void testJ2JSBoolean(){
boolean b=true;
jsBoolean(b);
}
private static native void jsBoolean(boolean b) /*-{
$wnd.alert("b is "+b);
}-*/;
/** Pass an arbitrary Java Object */
public static void testJ2JSObject(){
MyJavaObject obj=new MyJavaObject();
jsObject(obj);
}
private static native void jsObject(MyJavaObject obj) /*-{
$wnd.alert("Calling getText():"+obj.@MyJavaObject::getTextAt(I)(3));
}-*/;
}
----------------------------------------------------------
如果你看GWT的源码时，可以看到许多安装JSNI定义的东东。大多数GWT编程者不需要定义JSNI方法，但还是该留意它，或许用得上