JSNI

一、History and Bookmarks
书签对于Ajax应用来说是一个特殊的问题，因为用户只和单个的页面进行交互，因此这儿存在许多不同的片段、状态。GWT解决了这些问题。
处理返回按钮和用户保存有用的标签的秘密是历史标识。
历史标识仅仅是一个字符串，用于保存你想保存的状态。Google没有记载历史标识的最大长度，但是推荐为在100个字符以内。
要通过编程来改变历史标识，可以调用方法：History.newItem()，History.back()，History.forward()。
如果一个用户用web anchor把一个URL作为书签，当重载那些页面时，GWT将把anchor作为一个历史标识。它会传递标识到listener，不用知道它是怎样处理的。如果你想改变状态，可使用Hyperlink类来代替。
在内部，历史是通过一个特殊的标签<iframe>来管理的。GWT脚手架脚本自动地为你加入：
HistoryProject/src/com/xyz/public/HistoryExample.html
--------------------------------------
<!-- OPTIONAL: include this if you want history support -->
<iframe id="__gwt_historyFrame" style="width:0;height:0;border:0">
</iframe>
--------------------------------------
浏览器的“返回”和“向前”按钮简单地保存你访问过的一堆URL。通过在应用程序中进行设置，GWT使它和历史标识保持一致。
下面的例子显示了怎样处理初始化标识，建立事件监听，处理事件。
HistoryProject/src/com/xyz/client/HistoryExample.java(来源 www.iocblog.net)
--------------------------------------
public class HistoryExample implements EntryPoint, HistoryListener{
private Label lbl=new Label();
public void onModuleLoad(){
//Create three hyperlinks that change the application's history.
Hyperlink link0=new Hyperlink("link to foo","foo");
Hyperlink link1=new Hyperlink("link to bar","bar");
Hyperlink link2=new Hyperlink("link to baz","baz");
//If the application starts with no history token, start it
// off in the 'baz' state.
String initToken=History.getToken();
if(initToken.length()==0)
initToken="baz";
//onHistoryChanged() is not called when the application first
//runs. Call it now in order to reflect the initial state.
onHistoryChanged(initToken);
//Add widgets to the root panel.
Panel panel=new VerticalPanel();
panel.add(lbl);
panel.add(link0);
panel.add(link1);
panel.add(link2);
RootPanel.get().add(panel);
//Add history listener
History.addHistoryListener(this);
}
public void onHistoryChanged(String historyToken){
lbl.setText("The current history token is: "+historyToken);
}
}
--------------------------------------
二、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方法，但还是该留意它，或许用得上。