14.3 Ajax JSP tags
14.3.1概述
為了使開發(fā)Ajax變得輕松愜意,Struts2提供了一些JSP Tags,通過這些自定義的標簽庫,使得開發(fā)人員無需掌握額外的知識即可開發(fā)Ajax的應用。
從Struts2.1開始,不再推薦使用Dojo的Plugin,而是改用Ajax的tags,包括:
- head:用來下載Dojo文件和相應的Javascript代碼
- div:用來動態(tài)的加載并展示html內容
- a:展示為Html的超鏈接形式,點擊后觸發(fā)一個Ajax的請求
- submit:展示為Html的按鈕形式,點擊后可觸發(fā)異步提交
- bind:用來關聯(lián)事件和對應的事件處理程序
- datetimepicker:日歷組件
- autocompleter:能實現(xiàn)自動完成的功能,類似于搜索框的自動完成功能
- textarea:一個復雜的文本編輯器組件
- tabbedpanel:一個顯示多頁面tab面板的組件
- tree:一個在頁面上展示為樹的組件
- treenode:用來展示為樹中節(jié)點的組件
要使用Struts2.1的Ajax Tags,需要做以下的工作:
1:把Dojo插件,也就是struts2-dojo-plugin-2.1.8.1.jar文件,復制到WEB-INF/lib文件夾下
2:在頁面上增加taglib的引用,<%@ taglib prefix="sx" uri="/struts-dojo-tags" %>
3:在每個頁面的頂部包含head標簽
好了,基本的知識就了解到這里,接下來看看具體如何使用Struts2的Ajax tags。
14.3.2 head標簽
1:功能
head標簽的地位比較特殊,它的功能是用來下載Dojo文件和相應的Javascript代碼,因此所有其他使用Dojo標簽的頁面都應該包含這個標簽。
2:屬性
head標簽的屬性有:


建議大家在開發(fā)期間,把compressed設置為false,debug設置為true,這樣方便大家調試程序;但是在交付給客戶的時候,應該把compressed設置為true,debug設置為false,這樣可以加快程序的運行。
3:使用示例
在開發(fā)期間使用head標簽,大致應為:
java代碼:
- <%@ taglib prefix="sx" uri="/struts-dojo-tags" %>
- <head>
- <sx:head debug="true" extraLocales="en-us,nl-nl,de-de"/>
- </head>
在運行期間使用head標簽,大致應為:
java代碼:
- <%@ taglib prefix="sx" uri="/struts-dojo-tags" %>
- <head>
- <sx:head/>
- </head>
14.3.3 div標簽
1:功能
div標簽展示為html中的Div元素,但是div標簽能夠異步的、動態(tài)的加載需要展示的內容,而且div標簽還提供一個內部的計時器,可以循環(huán)的在設定的時間點去重新加載需要展示的內容。
2:屬性
div標簽的屬性很多,這里羅列一些常用的:

 
 
3:使用示例
div標簽的使用是非常簡單的,來通過一個示例進行說明,實現(xiàn)的功能非常簡單,就是通過div來異步顯示Action返回的信息。
(1)先看看action的實現(xiàn),只是簡單的返回了一個信息,非常簡單,示例代碼如下:
java代碼:
- public class AjaxServerAction extends ActionSupport {
- private InputStream inputStream;
- public InputStream getInputStream() {
- return inputStream;
- }
-
- public String execute() throws Exception {
- Thread.sleep(3000L);
- inputStream = new ByteArrayInputStream("這是一個div的測試".getBytes("utf-8"));
- return this.SUCCESS;
- }
- }
(2)相應的struts.xml配置如下:
java代碼:
- <action name="ajaxServerAction" class="cn.javass.ajax.AjaxServerAction">
- <result type="stream">
- <param name="contentType">text/html</param>
- <param name="inputName">inputStream</param>
- </result>
- </action>
(3)然后來看看頁面的實現(xiàn),主要就是div標簽的基本使用了,示例代碼如下:
java代碼:
- <%@ page contentType="text/html; charset=gb2312"%>
- <head><meta http-equiv="Content-Type" content="text/html;charset=gb2312"></head>
- <%@ taglib prefix="sx" uri="/struts-dojo-tags" %>
- <head>
- <sx:head/>
- </head>
- <sx:div
- href="ajaxServerAction.action"
- showLoadingText="true"
- loadingText="正在加載內容,請稍候"
- errorText="對不起,加載資源失敗,請重試"
- >
- </sx:div>
(4)去運行測試一下看看,剛開始運行應該如下圖所示:

