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方法，但还是该留意它，或许用得上。