在當今——Web 2.0概念鋪天蓋地的Internet環(huán)境下，簡(jiǎn)易的AJAX集成對于一個(gè)成功的WEB框架來(lái)說(shuō)是不可或缺的。因此，Struts 2其中的一個(gè)重要的功能（Feature）就是“First-class AJAX support - Add interactivity and flexibility with AJAX tags that look and feel just like standard Struts tags（大意：一流的AJAX支持——通過(guò)AJAX標志增加互動(dòng)性和靈活性，而且使用這些AJAX標志與普通的Struts標志同樣簡(jiǎn)單）”。
實(shí)現原理
基于不重新發(fā)明輪子的原則，Struts 2并沒(méi)有開(kāi)發(fā)新的AJAX框架，而是使用時(shí)下Java EE平臺中比較流行的AJAX框架——Dojo和DWR。
最近在Musachy Barroso等同志的無(wú)私奉獻下，開(kāi)發(fā)了Struts 2的JSON插件（Plugin），極大地方便了我們輸出JSON結果（Result）。
JSON插件（Plugin）
在Struts 2的showcase中的AJAX部分，JSON的結果輸出是通過(guò)Freemaker模板實(shí)現。這種方法在簡(jiǎn)易性和靈活性上都比不上JSON插件，所以JSON插件值得向大家五星推薦。
下面讓我們看一個(gè)JSON插件的例子。
首先到以下網(wǎng)址http://code.google.com/p/jsonplugin/downloads/list下載JSON插件的JAR包，并將其加入你的WebContent\WEB-INF\lib下。
接下是本例子的Action代碼：
package tutorial;
import java.util.ArrayList;
import java.util.List;
import com.googlecode.jsonplugin.annotations.JSON;
import com.opensymphony.xwork2.ActionSupport;
public class JsonPluginAction extends ActionSupport {
private static final long serialVersionUID = -6784977600668791997L;
private int bookId;
private String title;
private double price;
private List<String> comments;
private transient String secret1;
private String secret2;
@JSON(name="ISBN")
public int getBookId() {
return bookId;
}
public void setBookId(int bookId) {
this.bookId = bookId;
}
public List<String> getComments() {
return comments;
}
public void setComments(List<String> comments) {
this.comments = comments;
}
public double getPrice() {
return price;
}
public void setPrice(double price) {
this.price = price;
}
public String getTitle() {
return title;
}
public void setTitle(String title) {
this.title = title;
}
@Override
public String execute() {
bookId = 15645912;
title = "Max On Java";
price = 0.9999d;
comments = new ArrayList<String>(3);
comments.add("It‘s no bad!");
comments.add("WOW!");
comments.add("No comment!");
secret1 = "You can‘t see me!";
secret2 = "I am invisible!";
return SUCCESS;
}
} 清單1 src/tutorial/JsonPluginAction.java以上代碼值得注意的是，通過(guò)@JSON的JAVA注釋?zhuān)ˋnnotation），我們可以改變JSON結果的屬性名稱(chēng)，另外帶有transient修飾符與沒(méi)有Getter方法的字段（field）都不會(huì )被串行化為JSON。
然后，我們來(lái)配置一下此Action，代碼如下：
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
<package name="Struts2_AJAX_DEMO" extends="json-default">
<action name="JsonPlugin" class="tutorial.JsonPluginAction">
<result type="json" />
</action>
</package>
</struts>
清單2 src/struts.xml上面配置文件的“package”元素和以往不同的是，它擴展了“json-default”而不是“struts-default”。“json-default”是在jsonplugin-0.11.jar包里的struts-plugin.xml中定義的。該文件同時(shí)定義了“json”的結果類(lèi)型，有興趣的朋友可以打開(kāi)此文件看看。
發(fā)布運行應用程序，在瀏覽器中鍵入：http://localhost:8080/Struts2_Ajax/JsonPlugin.action，出現下載文件對話(huà)框，原因是JSON插件將HTTP響應（Response）的MIME類(lèi)型設為“application/json”。把文件下載下來(lái)，用記事本打開(kāi)，內容如下：
{"ISBN":15645912,"comments":["It‘s no bad!","WOW!","No comment!"],"price":0.9999,"title":"Max On Java"}
清單3 例子1輸出的JSON串當然這還不是一個(gè)完整的AJAX的例子，下面讓我們寫(xiě)一個(gè)HTML文件將其完成，HTML代碼如下：
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>JSON Plugin</title>
<script type="text/javascript">
var bXmlHttpSupport = (typeof XMLHttpRequest != "undefined" || window.ActiveXObject);
if (typeof XMLHttpRequest == "undefined" && window.ActiveXObject) {
function XMLHttpRequest() {
var arrSignatures = ["MSXML2.XMLHTTP.5.0", "MSXML2.XMLHTTP.4.0",
"MSXML2.XMLHTTP.3.0", "MSXML2.XMLHTTP",
"Microsoft.XMLHTTP"];
for (var i=0; i < arrSignatures.length; i++) {
try {
var oRequest = new ActiveXObject(arrSignatures[i]);
return oRequest;
} catch (oError) { /*ignore*/ }
}
throw new Error("MSXML is not installed on your system.");
}
}
function retrieveBook() {
if(bXmlHttpSupport) {
var sUrl = ‘JsonPlugin.action‘;
var oRequest = new XMLHttpRequest();
oRequest.onreadystatechange = function() {
if(oRequest.readyState == 4) {
var oBook = eval(‘(‘ + oRequest.responseText + ‘)‘);
var bookHolder = document.getElementById(‘bookHolder‘);
var sBook = ‘<p><b>ISBN: </b>‘ + oBook.ISBN + ‘</p>‘;
sBook += (‘<p><b>Title: </b>‘ + oBook.title + ‘</p>‘);
sBook += (‘<p><b>Price: </b>$‘ + oBook.price + ‘</p>‘);
sBook += (‘<b><i>Comments: </i></b><hr/>‘);
for(i = 0; i < oBook.comments.length; i++) {
sBook += (‘<p><b>#‘ + (i + 1) + ‘ </b>‘ + oBook.comments[i] + ‘</p>‘);
}
bookHolder.innerHTML = sBook;
}
};
oRequest.open(‘POST‘, sUrl);
oRequest.send(null);
}
}
</script>
</head>
<body>
<input type="button" value="Retrieve Book" onclick="retrieveBook()" />
<div id="bookHolder"></div>
</body>
</html>
清單4 WebContent/JsonPlugin.html以上代碼中，我沒(méi)有使用任何的AJAX的Javascript包，而是參考《Professional Javascript For Web Developer》手工創(chuàng )建XHR（XMLHttpRequest），并在XHR完成后使用eval()方法將JSON字符串變?yōu)镴SON對象。需要注意的是，要調用eval函數時(shí)，必須使用“(”和“)”將JSON字符串括起來(lái)，否則會(huì )出錯的。
打開(kāi)http://localhost:8080/Struts2_Ajax/JsonPlugin.html，點(diǎn)擊“Retrieve Book”按鈕，頁(yè)面如下圖所示：
圖1 JsonPlugin.html頁(yè)面輸出Struts 2與Dojo
Dojo是開(kāi)源Javascript工具包，它引了Widget的概念，方便了Javascript面向對象編程（OOP），改進(jìn)Javascript的事件模型。在此我不打算對此進(jìn)行深入的講解，有興趣的朋友的可以找網(wǎng)上找一些關(guān)于Dojo的資料學(xué)習。
Struts 2基于Dojo編寫(xiě)一些AJAX標志（在Dojo中稱(chēng)為Widget），要使用這些標志的AJAX功能，需要將標志的“theme”屬性設為“ajax”。同時(shí)，亦需要將加入在<head>與</head>之間加入<s:head theme="ajax" />。當使用這些標志的AJAX功能，有些屬性可能會(huì )經(jīng)常用到，所以我會(huì )對這些屬性稍作解釋。
| 名稱(chēng) | 描述 |
| href | XHR（XMLHttpRequest）請求的地址 |
| listenTopics | 監聽(tīng)的Dojo話(huà)題（Topic）以觸發(fā)自身，如可以在可以通過(guò)發(fā)布（Publish）相應的話(huà)題，通知<s:autocompleter />重新加載其備選項（Options） |
| notifyTopics | 完成遠程調用后，發(fā)出通知，觸發(fā)相應的Javascript函數或Dojo Widget |
| formId | 需要提交到服務(wù)器的表單的ID |
| formFilter | 過(guò)濾表單字段的Javascript函數名稱(chēng) |
| indicator | 在XHR處理過(guò)程中，包含用戶(hù)提示的信息的HTML元素的ID，如圖片或DIV等 |
表1 常用的AJAX標志屬性這些標志包括：<s:a />、<s: submit />、<s:autocompleter />和<s:tree />等，下面我將分別講解。
1、<s:a />和<s:submit />
這兩個(gè)標志方便了我們的調用XHR實(shí)現AJAX，所以上面的HTML如果使用了這兩標志將會(huì )變得更簡(jiǎn)單，因為我們不用再去理會(huì )繁鎖的XHR創(chuàng )建和設定的工作。下面是示例代碼：
<%@ page language="java" contentType="text/html; charset=utf-8"
pageEncoding="utf-8"%>
<%@ taglib prefix="s" uri="/struts-tags"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>JSON Plugin</title>
<s:head theme="ajax" />
<script type="text/javascript">
dojo.addOnLoad(function() {
dojo.event.topic.subscribe(‘retrieveBook‘, this, function(data, type, e){
if(type == ‘load‘) {
showBook(data);
} else if(type == ‘error‘) {
alert(‘Can not retrieve the book‘);
}
});
});
function showBook(strBook) {
var oBook = eval(‘(‘ + strBook + ‘)‘);
var bookHolder = document.getElementById(‘bookHolder‘);
var sBook = ‘<p><b>ISBN: </b>‘ + oBook.ISBN + ‘</p>‘;
sBook += (‘<p><b>Title: </b>‘ + oBook.title + ‘</p>‘);
sBook += (‘<p><b>Price: </b>$‘ + oBook.price + ‘</p>‘);
sBook += (‘<b><i>Comments: </i></b><hr/>‘);
for(i = 0; i < oBook.comments.length; i++) {
sBook += (‘<p><b>#‘ + (i + 1) + ‘ </b>‘ + oBook.comments[i] + ‘</p>‘);
}
bookHolder.innerHTML = sBook;
}
</script>
</head>
<body>
<s:url id="bookUrl" value="/JsonPlugin.action" />
<s:submit href="%{bookUrl}" theme="ajax" indicator="indicator"
value="Retrieve Book" align="left" notifyTopics="retrieveBook" />
<s:a theme="ajax" href="%{bookUrl}" indicator="indicator"
notifyTopics="retrieveBook">Retrieve Book</s:a>
<img id="indicator"
src="${pageContext.request.contextPath}/images/indicator.gif"
alt="Loading" style="display:none" />
<div id="bookHolder"></div>
</body>
</html> 清單5 WebContent/LinkButton.jsp可能上述代碼還不夠簡(jiǎn)潔，因為我將HTML格式化的工作都放在Javascript中完成。但如果你的XHR返回的是HTML片段，你可以簡(jiǎn)單地將<s:a />或<s:submit />的“targets”屬性設為“bookHolder”即可，詳情大家可以參考Struts 2 Showcase。至于返回HTML片段，可以通過(guò)Action + Freemaker完成。
2、<s:autocompleter />
Autocomplete是比較經(jīng)典的AJAX應用，雖然谷歌已經(jīng)停止使用這一功能，但就Autocompleter自身而言的確是很酷的。下面是一個(gè)<s:autocompleter />的例子。
首先，我要偽造一些字符串數據，代碼如下：
package tutorial;
import java.util.ArrayList;
import java.util.List;
public final class Datas {
public static final List<String> NAMES;
static {
NAMES = new ArrayList<String>();
NAMES.add("Alabama");
NAMES.add("Alaska");
NAMES.add("American Samoa");
NAMES.add("Arizona");
NAMES.add("Arkansas");
NAMES.add("Armed Forces Europe");
NAMES.add("Armed Forces Pacific");
NAMES.add("Armed Forces the Americas");
NAMES.add("California");
NAMES.add("Colorado");
NAMES.add("Connecticut");
NAMES.add("Delaware");
NAMES.add("District of Columbia");
NAMES.add("Federated States of Micronesia");
NAMES.add("Florida");
NAMES.add("Georgia");
NAMES.add("Guam");
NAMES.add("Hawaii");
NAMES.add("Idaho");
NAMES.add("Illinois");
NAMES.add("Indiana");
NAMES.add("Iowa");
NAMES.add("Kansas");
NAMES.add("Kentucky");
NAMES.add("Louisiana");
NAMES.add("Maine");
NAMES.add("Marshall Islands");
NAMES.add("Maryland");
NAMES.add("Massachusetts");
NAMES.add("Michigan");
NAMES.add("Minnesota");
NAMES.add("Mississippi");
NAMES.add("Missouri");
NAMES.add("Montana");
NAMES.add("Nebraska");
NAMES.add("Nevada");
NAMES.add("New Hampshire");
NAMES.add("New Jersey");
NAMES.add("New Mexico");
NAMES.add("New York");
NAMES.add("North Carolina");
NAMES.add("North Dakota");
NAMES.add("Northern Mariana Islands");
NAMES.add("Ohio");
NAMES.add("Oklahoma");
NAMES.add("Oregon");
NAMES.add("Pennsylvania");
NAMES.add("Puerto Rico");
NAMES.add("Rhode Island");
NAMES.add("South Carolina");
NAMES.add("South Dakota");
NAMES.add("Tennessee");
NAMES.add("Texas");
NAMES.add("Utah");
NAMES.add("Vermont");
NAMES.add("Virgin Islands, U.S.");
NAMES.add("Virginia");
NAMES.add("Washington");
NAMES.add("West Virginia");
NAMES.add("Wisconsin");
NAMES.add("Wyoming");
}
} 清單6 src/tutorial/Datas.java然后是用于獲取和過(guò)濾數據的Action，代碼如下：
package tutorial;
import java.util.ArrayList;
import java.util.List;
import com.opensymphony.xwork2.ActionSupport;
public class AutocompleterAction extends ActionSupport {
private static final long serialVersionUID = -8201401726773589361L;
private List<String[]> names;
private String start;
public void setStart(String start) {
this.start = start;
}
public List<String[]> getNames() {
return names;
}
@Override
public String execute() {
names = new ArrayList<String[]>();
if(start == null || "".equals(start.trim())) {
start = "a";
}
for(String s : Datas.NAMES) {
if(s.toLowerCase().startsWith(start.toLowerCase())) {
names.add(new String[]{ s, s });
}
}
return SUCCESS;
}
} 清單7 src/tutorial/AutocmpleterAction.java上述Action會(huì )以JSON的形式返回以start開(kāi)頭的Datas.NAMES的中字符串，以下是此Action的配置：
<action name="Autocompleter" class="tutorial.AutocompleterAction">
<result type="json">
<param name="root">names</param>
</result>
</action>
清單8 Autocompleter Action的配置代碼片段在JSON類(lèi)型結果的參數中加入“root”參數可以設定輸出JSON結果的根，以上述情況為例，如果沒(méi)有“root”參數，輸出將為“{ "names": [ ["xxx", "xxx"]...] }”，加了之后變就會(huì )成“[ ["xxx", "xxx"]...] ”。接下來(lái)，讓我們看看頁(yè)面的代碼：
<%@ page language="java" contentType="text/html; charset=utf-8"
pageEncoding="utf-8"%>
<%@ taglib prefix="s" uri="/struts-tags"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Struts 2 AJAX - Autocompleter</title>
<s:head theme="ajax" />
</head>
<body>
<h2>
Autocompleter
</h2>
<s:form action="autocompleterForm">
<s:textfield label="abc" name="abc" />
<tr>
<td class="tdLabel">
<label class="label">
No AJAX Autocompleter:
</label>
</td>
<td>
<s:autocompleter theme="simple" name="user"
list="@tutorial.Datas@NAMES" />
</td>
</tr>
<tr>
<td class="tdLabel">
<label class="label">
AJAX Autocompleter:
</label>
</td>
<td>
<s:url id="dataUrl" value="/Autocompleter.action" />
<s:autocompleter theme="ajax" name="start" href="%{dataUrl}"
loadOnTextChange="true" loadMinimumCount="1" indicator="indicator"
autoComplete="false" showDownArrow="false" />
<img id="indicator"
src="${pageContext.request.contextPath}/images/indicator.gif"
alt="Loading" style="display:none" />
</td>
</tr>
</s:form>
</body>
</html> 清單9 WebContent/Autocompleter.jsp上述頁(yè)面包含兩個(gè)<s:autocompleter />標志，前者使用“simple”模板，所以不具有AJAX功能，它的數據將以HTML方式輸出到最終頁(yè)面里；而后者則使用了“ajax”模板，每當輸入框的值發(fā)生改變時(shí)，它都向URL“/Autocompleter.action”發(fā)送請求，Action根據請求中的start參數的值，返回相當的JSON，在請求完成后頁(yè)面通過(guò)回調函數改變輸入框的下拉提示，效果如下圖所示：
圖2 Autocompleter.jsp頁(yè)面輸出3、<s:tree />
樹(shù)是是比較常用的數據結構，因為它可以很好地體現真實(shí)世界中對象之間的關(guān)系。<s:tree />的使用也相對簡(jiǎn)單，但需要說(shuō)明的是——Struts 2.0.6 GA版本的<s:tree />是有BUG的，大家可以點(diǎn)擊這個(gè)鏈接https://issues.apache.org/struts/browse/WW-1813了解詳細的情況。這個(gè)BUG主要是在<s:tree />的通過(guò)“treeCollapsedTopic”、“treeExpandedTopic”和“treeSelectedTopic”設定的話(huà)題（Topic）都沒(méi)有起作用，上述鏈接相應給出了解決方法，但我認為該方法太麻煩（需要自己重新編譯和打包Struts 2），所以下面的例子，我將另辟徯徑，請參考以下代碼。
<%@ page language="java" contentType="text/html; charset=utf-8"
pageEncoding="utf-8"%>
<%@ taglib prefix="s" uri="/struts-tags"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Struts 2 AJAX - Tree</title>
<s:head theme="ajax" debug="true" />
<script type="text/javascript">
function treeNodeSelected(arg) {
alert(arg.source.title + ‘ selected‘);
}
dojo.addOnLoad(function() {
var s = dojo.widget.byId(‘parentId‘).selector;
dojo.event.connect(s, ‘select‘, ‘treeNodeSelected‘);
});
</script>
</head>
<body>
<h2>
Tree
</h2>
<div style="float:left; margin-right: 50px;">
<s:tree label="parent" id="parentId" theme="ajax"
templateCssPath="/struts/tree.css" showRootGrid="true"
showGrid="true">
<s:treenode theme="ajax" label="child1" id="child1Id">
<s:treenode theme="ajax" label="grandchild1" id="grandchild1Id" />
<s:treenode theme="ajax" label="grandchild2" id="grandchild2Id" />
<s:treenode theme="ajax" label="grandchild3" id="grandchild3Id" />
</s:treenode>
<s:treenode theme="ajax" label="child2" id="child2Id" />
<s:treenode theme="ajax" label="child3" id="child3Id" />
<s:treenode theme="ajax" label="child4" id="child4Id" />
<s:treenode theme="ajax" label="child5" id="child5Id">
<s:treenode theme="ajax" label="gChild1" id="gChild1Id" />
<s:treenode theme="ajax" label="gChild2" id="gChild2Id" />
</s:treenode>
</s:tree>
</div>
</body>
</html>
清單10 WebContent/Tree.jsp因為Dojo的樹(shù)控件，即使在沒(méi)有設定“selector”情況下，也會(huì )自動(dòng)生成一個(gè)默認的Selector，所以只要將其事件綁定到特定的事件處理函數即可。
打開(kāi)http://localhost:8080/Struts2_Ajax/Tree.jsp，點(diǎn)擊任一樹(shù)節點(diǎn)，頁(yè)面如下圖所示：
圖3 Tree.jsp頁(yè)面輸出總結
我原本打算用一篇文章寫(xiě)完這個(gè)“Struts 2與AJAX”。不過(guò)在寫(xiě)的過(guò)程中，發(fā)現內容越來(lái)越多。如果勉強寫(xiě)成一篇，朋友們讀起來(lái)也會(huì )很麻煩，所以我決定分開(kāi)幾部分，本文為第一部分。
另外，之前有的朋友建議我建一個(gè)Google的討論組，方便大家討論問(wèn)題。我覺(jué)得這個(gè)提議非常好，一直以來(lái)都是“一人寫(xiě)，大家留言”，這種相對單向的方式不免有所欠缺，而且本人所知也有限，開(kāi)個(gè)討論組大家可以相互討論，共同進(jìn)步。
因為Struts2已經(jīng)被創(chuàng )建，所以申請了“struts2cn”，有興趣的朋友，歡迎加入。