圖14.3 Div標簽示例開始頁面
然后在3秒后,Action運行完成并返回內容,此時應該如下圖所示:

圖14.4 Div標簽示例結果頁面
14.3.4 a標簽和submit標簽
1:功能
a標簽和submit標簽的功能是類似的,都能夠發(fā)起一個Ajax請求,只不過a標簽展示為html中的a元素,而submit標簽展示成為按鈕的形式。
兩個元素都有一個target的屬性,用來指定顯示Ajax響應后的信息的元素,通常是一個div元素。
2:屬性
a標簽和submit標簽的屬性也很類似,兩個標簽都有的常用屬性有:

 
 
當然也有一些不同的元素,除了上面這些共同的元素,a標簽自有的元素有:

submit標簽自有的元素有:
3:使用示例
(1)對Action稍作修改,讓它接收頁面?zhèn)鬟f的參數(shù),示例代碼如下:
java代碼:
- public class AjaxServerAction extends ActionSupport {
- public String account;
- public String name;
-
- private InputStream inputStream;
- public InputStream getInputStream() {
- return inputStream;
- }
-
- public String execute() throws Exception {
- System.out.println("接收的參數(shù),帳戶="+account+",姓名="+name);
- if(account!=null && account.indexOf("test")>=0){
- inputStream = new ByteArrayInputStream("這是一個A標簽的測試".getBytes("utf-8"));
- }else{
- inputStream = new ByteArrayInputStream("這是一個Submit的測試".getBytes("utf-8"));
- }
- return this.SUCCESS;
- }
- }
(2)struts.xml的配置沒有改變,就不去贅述了
(3)頁面也需要發(fā)生一些改變,要做一個提交的頁面,同時會使用a標簽或submit標簽,示例代碼如下:
java代碼:
- <%@ page contentType="text/html; charset=gb2312"%>
- <head><meta http-equiv="Content-Type" content="text/html;charset=gb2312"></head>
- <%@ taglib prefix="sx" uri="/struts-dojo-tags" %>
- <%@taglib prefix="s" uri="/struts-tags" %>
- <head>
- <sx:head/>
- </head>
- <s:div id="showMsg">
- </s:div>
-
- <s:form action="ajaxServerAction" method="post">
- <s:textfield name="account" label="賬號"></s:textfield>
- <s:textfield name="name" label="姓名"></s:textfield>
- <sx:submit targets="showMsg"></sx:submit>
- </s:form>
-
- <sx:a targets="showMsg" href="ajaxServerAction.action?account=test&name=testname">a標簽的測試</sx:a>
(4)運行測試一下,結果如下:

圖14.5 a標簽示例頁面

圖14.6 submit標簽示例頁面
14.3.5 bind標簽
1:功能
bind標簽主要用來把一個事件和事件處理程序關聯(lián)起來,當然它也可以把一個對象的事件和一個topic聯(lián)系起來。
2:屬性
bind標簽的屬性很多,這里羅列一些常用的:

 
3:使用示例
Bind標簽的使用是非常簡單的,來通過一個示例進行說明,實現(xiàn)的功能非常簡單,就是為一個按鈕綁定上一個onclick的事件。
(1)Action和struts.xml就沿用上面示例的Action和struts.xml,這里就不去贅述了。只是把返回的數(shù)據修改成了:
java代碼:
- inputStream = new ByteArrayInputStream("這是一個Bind的測試".getBytes("utf-8"));
(2)然后來看看頁面的實現(xiàn),主要就是bind標簽的基本使用了,示例代碼如下:
java代碼:
- <%@ page contentType="text/html; charset=gb2312"%>
- <head><meta http-equiv="Content-Type" content="text/html;charset=gb2312"></head>
- <%@ taglib prefix="sx" uri="/struts-dojo-tags" %>
- <%@taglib prefix="s" uri="/struts-tags" %>
- <head>
- <sx:head/>
- </head>
- <s:div id="showMsg">
- </s:div>
-
- <input type="button" id="myButton" value="保存">
- <sx:bind
- id="myBind"
- href="ajaxServerAction.action"
- sources="myButton"
- events="onclick"
- targets="showMsg"
- >
- </sx:bind>
(4)去運行測試一下看看,運行應該如下圖所示:

