Struts提供了非常多的標(biāo)簽，依據(jù)功能和使用習(xí)慣的不同被分到了五個(gè)標(biāo)簽庫(kù)中:

• Bean Tags:該標(biāo)簽庫(kù)包含的標(biāo)簽可以用來(lái)創(chuàng)建bean、訪問(wèn)bean和訪問(wèn)bean的屬性。同時(shí)提供了依據(jù)cookies、headers和parameters的值創(chuàng)建相關(guān)bean的能力。
• HTML Tags:該標(biāo)簽庫(kù)包含的標(biāo)簽可以用來(lái)創(chuàng)建Struts輸入表單。
• Logic Tags:該標(biāo)簽庫(kù)包含的標(biāo)簽可以用來(lái)進(jìn)行邏輯判斷、集合迭代和流程控制。
• Nested Tags:該標(biāo)簽庫(kù)建立在前三個(gè)標(biāo)簽庫(kù)的基礎(chǔ)上，具有前三個(gè)標(biāo)簽庫(kù)的所有功能，只是允許標(biāo)簽間的嵌套。
• Tiles Tags:該標(biāo)簽庫(kù)包含的標(biāo)簽可以用來(lái)創(chuàng)建tiles樣式的頁(yè)面。

這篇指南主要介紹前三個(gè)標(biāo)簽庫(kù)中的標(biāo)簽。如果您對(duì)后兩類標(biāo)簽也感興趣可以查閱參考資料中的Struts的用戶指南。

bean:cookie

cookie最早是由Netscape公司提出來(lái)的，用來(lái)存儲(chǔ)客戶的少量狀態(tài)信息。如果您對(duì)cookie的具體細(xì)節(jié)感興趣可以查閱參考資料中的cookie spec。

bean:cookie標(biāo)簽取回請(qǐng)求中名稱為name的cookie的值。如果沒(méi)有指定multiple屬性則依據(jù)剛?cè)』氐闹祫?chuàng)建一個(gè)Cookie類型的bean。如果指定了multiple屬性則依據(jù)剛?cè)』氐闹祫?chuàng)建一個(gè)Cookie[]類型的數(shù)組。然后用id屬性值將Cookie或Cookie[]綁定到page作用域中(這種綁定是為了其它標(biāo)簽?zāi)軌蚴褂迷撝?，并創(chuàng)建對(duì)應(yīng)的scripting變量(這種變量是為了JSP腳本能夠使用該值)。

下面的代碼片段示例了如何使用bean:cookie標(biāo)簽讀取名為JSESSIONID的cookie的值，并且使用了兩種方式進(jìn)行了輸出：

<logic:present cookie="JSESSIONID">
<bean:cookie id="jSession" name="JSESSIONID"/>
<!-- 其它標(biāo)簽通過(guò)綁定到page作用域中的屬性使用該值 -->
這個(gè)cookie的名稱是<bean:write name="jSession" property="name"/>，
值為<bean:write name="jSession" property="value"/>。<br/>
<!-- JSP腳本通過(guò)scripting變量使用該值 -->
<%
String name = jSession.getName();
String value = jSession.getValue();
out.println("這個(gè)cookie的名稱是"+name+"，值為"+value+"。
<br/>");
%>
</logic:present>

bean:define

bean:define標(biāo)簽在toScope(如果沒(méi)有指定值就使用page作用域)指定的作用域中創(chuàng)建一個(gè)新屬性，同時(shí)創(chuàng)建一個(gè)scripting變量。我們可以通過(guò)id值使用它們。新創(chuàng)建的屬性可以由其它標(biāo)簽使用，而新創(chuàng)建的scripting變量可以由JSP腳本使用。

我們可以使用三種方式為新創(chuàng)建的屬性和scripting變量賦值：

• 通過(guò)該標(biāo)簽的name、property和scope取回值，并且保持類型的一致性，除非取回的值為Java的原始類型，這時(shí)會(huì)使用適合的包裝器類對(duì)這些值進(jìn)行包裝。
• 通過(guò)該標(biāo)簽的value指定值，這時(shí)新創(chuàng)建的屬性和scripting變量的類型為java.lang.String。
• 通過(guò)在該標(biāo)簽的體中嵌入值，這時(shí)新創(chuàng)建的屬性和scripting變量的類型為java.lang.String。

下面的代碼片段示例了如何使用bean:define標(biāo)簽創(chuàng)建新屬性values和新scripting變量values，它將listForm中persons的值取出來(lái)賦給values:

<bean:define id="values" name="listForm" property = "persons"
type="java.util.List"/>

下面給出ListForm的代碼片段以幫助您更好的理解，其中Person是一個(gè)只有id和name兩個(gè)屬性的簡(jiǎn)單bean：

public class ListForm extends ActionForm {
private List<Person> persons = null;
public List<Person> getPersons() {
return persons;
}
public void setPersons(List<Person> persons) {
this.persons = persons;
}
public void reset(ActionMapping mapping,
HttpServletRequest request) {
persons = null;
}
}

下面的代碼片段示例了logic:iterate標(biāo)簽如何使用bean:define標(biāo)簽創(chuàng)建的新屬性values:

<logic:iterate id="person" name="values">
<bean:write name="person" property="id"/><br/>
</logic:iterate>

下面的代碼片段示例了JSP腳本如何使用bean:define標(biāo)簽創(chuàng)建的新scripting變量values:

<%
Person p = new Person();
for(int i=0;i<values.size();i++){
p = (Person)values.get(i);
out.println(p.getId());
out.println("<br/>");
}
%>

bean:header

bean:header標(biāo)簽取回請(qǐng)求中名稱為name的header的值。如果沒(méi)有指定multiple屬性則依據(jù)剛?cè)』氐闹祫?chuàng)建一個(gè)String類型的bean。如果指定了multiple屬性則依據(jù)剛?cè)』氐闹祫?chuàng)建一個(gè)String[]類型的數(shù)組。然后用id屬性值將String或String[]綁定到page作用域中(這種綁定是為了其它標(biāo)簽?zāi)軌蚴褂迷撝?，并創(chuàng)建對(duì)應(yīng)的scripting變量(這種變量是為了JSP腳本能夠使用該值)。