圖14.7 bind標簽示例頁面
14.3.6datetimepicker標簽
1:功能
datetimepicker標簽主要用來實現(xiàn)一個日期控件,可以表現(xiàn)為一個日歷表或者是一個ie時間表。
2:屬性
datetimepicker標簽的屬性很多,這里羅列一些常用的:

 
設置日期格式時,各個字母代表的含義如下:

3:使用示例
看看使用datetimepicker標簽來顯示日期的樣子,示例代碼如下:
java代碼:
- <%@ page contentType="text/html; charset=gb2312"%>
- <head><meta http-equiv="Content-Type" content="text/html;charset=gb2312"></head>
- <%@ taglib prefix="sx" uri="/struts-dojo-tags" %>
- <%@taglib prefix="s" uri="/struts-tags" %>
- <head>
- <sx:head/>
- </head>
-
- <sx:datetimepicker
- adjustWeeks="true"
- displayFormat="yyyy-MM-dd"
- toggleType="explode"
- >
- </sx:datetimepicker>
運行效果如下圖所示:

圖14.8 datetimepicker標簽示例頁面
14.3.7 autocompleter標簽
1:功能
autocompleter標簽實現(xiàn)的是具有自動完成功能的組合框,輸入一定的數(shù)據后,會出現(xiàn)一個下拉塊,里面羅列著一些與輸入相關的關鍵詞,你可以通過選擇一個來自動完成輸入。當然也可以直接點擊下拉列表來選擇一個值。
2:屬性
autocompleter標簽的屬性很多,這里羅列一些常用的:

 
 
3:返回一個List的使用示例
autocompleter標簽的使用并不復雜,只是它需要嵌套在一個標簽內使用;另外標簽使用的選項可以是一個集合,也可以是JSON對象,分別來通過示例進行說明,實現(xiàn)的功能非常簡單,就是通過autocompleter標簽來異步顯示可自動完成的信息。
先看看從Action返回一個List給autocompleter標簽的情況。
(1)先看看action的實現(xiàn),在execute方法里面為list填充初始值,示例代碼如下:
java代碼:
- public class AutocompleteAction extends ActionSupport{
- public List<String> users = new ArrayList<String>();
-
-
-
- public String submitFlag = "";
-
-
-
- public String testKey = "";
-
- public String execute(){
- if("show".equals(submitFlag)){
- users.add("張三");
- users.add("張三豐");
- users.add("李四");
- users.add("李四郎");
- }else{
- System.out.println("你選中的是==="+testKey);
- }
- return this.SUCCESS;
- }
- }
注意其中的testKey屬性,它用來接收被選中項的值,它對應著頁面autocompleter標簽中的name屬性,它是自動在name屬性后
面添加Key而得到。也就是說,現(xiàn)在獲取值的屬性是testKey,那么頁面autocompleter標簽中的name屬性的值就應該是test。當
然,也可以通過在autocompleter標簽中的keyName屬性來指定這個值。
(2)相應的struts.xml配置如下:
java代碼:
- <action name="autoAction" class="cn.javass.ajax.AutocompleteAction">
- <result name="success">/ajax/tags.jsp</result>
- </action>
(3)然后來看看頁面的實現(xiàn),主要就是autocompleter標簽的基本使用了,要注意放到表單里面,示例代碼如下:
java代碼:
- <%@ page contentType="text/html; charset=gb2312"%>
- <head><meta http-equiv="Content-Type" content="text/html;charset=gb2312"></head>
- <%@ taglib prefix="sx" uri="/struts-dojo-tags" %>
- <%@taglib prefix="s" uri="/struts-tags" %>
- <head>
- <sx:head/>
- </head>
-
- <s:form action="autoAction" method="post">
- <input type="hidden" name="submitFlag" value="request"/>
- <sx:autocompleter name="test" list="users" autoComplete="true"></sx:autocompleter>
- <s:submit></s:submit>
- </s:form>
(4)運行的url是:http://localhost:9080/helloworld/autoAction.action?submitFlag=show,去運行測試一下看看,剛開始運行應該如下圖所示:

圖14.9 autocompleter標簽示例開始頁面
點擊下拉圖標,如下圖所示:

圖14.10 autocompleter標簽示例點擊下拉圖標的頁面
如果在輸入框中輸入,比如輸入張三,然后刪掉三字,可以看到自動提示的信息如下圖,你完全可以通過選擇一個來實現(xiàn)自動輸入:

圖14.11 autocompleter標簽示例自動完成頁面
4:返回JSON的使用示例
autocompleter標簽使用返回的JSON也不復雜,只是返回值要符合一定的格式而已。autocompleter標簽所接受的json格式大致有:
(1)如果返回的是數(shù)組,那么一定要是個2維的數(shù)組,格式大致如下:
java代碼:
- [
- ['第一個元素的key','第一個元素的value'],
- ['第二個元素的key','第二個元素的value']
- ......
- ]
其中元素的key值就是在下拉列表里面顯示的值,而value就是選中后提交到后臺的值。
(2)如果你在autocompleter標簽中設置了“dataFieldName”這個屬性,假定設定的值為“dataFieldName=test”,那么返回的2維數(shù)組的格式大致如下:
java代碼:
- {
- "test":[
- ['第一個元素的key','第一個元素的value'],
- ['第二個元素的key','第二個元素的value']
- ......
- ]
- }
或者如下格式:
java代碼:
- {
- "test":{
- '第一個元素的key' : '第一個元素的value',
- '第二個元素的key' : '第二個元素的value'
- ......
- }
- }
(3)如果你在autocompleter標簽中設置了“name”這個屬性,假定設定的值為“name=test”,那么返回的格式大致如下:
java代碼:
- {
- "tests" : [
- ['第一個元素的key','第一個元素的value'],
- ['第二個元素的key','第二個元素的value']
- ......
- ]
- }
(4)如果返回是一個map,那么返回的格式大致如下:
java代碼:
- {
- '第一個元素的key' : '第一個元素的value',
- '第二個元素的key' : '第二個元素的value'
- ......
- }
接下來就簡單看看從Action返回一個JSON字符串給autocompleter標簽的實現(xiàn)。
(1)先看看action的實現(xiàn),在execute方法里面為list填充初始值,然后拼接成為一個符合格式要求的字符串,并把這個字符串放置到request的屬性里面,示例代碼如下:
java代碼:
- public class AutocompleteAction extends ActionSupport{
- public List<String> users = new ArrayList<String>();
-
-
-
- public String submitFlag = "";
-
-
-
- public String testKey = "";
-
- public String execute(){
- if("show".equals(submitFlag)){
- users.add("張三");
- users.add("張三豐");
- users.add("李四");
- users.add("李四郎");
-
- StringBuffer buffer = new StringBuffer();
- buffer.append("[");
- for(int i=0;i<users.size();i++){
- buffer.append("['"+users.get(i)+"','"+users.get(i)+"']");
- if(i!=users.size()-1){
- buffer.append(",");
- }
- }
- buffer.append("]");
- ServletActionContext.getRequest().setAttribute("jsonStr",buffer.toString());
- return "toJson";
- }else{
- System.out.println("你選中的是==="+testKey);
- }
- return this.SUCCESS;
- }
- }
(2)相應的struts.xml配置如下:
java代碼:
- <action name="autoAction" class="cn.javass.ajax.AutocompleteAction">
- <result name="success">/ajax/tags.jsp</result>
- <result name="toJson">/ajax/toJson.jsp</result>
- </action>
(3)接下來看看返回JSON字符串的頁面,示例代碼如下:
java代碼:
- <%@ page contentType="text/html; charset=gb2312"%>
- <%=request.getAttribute("jsonStr")%>
(4)然后來看看頁面的實現(xiàn),主要就是autocompleter標簽的基本使用了,要注意放到表單里面,示例代碼如下:
java代碼:
- <%@ page contentType="text/html; charset=gb2312"%>
- <head><meta http-equiv="Content-Type" content="text/html;charset=gb2312"></head>
- <%@ taglib prefix="sx" uri="/struts-dojo-tags" %>
- <%@taglib prefix="s" uri="/struts-tags" %>
- <head>
- <sx:head/>
- </head>
-
- <s:form action="autoAction" method="post">
- <input type="hidden" name="submitFlag" value="request"/>
- <sx:autocompleter name="test" href="/helloworld/autoAction.action?submitFlag=show"></sx:autocompleter>
- <s:submit></s:submit>
- </s:form>
注意里面配置了href,它就指向自動填充所需要的值的來源。
(5)運行的url是:http://localhost:9080/helloworld/ajax/tags.jsp,去運行測試一下看看,效果跟前面直接返回List的效果應該是一樣的。
14.3.8textarea標簽
1:功能
textarea標簽用來實現(xiàn)復雜的文本編輯框,類似于大家在郵件系統(tǒng)或是博客系統(tǒng)里面看到的,可以在線編輯的文本框,可以設置一些基本的格式。
2:屬性
textarea標簽的常用屬性有:

3:使用示例
(1)textarea標簽的使用很簡單,直接在頁面上使用就可以了,示例代碼如下:
java代碼:
- <%@ page contentType="text/html; charset=gb2312"%>
- <head><meta http-equiv="Content-Type" content="text/html;charset=gb2312"></head>
- <%@ taglib prefix="sx" uri="/struts-dojo-tags" %>
- <%@taglib prefix="s" uri="/struts-tags" %>
- <head>
- <sx:head/>
- </head>
-
- <s:form action="autoAction" method="post">
- <sx:textarea name="test" rows="10" cols="50"></sx:textarea>
- <s:submit></s:submit>
- </s:form>
如果后臺想要接收到textarea的值,只需要設置一個屬性跟textarea標簽的name值一樣就可以了。
(4)運行測試一下,結果如下:

圖14.12 textarea標簽示例頁面
這里要注意一個問題,部分IE可能對textarea標簽支持得不是很好,剛顯示出來的時候全部并在一起,點擊輸入框的時候就展開了,在Firefox上就一切正常。
14.3.9tabbedpanel標簽
1:功能
tabbedpanel標簽用來實現(xiàn)多頁簽的面板,也被稱為tab面板,而且單個面板可以單獨關閉,就類似于Eclipse打開開發(fā)的源文件一樣。
2:屬性
tabbedpanel標簽的常用屬性有:

 
 
3:使用示例
(1)對Action稍作修改,只是把返回的數(shù)據修改成了:
java代碼:
- inputStream = new ByteArrayInputStream("這是一個Tab的測試".getBytes("utf-8"));
java代碼:
- (2)struts.xml的配置沒有改變,就不去贅述了
- (3)頁面也需要發(fā)生一些改變,主要是使用tabbedpanel標簽,示例代碼如下:
java代碼:
- <%@ page contentType="text/html; charset=gb2312"%>
- <head><meta http-equiv="Content-Type" content="text/html;charset=gb2312"></head>
- <%@ taglib prefix="sx" uri="/struts-dojo-tags" %>
- <%@taglib prefix="s" uri="/struts-tags" %>
- <head>
- <sx:head/>
- </head>
-
- <sx:tabbedpanel id="test" >
- <sx:div id="one" label="第一個面板">
- <s:form>
- <s:textfield name="userId" label="用戶編號"/>
- <s:textfield name="name" label="用戶名稱"/>
- </s:form>
- </sx:div>
- <sx:div id="two" label="第二個面板" href="ajaxServerAction.action" >
- </sx:div>
- </sx:tabbedpanel>
(4)運行測試一下,結果如下:

圖14.13 tabbedpanel標簽示例頁面一
點擊第二個面板,結果如下:

圖14.14 tabbedpanel標簽示例頁面二
14.3.10tree和treenode標簽
1:功能
tree標簽用來實現(xiàn)在頁面展示一個樹形結構,它可以包含一個或多個treenode標簽。tree標簽實現(xiàn)的是一個基于dojo的樹。treenode標簽里面還可以包含一個到多個treenode標簽,形成父子節(jié)點。
2:屬性
tree標簽的常用屬性有:

 

3:靜態(tài)樹示例
為了讓大家更好的掌握樹的使用,先來個簡單的,就是直接在頁面上寫死的數(shù)據,也就是制造一顆靜態(tài)樹。
(1)直接在頁面上使用tree標簽和treenode標簽,示例代碼如下:
java代碼:
- <%@ page contentType="text/html; charset=gb2312"%>
- <head><meta http-equiv="Content-Type" content="text/html;charset=gb2312"></head>
- <%@ taglib prefix="sx" uri="/struts-dojo-tags" %>
- <%@taglib prefix="s" uri="/struts-tags" %>
- <head>
- <sx:head/>
- </head>
-
- <sx:tree id="depRoot" label="部門">
- <sx:treenode id="dev" label="開發(fā)部">
- <sx:treenode id="dev1" label="開發(fā)一部"></sx:treenode>
- <sx:treenode id="dev2" label="開發(fā)二部"></sx:treenode>
- </sx:treenode>
- <sx:treenode id="test" label="測試部"></sx:treenode>
- <sx:treenode id="market" label="市場部"></sx:treenode>
- </sx:tree>
(2)運行測試一下,結果如下:

圖14.15 tree標簽示例頁面
4:動態(tài)樹使用示例
接下來把構建樹的數(shù)據后移,放到Action中去構建。為了與tree標簽里面的屬性進行匹配,需要在后臺構建一個節(jié)點模型,是JavaBean格式的,這個JavaBean里面的屬性,在頁面上使用tree標簽的時候進行使用。
(1)先就來看看這個節(jié)點的模型對象,示例代碼如下:
java代碼:
- public class Node {
-
-
-
- private String id;
-
-
-
- private String name;
-
-
-
- private List<Node> children = new ArrayList<Node>();
-
- public String getId() {
- return id;
- }
- public void setId(String id) {
- this.id = id;
- }
- public List<Node> getChildren() {
- return children;
- }
- public void setChildren(List<Node> children) {
- this.children = children;
- }
- public String getName() {
- return name;
- }
- public void setName(String name) {
- this.name = name;
- }
- }
(2)在Action里面來組裝樹,示例代碼如下:
java代碼:
- public class TreeAction extends ActionSupport {
-
-
-
- public Node depRoot = new Node();
- public String execute(){
-
- depRoot.setId("theRoot");
- depRoot.setName("部門");
-
- Node dev = new Node();
- dev.setId("dev");
- dev.setName("開發(fā)部");
-
- Node dev1 = new Node();
- dev1.setId("dev1");
- dev1.setName("開發(fā)一部");
-
- Node dev2 = new Node();
- dev2.setId("dev2");
- dev2.setName("開發(fā)二部");
-
- dev.getChildren().add(dev1);
- dev.getChildren().add(dev2);
-
- Node test = new Node();
- test.setId("test");
- test.setName("測試部");
-
- Node market = new Node();
- market.setId("market");
- market.setName("市場部");
-
- depRoot.getChildren().add(dev);
- depRoot.getChildren().add(test);
- depRoot.getChildren().add(market);
-
- return this.SUCCESS;
- }
- }
(3)對應的struts.xml的配置,示例代碼如下:
java代碼:
- <action name="treeAction" class="cn.javass.ajax.TreeAction">
- <result name="success">/ajax/tags.jsp</result>
- </action>
(4)頁面也需要發(fā)生一些改變,主要是使用tree標簽,示例代碼如下:
java代碼:
- <%@ page contentType="text/html; charset=gb2312"%>
- <head><meta http-equiv="Content-Type" content="text/html;charset=gb2312"></head>
- <%@ taglib prefix="sx" uri="/struts-dojo-tags" %>
- <%@taglib prefix="s" uri="/struts-tags" %>
- <head>
- <sx:head/>
- </head>
- <sx:tree rootNode="depRoot"
- nodeTitleProperty="name"
- nodeIdProperty="id"
- childCollectionProperty="children"
- >
- </sx:tree>
上面配置的各個屬性,同后臺的Node對象和Action對象都有關系,具體的參見相應的注釋,這里就不去贅述了。
(5)運行的url是:http://localhost:9080/helloworld/treeAction.action,去運行測試一下看看,效果和剛才靜態(tài)樹的效果應該是一樣的。
|