下面是我的瀏覽器發(fā)送的header的內(nèi)容，這些內(nèi)容和瀏覽器有關(guān)，因此您的瀏覽器發(fā)送的內(nèi)容可能和下面列出的不同。不過(guò)這沒(méi)有關(guān)系，因?yàn)橐斫鈈ean:header標(biāo)簽?zāi)灰獙?duì)這些內(nèi)容有一個(gè)大概的認(rèn)識(shí)就足夠了。

accept: */*
accept-language: zh-cn
accept-encoding: gzip, deflate
user-agent: Mozilla/4.0 (compatible; MSIE 6.0; //應(yīng)該在同一行
Windows NT 5.1; SV1; .NET CLR 1.1.4322)
host: localhost:8080
connection: Keep-Alive

下面的代碼片段示例了如何使用bean:header標(biāo)簽讀取名為User-Agent的header的值，并且使用了兩種方式進(jìn)行了輸出：

<logic:present header="User-Agent">
<!-- 其它標(biāo)簽通過(guò)綁定到page作用域中的屬性使用該值 -->
您的瀏覽器是<bean:header id="userAgent" name="User-Agent"/>
<bean:write name="userAgent"/>。<br/>
<!-- JSP腳本通過(guò)scripting變量使用該值 -->
<%
out.println("您的瀏覽器是"+userAgent+"。<br/>");
%>
</logic:present>

bean:include

bean:include標(biāo)簽對(duì)指定url(由forward、href或page確定)處的資源做一個(gè)請(qǐng)求，將響應(yīng)數(shù)據(jù)作為一個(gè)String類型的bean綁定到page作用域，同時(shí)創(chuàng)建一個(gè)scripting變量。我們可以通過(guò)id值訪問(wèn)它們。

下面的代碼片段示例了bean:include標(biāo)簽的用法，其中include.txt文件包含要include的內(nèi)容，然后將這些內(nèi)容輸出:

<bean:include id="value" page="/include.txt"/>
<!-- 其它標(biāo)簽通過(guò)綁定到page作用域中的屬性使用該值 -->
<bean:write name="value"/><br/>
<!-- JSP腳本通過(guò)scripting變量使用該值 -->
<%
out.println(value);
%>

bean:message

bean:message標(biāo)簽用來(lái)從指定的locale中取回國(guó)際化的消息并輸出，在這個(gè)過(guò)程中我們還可以傳遞五個(gè)以內(nèi)的參數(shù)。message key可以通過(guò)key直接指定，也可以通過(guò)name和property間接的指定。

bean:message標(biāo)簽有兩種指定message key的方式，一是通過(guò)key屬性直接指定；二是通過(guò)name和property屬性間接的指定，其中message key是在message resources文件中定義的。

我們可以在struts-config.xml文件中使用<message-resources>來(lái)設(shè)置message resources文件。

為了介紹該標(biāo)簽我使用了三個(gè)message resources文件，三個(gè)文件的名字分別為Resources.properties、Resources_en.properties和Resources_zh.properties。在struts-config.xml文件中的設(shè)置(這里不用設(shè)置三個(gè)，struts會(huì)依據(jù)locale自動(dòng)找到對(duì)應(yīng)的文件)如下：

<message-resources parameter="Resources" />

三個(gè)message resources文件中定義的message key為：

<!-- Resources.properties -->
resource=Resources.properties.
from=Resources.properties.
<!-- Resources_en.properties -->
from=Resources_en.properties.
<!-- Resources_zh.properties
因?yàn)槲募木幋a被限制為ISO8859所以要有漢字必須用jdk的native2ascii提前轉(zhuǎn)換
-->
from=Resources_zh.properties.

下面的代碼片段示例了bean:message標(biāo)簽的用法:

<bean:message key="from"/><br/>
<bean:message key="resource"/><br/>
<html:link action="/locale?language=en">English</html:link>
<html:link action="/locale?language=zh">Chinese</html:link>

上面的代碼中含有改變locale的兩個(gè)html:link標(biāo)簽，要使它們工作您的struts-config.xml文件中必須含有下面定義的form和action:

<form-bean name="localeForm"
type="org.apache.struts.action.DynaActionForm">
<form-property name="language" type="java.lang.String" />
<form-property name="country" type="java.lang.String" />
<!--action成功后要跳到那里-->
<form-property name="page"  type="java.lang.String"
initial="/message.jsp"/>
</form-bean>
<action path="/locale" type="org.apache.struts.actions.LocaleAction"
name="localeForm" scope="request">
</action>

在不同的locale下我們得到了如下的兩個(gè)結(jié)果：

在locale為zh時(shí)的結(jié)果：
Resources_zh.properties.
Resources.properties.
在locale為en時(shí)的結(jié)果：
Resources_en.properties.
Resources.properties.

讓我們來(lái)看一下在locale為zh時(shí)如何得到的是上面的結(jié)果。因?yàn)閘ocale為zh所以<bean:message key="from"/><br/>先找Resources_zh.properties這個(gè)文件從中得到form鍵的值。而<bean:message key="resource"/><br/>也會(huì)先找Resources_zh.properties這個(gè)文件但這次沒(méi)有找到resource鍵，這時(shí)Struts會(huì)到Resources.properties這個(gè)文件中找，很幸運(yùn)這里找到了。如果還沒(méi)有找到，或message resource文件不存在就會(huì)拋出異常。當(dāng)locale為en時(shí)類似，您可以自己試試。

bean:page

bean:page標(biāo)簽將頁(yè)上下文中的application、config、request、response 或 session取出，然后用id屬性值將它們綁定到page作用域中(這種綁定是為了其它標(biāo)簽?zāi)軌蚴褂迷撝?，并創(chuàng)建對(duì)應(yīng)的scripting變量(這種變量是為了JSP腳本能夠使用該值)。

下面的代碼片段示例了bean:page標(biāo)簽取出response，然后使用bean:write標(biāo)簽將response的characterEncoding和contentType屬性輸出：

<bean:page id="res" property="response"/>
<!-- 其它標(biāo)簽通過(guò)綁定到page作用域中的屬性使用該值 -->
<bean:write name="res" property="characterEncoding"/><br/>
<bean:write name="res" property="contentType"/><br/>
<!-- JSP腳本通過(guò)scripting變量使用該值 -->
<%
String characterEncoding = res.getCharacterEncoding();
String contentType = res.getContentType();
out.println(characterEncoding+"<br/>");
out.println(contentType+"<br/>");
%>

您可以用和上面類似的代碼訪問(wèn)application、config、request 或 session中的任何一個(gè)對(duì)象。

bean:parameter

bean:parameter標(biāo)簽取回請(qǐng)求中的參數(shù)值。如果沒(méi)有指定multiple屬性則依據(jù)剛?cè)』氐闹祫?chuàng)建一個(gè)String類型的bean。如果指定了multiple屬性則依據(jù)剛?cè)』氐闹祫?chuàng)建一個(gè)String[]類型的數(shù)組。然后用id屬性值將String或String[]綁定到page作用域中(這種綁定是為了其它標(biāo)簽?zāi)軌蚴褂迷撝?，并創(chuàng)建對(duì)應(yīng)的scripting變量(這種變量是為了JSP腳本能夠使用該值)。

下面的兩個(gè)代碼片段使用相同的url傳遞參數(shù)，url的形式為http://127.0.0.1:8080/struts-demo/parameter.jsp?param=1&param=2&param=3。前面的代碼片段中沒(méi)有指定multiple屬性，因此p是String類型而且僅僅讀取了參數(shù)的第一個(gè)值。后面的代碼片段中指定了multiple屬性的值，因此ps是String[]類型的包含所有參數(shù)的值。

<bean:parameter id="p" name="param"/>
<bean:write name="p"/>

<bean:parameter id="ps" multiple="true" name="param"/>
<logic:iterate id="p" name="ps">
<bean:write name="p"/><br/>
</logic:iterate>

bean:resource

bean:resource標(biāo)簽取回指定的web應(yīng)用程序的資源，以InputStream或String的形式保存到page作用域中并且創(chuàng)建scripting變量。采用什么形式取決于標(biāo)簽的input屬性，如果指定input則以InputStream的形式保存，如果沒(méi)有指定input則以String的形式保存。

下面的兩個(gè)代碼片段示例了bean:resource標(biāo)簽，其中resource.txt是要使用的資源文件。前面的代碼片段中沒(méi)有指定input屬性，因此以String的形式處理資源文件，bean:write標(biāo)簽輸出資源文件的內(nèi)容。后面的代碼片段中指定了input屬性的值，因此以InputStream的形式使用資源文件，兩個(gè)bean:write標(biāo)簽分別輸出InputStream對(duì)象的實(shí)例名(如java.io.ByteArrayInputStream@16dadf9)和類名(如class java.io.ByteArrayInputStream)。

<bean:resource id="str" name="/resource.txt"/>
<!-- 其它標(biāo)簽通過(guò)綁定到page作用域中的屬性使用該值 -->
<bean:write name="str"/><br/>
<!-- JSP腳本通過(guò)scripting變量使用該值 -->
<%
out.println(str+"<br/>");
%>

<bean:resource id="is" input="true" name="/resource.txt"/>
<!-- 其它標(biāo)簽通過(guò)綁定到page作用域中的屬性使用該值 -->
<bean:write name="is"/><br/>
<bean:write name="is" property="class"/>
<!-- JSP腳本通過(guò)scripting變量使用該值 -->
<%
out.println(is+"<br/>");
out.println(is.getClass()+"<br/>");
%>

bean:size

bean:size標(biāo)簽創(chuàng)建一個(gè)java.lang.Integer類型的bean，這個(gè)bean的值為該標(biāo)簽指定的Collection或Map中所含元素的個(gè)數(shù)。 這可以和logic:iterate標(biāo)簽配合使用，因?yàn)閘ogic:iterate標(biāo)簽不能得到所疊代的集合的元素的個(gè)數(shù)，這有時(shí)候很不方便。

下面的代碼片段示例了bean:size標(biāo)簽取出persons中還有元素的個(gè)數(shù)，其中l(wèi)istForm和persons的定義參見(jiàn)bean:define標(biāo)簽部分：

<logic:notEmpty name="listForm" property = "persons">
<bean:size id="size" name="listForm" property = "persons"/>
<bean:write name="size"/>
</logic:notEmpty>

bean:struts

bean:struts標(biāo)簽取回Struts的內(nèi)部對(duì)象formBean、forward或mapping的值，然后用id綁定到page作用域中(這種綁定是為了其它標(biāo)簽?zāi)軌蚴褂迷撝?，并創(chuàng)建對(duì)應(yīng)的scripting變量(這種變量是為了JSP腳本能夠使用該值)。

下面的代碼片段示例了bean:struts標(biāo)簽取出listForm對(duì)象，讓我們先來(lái)看一下listForm的定義在讀代碼：

<!-- listForm的定義<form-bean name="listForm"
type="org.solo.struts.form.ListForm" /> -->
<bean:struts id="listFormBean" formBean="listForm"/>
name:<bean:write name="listFormBean" property="name"/><br/>
type:<bean:write name="listFormBean" property="type"/><br/>
dynamic:<bean:write name="listFormBean" property="dynamic"/><br/>

上面代碼運(yùn)行的結(jié)果為：

name:listForm
type:org.solo.struts.form.ListForm
dynamic:false

bean:write

bean:write標(biāo)簽將指定的bean的屬性值寫(xiě)到當(dāng)前的JspWriter中，并且可以對(duì)輸出進(jìn)行格式化。

下面的代碼片段示例了bean:write標(biāo)簽輸出User-Agent：

<logic:present header="User-Agent">
<bean:header id="header" name="User-Agent"/>
<bean:write name="header"/>
</logic:present>

下面的代碼片段示例了bean:write標(biāo)簽格式化輸出當(dāng)前日期，其中now是在DataForm中定義的一個(gè)java.util.Date類型的域(值為new Date())，format.date.standard是在資源文件中的一個(gè)鍵(format.date.standard=yyyy-MM-dd)：

<bean:define id="date" name="dataForm" property="now"/>
<br/><bean:write name="date"/>
<br/><bean:write name="date" format="MM/dd/yyyy"/>
<br/><bean:write name="date" formatKey="format.date.standard"/>

上面代碼運(yùn)行的結(jié)果為：

Sun Jun 04 17:04:05 CST 2006
06/04/2006
2006-06-04

html:base

雖然這里的標(biāo)題是html:base標(biāo)簽，但是這里也是這篇指南要介紹的第一個(gè)Struts html標(biāo)簽。因此我想在這里從整體上簡(jiǎn)單的介紹一下，最后給出一個(gè)對(duì)照表。其中的絕大多數(shù)標(biāo)簽就不一一介紹了，要介紹的也不會(huì)在這里介紹，而是將其獨(dú)立出來(lái)以顯重要性。

從用戶處收集數(shù)據(jù)是動(dòng)態(tài)web應(yīng)用非常重要的一個(gè)方面，因此構(gòu)建輸入表單也就自然而然的成為struts框架的一個(gè)重要內(nèi)容。Struts html標(biāo)簽庫(kù)含有創(chuàng)建Struts輸入表單的標(biāo)簽，和其它標(biāo)簽庫(kù)(bean、logic、nested和tiles)中的標(biāo)簽一起協(xié)作就可以產(chǎn)生基于html的用戶界面。

下面的對(duì)照表會(huì)使您對(duì)Struts html標(biāo)簽庫(kù)有一個(gè)整體的印象：

html:cancel

html:cancel標(biāo)簽生成一個(gè)取消按鈕。當(dāng)點(diǎn)擊該按鈕后action servlet會(huì)繞過(guò)相應(yīng)的form bean的validate()方法，同時(shí)將控制權(quán)交給相應(yīng)的action。在該action中可以使用Action.isCancelled(HttpServletRequest)方法判斷是否被取消了。如果返回true表示這個(gè)action被取消了，否則表示這個(gè)action沒(méi)有被取消。

請(qǐng)注意，如果您修改了html:cancel標(biāo)簽的property屬性值，那么struts提供的cancel探測(cè)機(jī)制就失效了，您自己必須提供類似的機(jī)制。

下面是可取消的action的配置文件，注意<set-property property="cancellable" value="true"/>這一行，如果不添加Struts會(huì)拋出org.apache.struts.action.InvalidCancelException異常。這是我在完成本指南的過(guò)程中發(fā)現(xiàn)的唯一向下不兼容的地方。

<action path="/cancel"
type="org.solo.struts.action.CancelAction" name="cancelForm"
scope="request">
<set-property property="cancellable" value="true"/>
<forward name="success" path="/cancel.jsp" />
</action>

下面是html:cancel標(biāo)簽的代碼：

<html:cancel>取消</html:cancel>

下面是對(duì)應(yīng)的action中的代碼：

if(isCancelled(request)){
//action被取消時(shí)要做的事情寫(xiě)在這里
return mapping.findForward("cancel");
}else{
//action沒(méi)有被取消時(shí)要做的事情寫(xiě)在這里
return mapping.findForward("success");
}

html:select

html:select標(biāo)簽生成一個(gè)select元素。是單選還是多選取決于該標(biāo)簽的multiple屬性。如果指定了multiple="true"則為多選，此時(shí)對(duì)應(yīng)的屬性應(yīng)該是一個(gè)數(shù)組。如果沒(méi)有指定multiple="true"則為單選，此時(shí)對(duì)應(yīng)的屬性應(yīng)該是標(biāo)量。

注意：為了正確的處理沒(méi)有做任何的選擇的情況，在ActionForm中的reset()方法中必須將標(biāo)量屬性設(shè)置為默認(rèn)值而將數(shù)組的長(zhǎng)度置為0。

另外的一個(gè)重要問(wèn)題就是struts如何生成option元素了，這個(gè)任務(wù)struts交給了html:option、html:options和html:optionsCollection三個(gè)標(biāo)簽。

html:option標(biāo)簽

html:option標(biāo)簽生成一個(gè)HTML的option元素。該標(biāo)簽必須嵌在html:select標(biāo)簽中。它的顯示文本來(lái)自其標(biāo)簽體，也可以來(lái)自于資源文件。它的value屬性用來(lái)指定什么值將要被提交。

<html:option value="one">one</html:option>
<html:option value="two">two</html:option>

html:options標(biāo)簽

html:options標(biāo)簽生成多個(gè)HTML的option元素。該標(biāo)簽必須嵌在html:select標(biāo)簽中。而且工作方式有些特殊，它的name與property屬性和其它標(biāo)簽的name與property屬性意義不一致，讓我們具體看一下它的工作方式。

• 指定collection屬性
• 沒(méi)有指定collection屬性

指定collection屬性

讓我通過(guò)示例來(lái)介紹在指定collection屬性時(shí)該標(biāo)簽的工作方式，首先要說(shuō)明selectForm中的persons和listForm中的persons完全一致。請(qǐng)參見(jiàn)bean:define標(biāo)簽。

下面的代碼先利用bean:define標(biāo)簽將selectForm中的persons取到page作用域中，然后html:options標(biāo)簽再依據(jù)collection="personCollection"選中這個(gè)persons并將其中的每一個(gè)對(duì)象(Person類型)生成一個(gè)option元素。該標(biāo)簽的property="id"表示persons中的對(duì)象(Person類型)的id屬性將作為option元素的value值。該標(biāo)簽的labelProperty="name"表示persons中的對(duì)象(Person類型)的name屬性將作為option元素的label值。

當(dāng)這個(gè)select提交時(shí)所選擇的值將被提交到selectForm(name="selectForm")中的person對(duì)象(這是在SelectForm中聲明的一個(gè)Person類型的域?qū)ｉT(mén)用來(lái)接收提交的值)的id屬性中(property="person.id")。

<bean:define id="personCollection" name="selectForm"
property="persons"/>
<html:select name="selectForm" property="person.id" size="1">
<html:options collection="personCollection" property="id"
labelProperty="name"/>
</html:select>

沒(méi)有指定collection屬性

讓我通過(guò)示例來(lái)介紹沒(méi)有指定collection屬性時(shí)該標(biāo)簽的工作方式，先來(lái)看看ids和names的定義：

  private List<String> ids = null;
private List<String> names = null;

上面的代碼來(lái)自SelectForm，其中ids是一個(gè)String的列表，names也是一個(gè)String的列表。我們暫時(shí)假定這兩個(gè)列表含有相同數(shù)目的元素。有了這些讓我們開(kāi)始介紹下面的代碼。html:options標(biāo)簽用ids中的第i個(gè)值作為option元素的value值同時(shí)使用names中相同位置的值(第i個(gè)值)作為option元素的label值。如果ids比names長(zhǎng)那么多出的ids中的值將即作為option的value又作為option的label。如果ids比names短那么多出的names的值會(huì)被丟掉。

當(dāng)這個(gè)select提交時(shí)所選擇的值將被提交到selectForm(name="selectForm")中的person對(duì)象(這是在SelectForm中聲明的一個(gè)Person類型的域?qū)ｉT(mén)用來(lái)接收提交的值)的id屬性中(property="person.id")。

<html:select name="selectForm" property="person.id" size="1">
<html:options property="ids" labelProperty="names"/>
</html:select>

html:optionsCollection標(biāo)簽

html:optionsCollection標(biāo)簽生成多個(gè)HTML的option元素。該標(biāo)簽必須嵌在html:select標(biāo)簽中。它的功能和html:options標(biāo)簽的相同，但是它的name與property屬性和其它標(biāo)簽的name與property屬性意義一致，理解起來(lái)比較自然。

讓我通過(guò)示例來(lái)介紹html:optionsCollection標(biāo)簽的用法。首先依據(jù)name="selectForm"和property="persons"取到selectForm中的persons列表，然后將列表中的對(duì)象(Person類型)的id屬性作為option元素的value值(value="id")，將列表中的對(duì)象(Person類型)的name屬性作為option元素的label值(label="name")。

<html:select name="selectForm" property="person.id" size="1">
<html:optionsCollection name="selectForm" property="persons"
label="name" value="id"/>
</html:select>

下面是一個(gè)多選的示例，雖然示例中使用了html:options標(biāo)簽，但是html:option和html:optionsCollection也能夠用來(lái)多選。而且您還必須意識(shí)到html:option、html:options和html:optionsCollection這三個(gè)標(biāo)簽可以同時(shí)使用。代碼中的personIds是SelectForm中聲明的一個(gè)String[]類型的數(shù)組用來(lái)接收提交的多個(gè)值。

<html:select name="selectForm" property="personIds"
multiple="true" size="2">
<html:options property="ids" labelProperty="names"/>
</html:select>

html:checkbox

html:check標(biāo)簽生成一個(gè)checkbox。這里的value值可以是true，yes或on。如果您要提交其它的值(如某種形式的標(biāo)識(shí))應(yīng)該考慮使用html:multibox標(biāo)簽。

注意:為了正確的處理沒(méi)有選中的checkbox您必須在reset()中設(shè)置對(duì)應(yīng)的屬性為false。

下面的代碼示例了html:checkbox標(biāo)簽的用法，其中CheckboxForm中聲明了三個(gè)boolean類型的域，如下：

				
private boolean one = false;
private boolean two = false;
private boolean three = false;

<html:checkbox name="checkboxForm" property="one">
One
</html:checkbox>
<html:checkbox name="checkboxForm" property="two">
Two
</html:checkbox>
<html:checkbox name="checkboxForm" property="three">
Three
</html:checkbox>

如果選中后被提交則相應(yīng)的屬性的值為true。

html:radio

html:radio標(biāo)簽生成一個(gè)radio。主要的用法有兩種，下面我們通過(guò)代碼來(lái)示例。

下面的代碼示例了html:radio標(biāo)簽的一般用法，如果被提交則選中的radio的value值將被提交到radioForm中的id中。

<html:radio name="radioForm" property="id" value="00001">
One
</html:radio>
<html:radio name="radioForm" property="id" value="00002">
Two
</html:radio>

下面的代碼示例了html:radio標(biāo)簽的典型用法，其中的persons和bean:define標(biāo)簽中的一致，您可以參考bean:define標(biāo)簽。我只介紹這個(gè)<html:radio idName="person" property="id" value="id">，idName指定html:radio要使用的bean(這里為person)，value="id"表示person的id屬性將作為radio元素的value值而property="id"表示提交時(shí)選中的radio的值將被提交給radioForm中的id屬性。

<logic:notEmpty name="radioForm" property="persons">
<logic:iterate id="person" name="radioForm" property="persons">
<html:radio idName="person" property="id" value="id">
<bean:write name="person" property="name"/>
</html:radio>
</logic:iterate>
</logic:notEmpty>

html:multibox

html:multibox標(biāo)簽生成多個(gè)checkbox。當(dāng)您要使用大量的checkbox時(shí)使用這個(gè)標(biāo)簽非常方便，可以使您避免在ActionForm中聲明大量的boolean類型的變量，帶之以一個(gè)數(shù)組就行了。

注意:為了正確的處理沒(méi)有選中的checkbox您必須在reset()中設(shè)置數(shù)組的長(zhǎng)度為0。

下面的代碼示例了html:multibox標(biāo)簽的一般用法，如果被提交則選中的所有checkbox的value值將被提交到multiboxForm中的selectedItems中，這是一個(gè)String[]數(shù)組。

<html:multibox name="multiboxForm" property="selectedItems"
value="00001"/>
<html:multibox name="multiboxForm" property="selectedItems"
value="00002"/>

下面的代碼示例了html:multibox標(biāo)簽的典型用法：

<logic:iterate id="person" name="multiboxForm" property="persons">
<html:multibox property="selectedItems">
<bean:write name="person" property="id"/>
</html:multibox>
<bean:write name="person" property="name"/>
</logic:iterate>

html:link

html:link標(biāo)簽生成一個(gè)錨點(diǎn)(<a>)元素。我從html:link標(biāo)簽如何構(gòu)造基本url和如何構(gòu)造query參數(shù)兩個(gè)方面來(lái)介紹這個(gè)標(biāo)簽。

構(gòu)造基本url是依據(jù)該標(biāo)簽的如下四個(gè)屬性進(jìn)行的，這四個(gè)屬性一次只能出現(xiàn)一個(gè)。讓我們看看它們：

• forward，指定一個(gè)全局ActionForward的名稱。另外如果forward是module相關(guān)的則該forward必須指向一個(gè)action而不能是一個(gè)頁(yè)面。
• action，指定一個(gè)Action的名稱。
• href，struts會(huì)直接使用這個(gè)值而不會(huì)對(duì)其進(jìn)行任何處理。
• page，指定一個(gè)頁(yè)面的路徑，必須以/開(kāi)始。

構(gòu)造query參數(shù)，下面列舉了可能的形式，其中baseurl只是一個(gè)占位符：

• baseurl?p=00001(單參單值)
• baseurl?p1=00001&p2=00002&p3=00003(多參單值)
• baseurl?p=00001&p=00002&p=00003(單參多值)
• baseurl?p1=00001&p2=00002&p=00001&p=00002&p=00003(混合)

下面我們以代碼示例來(lái)說(shuō)明每一種html:link的用法，首先讓我們花點(diǎn)時(shí)間看看相關(guān)action中的代碼：

<!-- 下面所有代碼的數(shù)據(jù)都是在這里構(gòu)造的 -->
public ActionForward execute(ActionMapping mapping,ActionForm form,
HttpServletRequest request,HttpServletResponse response) {
DataForm dataForm = (DataForm) form;
dataForm.setParam("00001");
HashMap paramSingleMap = new HashMap();
paramSingleMap.put("p1","00001");
paramSingleMap.put("p2","00002");
paramSingleMap.put("p3","00003");
dataForm.setParamSingleMap(paramSingleMap);
HashMap paramMultiMap = new HashMap();
paramMultiMap.put("p",new String[]{"00001","00002","00003"});
dataForm.setParamMultiMap(paramMultiMap);
HashMap paramSMMap = new HashMap();
paramSMMap.put("p1","00001");
paramSMMap.put("p2","00002");
paramSMMap.put("p",new String[]{"00001","00002","00003"});
dataForm.setParamSMMap(paramSMMap);
List<Person> persons = new ArrayList<Person>();
Person person1 = new Person();
person1.setId("00001");
person1.setName("趙辰");
Person person2 = new Person();
person2.setId("00002");
person2.setName("李為芳");
Person person3 = new Person();
person3.setId("00003");
person3.setName("王微");
persons.add(person1);
persons.add(person2);
persons.add(person3);
dataForm.setPersons(persons);
return mapping.findForward("success");
}

<!-- 這用來(lái)設(shè)置一個(gè)位置 -->
<html:link linkName="top"/>
<!-- 這用來(lái)定位到上面的那個(gè)位置 -->
<html:link page="/link.do" anchor="top">Go Top</html:link>

<html:link page="/link.do" paramId="p" paramName="dataForm"
paramProperty="param">
單參單值
</html:link><br/>
<html:link page="/link.do" name="dataForm" property="paramSingleMap">
多參單值
</html:link><br/>
<html:link page="/link.do" name="dataForm" property="paramMultiMap">
單參多值
</html:link><br/>
<html:link page="/link.do" name="dataForm" property="paramSMMap">
混合
</html:link>

下面的代碼示例了html:link標(biāo)簽的indexed屬性和indexId屬性的用法，這兩個(gè)屬性只有html:link標(biāo)簽嵌套在logic:iterate標(biāo)簽中時(shí)才可用。

<logic:iterate id="person" name="dataForm" property="persons">
<html:link action="/link.do" paramId="person" paramName="person"
paramProperty="id" indexed="true" indexId="number">
person
</html:link>
<br/>
</logic:iterate>
<!-- 下面是上面代碼的運(yùn)行結(jié)果(產(chǎn)生的html)
<a href="/struts-demo/link.do?person=00001&number=0">趙辰</a><br/>
<a href="/struts-demo/link.do?person=00002&number=1">李為芳</a><br/>
<a href="/struts-demo/link.do?person=00003&number=2">王微</a><br/>
其中的number是由indexId="number"確定的，而該參數(shù)的值為元素在集合中的位置。
-->

html:rewrite標(biāo)簽和html:link標(biāo)簽類似只是不生成錨點(diǎn)(<a>)，而是簡(jiǎn)單的輸出字符串。

html:errors

html:errors標(biāo)簽和html:messages標(biāo)簽的功能相似，所以我們放到一起來(lái)介紹。

html:errors標(biāo)簽將由name屬性指定的ActionMessages、ActionErrors、String和String[]直接輸出到頁(yè)面中。

html:messages標(biāo)簽將用由name屬性(注意message屬性值對(duì)它的影響)指定的ActionMessages、ActionErrors、String和String[]創(chuàng)建一個(gè)新的屬性和scripting變量，使用id屬性值作為名稱。

html:errors標(biāo)簽和html:messages標(biāo)簽的property屬性是用來(lái)為errors和messages分類的。我們可以給這兩個(gè)標(biāo)簽指定property屬性，以便只顯示某一類的錯(cuò)誤或消息。

在資源文件增加了如下的內(nèi)容：

# -- standard errors --
errors.header=<ul>
errors.prefix=<li>
errors.suffix=</li>
errors.footer=</ul>
error=error with none value .
error1=error1 with one value is {0} .
error2=error2 with two values are {0} , {1} .
error3=error3 with three values are {0} , {1} , {2} .
error4=error4 with four values are {0} , {1} , {2} ,{3} .

下面的代碼示例了actionErrors的構(gòu)造：

public ActionErrors validate(ActionMapping mapping,
HttpServletRequest request) {
ActionErrors actionErrors = new ActionErrors();
actionErrors.add("property1",
new ActionMessage("error"));
actionErrors.add("property2",
new ActionMessage("error1","value0"));
actionErrors.add("property2",
new ActionMessage("error2","value0","value1"));
actionErrors.add("property3",
new ActionMessage("error3","value0","value1","value2"));
actionErrors.add("property3",
new ActionMessage("error4","value0","value1","value2","value3"));
actionErrors.add("property4",
new ActionMessage("error1",new Object[]{"value0"}));
actionErrors.add("property4",
new ActionMessage("error2",new Object[]{"value0","value1"}));
actionErrors.add("property4",
new ActionMessage("error3",new Object[]{"value0","value1",
"value2"}));
actionErrors.add("property5",
new ActionMessage("error4",new Object[]{"value0","value1",
"value2","value3"}));
actionErrors.add("notBundle",
new ActionMessage("not a bundle key",false));
return actionErrors;
}

errors標(biāo)簽代碼示例：

<html:errors/>
<br/>
<html:errors property="property4"/>

messages標(biāo)簽代碼示例：

<logic:messagesPresent>
<ul>
<html:messages id="message">
<li><bean:write name="message"/></li>
</html:messages>
</ul>
</logic:messagesPresent>
<br/>
<logic:messagesPresent>
<ul>
<html:messages id="message" property="property4">
<li><bean:write name="message"/></li>
</html:messages>
</ul>
</logic:messagesPresent>

html:javascript

html:javascript標(biāo)簽生成用于校驗(yàn)的javascript腳本代碼。

下面的代碼片段示例了html:javascript標(biāo)簽的基本用法，其中formName屬性的值是在validation.xml文件的<formset>中定義的form的名稱。有一點(diǎn)值得注意的是在確定<formset>時(shí)要使用合適的language屬性值。

<html:javascript formName="dataForm"/>

html:xhtml

html:xhtml標(biāo)簽在頁(yè)面中一出現(xiàn)就是告訴該頁(yè)的所有其它的Struts html標(biāo)簽以XHTML1.0兼容的形式輸出。這和將html:html標(biāo)簽的xhtml屬性值指定為true有些類似。如果上述情況都沒(méi)有出現(xiàn)，Struts html標(biāo)簽將以html4.01兼容的形式輸出。

logic:iterate

logic:iterate標(biāo)簽用來(lái)迭代集合，您可以使用如下方式來(lái)為這個(gè)標(biāo)簽指定其要疊代的集合：

• 使用一個(gè)運(yùn)行時(shí)表達(dá)式，這個(gè)表達(dá)式的值是一個(gè)集合。
• 用name屬性引用一個(gè)JSP Bean，這個(gè)JSP Bean本身就是一個(gè)集合。
• 用name屬性引用一個(gè)JSP Bean，這個(gè)JSP Bean的一個(gè)屬性是一個(gè)集合，這時(shí)可以聯(lián)合使用property來(lái)指定這個(gè)集合。

上面所提到的集合可以是：

• 對(duì)象類型或原子類型的數(shù)組(Array)。
• java.util.Collection的實(shí)現(xiàn)，包括ArrayList，Vector。
• java.util.Enumeration的實(shí)現(xiàn)。
• java.util.Iterator的實(shí)現(xiàn)。
• java.util.Map的實(shí)現(xiàn)，包括HashMap，Hashtable和TreeMap。

如果您疊代的集合中含有null的值，這時(shí)需要采取一定的措施，因?yàn)檫@時(shí)logic:iterate不會(huì)在page作用域中創(chuàng)建對(duì)象。一般是使用<logic:present>標(biāo)簽或<logic:notPresent>標(biāo)簽來(lái)判斷一下。

下面是logic:iterate疊代ArrayList的示例的對(duì)象引用關(guān)系和部分代碼：

圖中的persons列表是在ListAction中填充的，在這里只是簡(jiǎn)單的加入了三個(gè)Person對(duì)象，在實(shí)際的應(yīng)用中這些數(shù)據(jù)應(yīng)該取自數(shù)據(jù)庫(kù)。具體的代碼如下：

public ActionForward execute(ActionMapping mapping,ActionForm form,
HttpServletRequest request,	HttpServletResponse response) {
ListForm listForm = (ListForm) form;
List<Person> persons = new ArrayList<Person>();
Person person1 = new Person();
person1.setId("00001");
person1.setName("趙辰");
Person person2 = new Person();
person2.setId("00002");
person2.setName("李為芳");
Person person3 = new Person();
person3.setId("00003");
person3.setName("王微");
persons.add(person1);
persons.add(person2);
persons.add(person3);
listForm.setPersons(persons);
return mapping.findForward("success");
}

標(biāo)簽輸出的結(jié)果為：

00001-->趙辰
00002-->李為芳
00003-->王微

logic:present

如果指定的值出現(xiàn)該標(biāo)簽就會(huì)創(chuàng)建其標(biāo)簽體內(nèi)的內(nèi)容。該標(biāo)簽用于以下情況：

• 檢查具有指定名稱的cookie是否出現(xiàn)。
• 檢查具有指定名稱的header是否出現(xiàn)。
• 檢查具有指定名稱的JSP Bean是否出現(xiàn) 或 檢查具有指定名稱的JSP Bean中的property屬性是否出現(xiàn)。
• 檢查request中指定名稱的參數(shù)是否出現(xiàn)。
• 檢查當(dāng)前的認(rèn)證用戶是否與指定的安全角色相關(guān)聯(lián)。
• 檢查當(dāng)前認(rèn)證的主體是否具有指定的名字。

下面的代碼示例了logic:present標(biāo)簽檢查具有指定名稱User-Agent的header是否出現(xiàn)：

<logic:present header="User-Agent">
您的瀏覽器是<bean:header id="userAgent" name="User-Agent"/>
<bean:write name="userAgent"/>。<br/>
</logic:present>

logic:notPresent標(biāo)簽的應(yīng)用正好和logic:present標(biāo)簽相反。

logic:messagesPresent

logic:messagesPresent標(biāo)簽用于以下情況：

• 在request作用域中存在一個(gè)ActionMessages對(duì)象，標(biāo)簽的property屬性和ActionMessages中的property對(duì)應(yīng)。
• 在request作用域中存在一個(gè)ActionErrors對(duì)象，標(biāo)簽的property屬性和ActionErrors中的property對(duì)應(yīng)。
• 存在一個(gè)String對(duì)象，將其轉(zhuǎn)換(構(gòu)造)成ActionMessage然后在添加到ActionMessages中。
• 存在一個(gè)String Array對(duì)象，將數(shù)組中的每一個(gè)String轉(zhuǎn)換成一個(gè)ActionMessage，在將其添加到ActionMessages中。

標(biāo)簽的message屬性值為true時(shí)將以Globals.MESSAGE_KEY為key在request作用域中查找Message，其它情況下，將name的值作為key查找，如果name 沒(méi)有出現(xiàn)，默認(rèn)值為Globals.ERROR_KEY。

下面的代碼示例了logic:messagesPresent標(biāo)簽的典型用法：

<logic:messagesPresent>
<ul>
<html:messages id="message">
<li><bean:write name="message"/></li>
</html:messages>
</ul>
</logic:messagesPresent>

標(biāo)簽logic:messagesNotPresent的應(yīng)用正好和logic:messagesPresent的應(yīng)用相反。

logic:empty

logic:empty標(biāo)簽是用來(lái)判斷是否為空的。如果為空，該標(biāo)簽體中嵌入的內(nèi)容就會(huì)被處理。該標(biāo)簽用于以下情況：

• 當(dāng)Java對(duì)象為null時(shí)
• 當(dāng)String對(duì)象為""時(shí)
• 當(dāng)java.util.Collection對(duì)象中的isEmpty()返回true時(shí)
• 當(dāng)java.util.Map對(duì)象中的isEmpty()返回true時(shí)

下面的代碼示例了logic:empty標(biāo)簽判斷集合persons是否為空：

<logic:empty name="listForm" property = "persons">
<div>集合persons為空!</div>
</logic:empty>

logic:notEmpty標(biāo)簽的應(yīng)用正好和logic:empty標(biāo)簽相反。

logic:match

logic:match標(biāo)簽用來(lái)處理子串匹配問(wèn)題。

如果指定的值匹配該標(biāo)簽就會(huì)創(chuàng)建其標(biāo)簽體內(nèi)的內(nèi)容。該標(biāo)簽用于以下情況：

• 檢查具有指定名稱的cookie是否與該標(biāo)簽的value匹配。
• 檢查具有指定名稱的header是否與該標(biāo)簽的value匹配。
• 檢查具有指定名稱的JSP Bean是否與該標(biāo)簽的value匹配 或 檢查具有指定名稱的JSP Bean中的property屬性值是否與該標(biāo)簽的value匹配。
• 檢查request中指定名稱的參數(shù)值是否與該標(biāo)簽的value匹配。

下面的代碼示例了logic:match標(biāo)簽的典型用法：

<logic:present header="User-Agent">
<logic:match header="User-Agent" value="MSIE 6.0">
MS IE 6.0
</logic:match>
</logic:present>

logic:notMatch標(biāo)簽的應(yīng)用正好和logic:match標(biāo)簽相反。

logic:equal

這里要介紹的不只是logic:equal(=)標(biāo)簽，而是要介紹一類標(biāo)簽，這類標(biāo)簽完成比較運(yùn)算，包括：

• logic:equal(=)
• logic:notEqual(!=)
• logic:greaterEqual(>=)
• logic:lessEqual(<=)
• logic:graterThan(>)
• logic:lessThan(<)

該類標(biāo)簽的用法類似，我們只介紹logic:equal標(biāo)簽，其它的留給您自己去完成。

logic:equal是用來(lái)判斷是否相等的。如果相等，該標(biāo)簽體中嵌入的內(nèi)容就會(huì)被處理。該標(biāo)簽用于以下情況：

• 比較由該標(biāo)簽的cookie屬性指定的cookie的值是否與該標(biāo)簽的value屬性值相等。
• 比較由該標(biāo)簽的header屬性指定的header的值是否與該標(biāo)簽的value屬性值相等。
• 比較由該標(biāo)簽的name屬性指定的JSP Bean是否與該標(biāo)簽的value屬性值相等(property屬性不出現(xiàn))或比較由該標(biāo)簽的name屬性指定的JSP Bean中的property屬性值是否與該標(biāo)簽的value屬性值相等。
• 比較由該標(biāo)簽的parameter屬性指定的參數(shù)值(request中)是否與該標(biāo)簽的value屬性值相等。

logic:forward

我覺(jué)得將forward和redirect這兩個(gè)動(dòng)作放到一起對(duì)比著介紹更加有利于理解，基于此原因也就將logic:forward和logic:redirect這兩個(gè)標(biāo)簽也拿到這里一起介紹了。

讓我們看看這兩個(gè)動(dòng)作的區(qū)別：

• forward是在servlet內(nèi)部執(zhí)行，瀏覽器完全不會(huì)感知到這個(gè)動(dòng)作，原始的url也不會(huì)改變，瀏覽器重新裝載的話也只是對(duì)原始的請(qǐng)求進(jìn)行簡(jiǎn)單的重復(fù)。
• redirect則分成兩個(gè)步驟：第一步是web應(yīng)用程序告訴瀏覽器第二個(gè)url，然后瀏覽器向第二個(gè)url發(fā)送請(qǐng)求。

redirect比f(wàn)orward慢，因?yàn)闉g覽器要做二次請(qǐng)求。還有就是要注意，在第一次的請(qǐng)求作用域(request作用域)內(nèi)的bean對(duì)于第二次請(qǐng)求是不可見(jiàn)的。

理解了上面描述的區(qū)別也就知道了什么時(shí)候該選用logic:forward標(biāo)簽什么時(shí)候該選用logic:redirect標(biāo)簽了。logic:forward標(biāo)簽完成PageContext.forward()或HttpServletResponse.sendRedirect()，如何選擇由控制器決定。logic:redirect標(biāo)簽完成HttpServletResponse.sendRedirect()。

在使用logic:redirect標(biāo)簽時(shí)我們可以向使用html:link一樣構(gòu)造baseurl和query參數(shù)。如果您感興趣可以參考html:link標(biāo)簽。

總結(jié)

這篇指南的背景是Struts-1.2.9，其中的所有的代碼示例也都是在這個(gè)版本下調(diào)試通過(guò)的。目前Struts仍然在快速的發(fā)展中，但是從開(kāi)發(fā)者應(yīng)用的角度來(lái)講還是比較穩(wěn)定的。因此我有理由相信其中的代碼示例也可以很好的運(yùn)行在其它的版本之上。最后希望這篇指南能夠讓您心情愉快！