Struts是Apache Jakarta的一個(gè)著(zhù)名的開(kāi)源項目，目標是為構建基于Java的web應用程序提供一個(gè)框架。
Struts提供了非常多的標簽，依據功能和使用習慣的不同被分到了五個(gè)標簽庫中:
這篇指南主要介紹前三個(gè)標簽庫中的標簽。如果您對后兩類(lèi)標簽也感興趣可以查閱參考資料中的Struts的用戶(hù)指南。
cookie最早是由Netscape公司提出來(lái)的，用來(lái)存儲客戶(hù)的少量狀態(tài)信息。如果您對cookie的具體細節感興趣可以查閱參考資料中的cookie spec。
bean:cookie標簽取回請求中名稱(chēng)為name的cookie的值。如果沒(méi)有指定multiple屬性則依據剛取回的值創(chuàng )建一個(gè)Cookie類(lèi)型的bean。如果指定了multiple屬性則依據剛取回的值創(chuàng )建一個(gè)Cookie[]類(lèi)型的數組。然后用id屬性值將Cookie或Cookie[]綁定到page作用域中(這種綁定是為了其它標簽能夠使用該值)，并創(chuàng )建對應的scripting變量(這種變量是為了JSP腳本能夠使用該值)。
下面的代碼片段示例了如何使用bean:cookie標簽讀取名為JSESSIONID的cookie的值，并且使用了兩種方式進(jìn)行了輸出：
<logic:present cookie="JSESSIONID"><bean:cookie id="jSession" name="JSESSIONID"/><!-- 其它標簽通過(guò)綁定到page作用域中的屬性使用該值 -->這個(gè)cookie的名稱(chēng)是<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的名稱(chēng)是"+name+"，值為"+value+"。<br/>");%></logic:present>bean:define標簽在toScope(如果沒(méi)有指定值就使用page作用域)指定的作用域中創(chuàng )建一個(gè)新屬性，同時(shí)創(chuàng )建一個(gè)scripting變量。我們可以通過(guò)id值使用它們。新創(chuàng )建的屬性可以由其它標簽使用，而新創(chuàng )建的scripting變量可以由JSP腳本使用。
我們可以使用三種方式為新創(chuàng )建的屬性和scripting變量賦值：
下面的代碼片段示例了如何使用bean:define標簽創(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標簽如何使用bean:define標簽創(chuàng )建的新屬性values:
<logic:iterate id="person" name="values"><bean:write name="person" property="id"/><br/></logic:iterate>
下面的代碼片段示例了JSP腳本如何使用bean:define標簽創(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標簽取回請求中名稱(chēng)為name的header的值。如果沒(méi)有指定multiple屬性則依據剛取回的值創(chuàng )建一個(gè)String類(lèi)型的bean。如果指定了multiple屬性則依據剛取回的值創(chuàng )建一個(gè)String[]類(lèi)型的數組。然后用id屬性值將String或String[]綁定到page作用域中(這種綁定是為了其它標簽能夠使用該值)，并創(chuàng )建對應的scripting變量(這種變量是為了JSP腳本能夠使用該值)。
下面是我的瀏覽器發(fā)送的header的內容，這些內容和瀏覽器有關(guān)，因此您的瀏覽器發(fā)送的內容可能和下面列出的不同。不過(guò)這沒(méi)有關(guān)系，因為要理解bean:header標簽您只要對這些內容有一個(gè)大概的認識就足夠了。
accept: */*accept-language: zh-cnaccept-encoding: gzip, deflateuser-agent: Mozilla/4.0 (compatible; MSIE 6.0; //應該在同一行Windows NT 5.1; SV1; .NET CLR 1.1.4322)host: localhost:8080connection: Keep-Alive
下面的代碼片段示例了如何使用bean:header標簽讀取名為User-Agent的header的值，并且使用了兩種方式進(jìn)行了輸出：
<logic:present header="User-Agent"><!-- 其它標簽通過(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標簽對指定url(由forward、href或page確定)處的資源做一個(gè)請求，將響應數據作為一個(gè)String類(lèi)型的bean綁定到page作用域，同時(shí)創(chuàng )建一個(gè)scripting變量。我們可以通過(guò)id值訪(fǎng)問(wèn)它們。
下面的代碼片段示例了bean:include標簽的用法，其中include.txt文件包含要include的內容，然后將這些內容輸出:
<bean:include id="value" page="/include.txt"/><!-- 其它標簽通過(guò)綁定到page作用域中的屬性使用該值 --><bean:write name="value"/><br/><!-- JSP腳本通過(guò)scripting變量使用該值 --><%out.println(value);%>
bean:message標簽用來(lái)從指定的locale中取回國際化的消息并輸出，在這個(gè)過(guò)程中我們還可以傳遞五個(gè)以?xún)鹊膮?。message key可以通過(guò)key直接指定，也可以通過(guò)name和property間接的指定。
bean:message標簽有兩種指定message key的方式，一是通過(guò)key屬性直接指定；二是通過(guò)name和property屬性間接的指定，其中message key是在message resources文件中定義的。
我們可以在struts-config.xml文件中使用<message-resources>來(lái)設置message resources文件。
為了介紹該標簽我使用了三個(gè)message resources文件，三個(gè)文件的名字分別為Resources.properties、Resources_en.properties和Resources_zh.properties。在struts-config.xml文件中的設置(這里不用設置三個(gè)，struts會(huì )依據locale自動(dò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因為文件的編碼被限制為ISO8859所以要有漢字必須用jdk的native2ascii提前轉換-->from=Resources_zh.properties.
下面的代碼片段示例了bean:message標簽的用法:
<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標簽，要使它們工作您的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è)結果：
在locale為zh時(shí)的結果：Resources_zh.properties.Resources.properties.在locale為en時(shí)的結果：Resources_en.properties.Resources.properties.
讓我們來(lái)看一下在locale為zh時(shí)如何得到的是上面的結果。因為locale為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è)文件中找，很幸運這里找到了。如果還沒(méi)有找到，或message resource文件不存在就會(huì )拋出異常。當locale為en時(shí)類(lèi)似，您可以自己試試。
bean:page標簽將頁(yè)上下文中的application、config、request、response 或 session取出，然后用id屬性值將它們綁定到page作用域中(這種綁定是為了其它標簽能夠使用該值)，并創(chuàng )建對應的scripting變量(這種變量是為了JSP腳本能夠使用該值)。
下面的代碼片段示例了bean:page標簽取出response，然后使用bean:write標簽將response的characterEncoding和contentType屬性輸出：
<bean:page id="res" property="response"/><!-- 其它標簽通過(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/>");%>
您可以用和上面類(lèi)似的代碼訪(fǎng)問(wèn)application、config、request 或 session中的任何一個(gè)對象。
bean:parameter標簽取回請求中的參數值。如果沒(méi)有指定multiple屬性則依據剛取回的值創(chuàng )建一個(gè)String類(lèi)型的bean。如果指定了multiple屬性則依據剛取回的值創(chuàng )建一個(gè)String[]類(lèi)型的數組。然后用id屬性值將String或String[]綁定到page作用域中(這種綁定是為了其它標簽能夠使用該值)，并創(chuàng )建對應的scripting變量(這種變量是為了JSP腳本能夠使用該值)。
下面的兩個(gè)代碼片段使用相同的url傳遞參數，url的形式為http://127.0.0.1:8080/struts-demo/parameter.jsp?param=1¶m=2¶m=3。前面的代碼片段中沒(méi)有指定multiple屬性，因此p是String類(lèi)型而且僅僅讀取了參數的第一個(gè)值。后面的代碼片段中指定了multiple屬性的值，因此ps是String[]類(lèi)型的包含所有參數的值。
<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標簽取回指定的web應用程序的資源，以InputStream或String的形式保存到page作用域中并且創(chuàng )建scripting變量。采用什么形式取決于標簽的input屬性，如果指定input則以InputStream的形式保存，如果沒(méi)有指定input則以String的形式保存。
下面的兩個(gè)代碼片段示例了bean:resource標簽，其中resource.txt是要使用的資源文件。前面的代碼片段中沒(méi)有指定input屬性，因此以String的形式處理資源文件，bean:write標簽輸出資源文件的內容。后面的代碼片段中指定了input屬性的值，因此以InputStream的形式使用資源文件，兩個(gè)bean:write標簽分別輸出InputStream對象的實(shí)例名(如java.io.ByteArrayInputStream@16dadf9)和類(lèi)名(如class java.io.ByteArrayInputStream)。
<bean:resource id="str" name="/resource.txt"/><!-- 其它標簽通過(guò)綁定到page作用域中的屬性使用該值 --><bean:write name="str"/><br/><!-- JSP腳本通過(guò)scripting變量使用該值 --><%out.println(str+"<br/>");%>
<bean:resource id="is" input="true" name="/resource.txt"/><!-- 其它標簽通過(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標簽創(chuàng )建一個(gè)java.lang.Integer類(lèi)型的bean，這個(gè)bean的值為該標簽指定的Collection或Map中所含元素的個(gè)數。 這可以和logic:iterate標簽配合使用，因為logic:iterate標簽不能得到所疊代的集合的元素的個(gè)數，這有時(shí)候很不方便。
下面的代碼片段示例了bean:size標簽取出persons中還有元素的個(gè)數，其中listForm和persons的定義參見(jiàn)bean:define標簽部分：
<logic:notEmpty name="listForm" property = "persons"><bean:size id="size" name="listForm" property = "persons"/><bean:write name="size"/></logic:notEmpty>
bean:struts標簽取回Struts的內部對象formBean、forward或mapping的值，然后用id綁定到page作用域中(這種綁定是為了其它標簽能夠使用該值)，并創(chuàng )建對應的scripting變量(這種變量是為了JSP腳本能夠使用該值)。
下面的代碼片段示例了bean:struts標簽取出listForm對象，讓我們先來(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/>
上面代碼運行的結果為：
name:listFormtype:org.solo.struts.form.ListFormdynamic:false
bean:write標簽將指定的bean的屬性值寫(xiě)到當前的JspWriter中，并且可以對輸出進(jìn)行格式化。
下面的代碼片段示例了bean:write標簽輸出User-Agent：
<logic:present header="User-Agent"><bean:header id="header" name="User-Agent"/><bean:write name="header"/></logic:present>
下面的代碼片段示例了bean:write標簽格式化輸出當前日期，其中now是在DataForm中定義的一個(gè)java.util.Date類(lèi)型的域(值為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"/>
上面代碼運行的結果為：
Sun Jun 04 17:04:05 CST 200606/04/20062006-06-04
雖然這里的標題是html:base標簽，但是這里也是這篇指南要介紹的第一個(gè)Struts html標簽。因此我想在這里從整體上簡(jiǎn)單的介紹一下，最后給出一個(gè)對照表。其中的絕大多數標簽就不一一介紹了，要介紹的也不會(huì )在這里介紹，而是將其獨立出來(lái)以顯重要性。
從用戶(hù)處收集數據是動(dòng)態(tài)web應用非常重要的一個(gè)方面，因此構建輸入表單也就自然而然的成為struts框架的一個(gè)重要內容。Struts html標簽庫含有創(chuàng )建Struts輸入表單的標簽，和其它標簽庫(bean、logic、nested和tiles)中的標簽一起協(xié)作就可以產(chǎn)生基于html的用戶(hù)界面。
下面的對照表會(huì )使您對Struts html標簽庫有一個(gè)整體的印象：
html:cancel標簽生成一個(gè)取消按鈕。當點(diǎn)擊該按鈕后action servlet會(huì )繞過(guò)相應的form bean的validate()方法，同時(shí)將控制權交給相應的action。在該action中可以使用Action.isCancelled(HttpServletRequest)方法判斷是否被取消了。如果返回true表示這個(gè)action被取消了，否則表示這個(gè)action沒(méi)有被取消。
請注意，如果您修改了html:cancel標簽的property屬性值，那么struts提供的cancel探測機制就失效了，您自己必須提供類(lèi)似的機制。
下面是可取消的action的配置文件，注意<set-property property="cancellable" value="true"/>這一行，如果不添加Struts會(huì )拋出org.apache.struts.action.InvalidCancelException異常。這是我在完成本指南的過(guò)程中發(fā)現的唯一向下不兼容的地方。
<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標簽的代碼：
<html:cancel>取消</html:cancel>
下面是對應的action中的代碼：
if(isCancelled(request)){//action被取消時(shí)要做的事情寫(xiě)在這里return mapping.findForward("cancel");}else{//action沒(méi)有被取消時(shí)要做的事情寫(xiě)在這里return mapping.findForward("success");}html:select標簽生成一個(gè)select元素。是單選還是多選取決于該標簽的multiple屬性。如果指定了multiple="true"則為多選，此時(shí)對應的屬性應該是一個(gè)數組。如果沒(méi)有指定multiple="true"則為單選，此時(shí)對應的屬性應該是標量。
注意：為了正確的處理沒(méi)有做任何的選擇的情況，在A(yíng)ctionForm中的reset()方法中必須將標量屬性設置為默認值而將數組的長(cháng)度置為0。
另外的一個(gè)重要問(wèn)題就是struts如何生成option元素了，這個(gè)任務(wù)struts交給了html:option、html:options和html:optionsCollection三個(gè)標簽。
html:option標簽
html:option標簽生成一個(gè)HTML的option元素。該標簽必須嵌在html:select標簽中。它的顯示文本來(lái)自其標簽體，也可以來(lái)自于資源文件。它的value屬性用來(lái)指定什么值將要被提交。
<html:option value="one">one</html:option><html:option value="two">two</html:option>
html:options標簽
html:options標簽生成多個(gè)HTML的option元素。該標簽必須嵌在html:select標簽中。而且工作方式有些特殊，它的name與property屬性和其它標簽的name與property屬性意義不一致，讓我們具體看一下它的工作方式。
指定collection屬性
讓我通過(guò)示例來(lái)介紹在指定collection屬性時(shí)該標簽的工作方式，首先要說(shuō)明selectForm中的persons和listForm中的persons完全一致。請參見(jiàn)bean:define標簽。
下面的代碼先利用bean:define標簽將selectForm中的persons取到page作用域中，然后html:options標簽再依據collection="personCollection"選中這個(gè)persons并將其中的每一個(gè)對象(Person類(lèi)型)生成一個(gè)option元素。該標簽的property="id"表示persons中的對象(Person類(lèi)型)的id屬性將作為option元素的value值。該標簽的labelProperty="name"表示persons中的對象(Person類(lèi)型)的name屬性將作為option元素的label值。
當這個(gè)select提交時(shí)所選擇的值將被提交到selectForm(name="selectForm")中的person對象(這是在SelectForm中聲明的一個(gè)Person類(lèi)型的域專(zhuān)門(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í)該標簽的工作方式，先來(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è)列表含有相同數目的元素。有了這些讓我們開(kāi)始介紹下面的代碼。html:options標簽用ids中的第i個(gè)值作為option元素的value值同時(shí)使用names中相同位置的值(第i個(gè)值)作為option元素的label值。如果ids比names長(cháng)那么多出的ids中的值將即作為option的value又作為option的label。如果ids比names短那么多出的names的值會(huì )被丟掉。
當這個(gè)select提交時(shí)所選擇的值將被提交到selectForm(name="selectForm")中的person對象(這是在SelectForm中聲明的一個(gè)Person類(lèi)型的域專(zhuān)門(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標簽
html:optionsCollection標簽生成多個(gè)HTML的option元素。該標簽必須嵌在html:select標簽中。它的功能和html:options標簽的相同，但是它的name與property屬性和其它標簽的name與property屬性意義一致，理解起來(lái)比較自然。
讓我通過(guò)示例來(lái)介紹html:optionsCollection標簽的用法。首先依據name="selectForm"和property="persons"取到selectForm中的persons列表，然后將列表中的對象(Person類(lèi)型)的id屬性作為option元素的value值(value="id")，將列表中的對象(Person類(lèi)型)的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標簽，但是html:option和html:optionsCollection也能夠用來(lái)多選。而且您還必須意識到html:option、html:options和html:optionsCollection這三個(gè)標簽可以同時(shí)使用。代碼中的personIds是SelectForm中聲明的一個(gè)String[]類(lèi)型的數組用來(lái)接收提交的多個(gè)值。
<html:select name="selectForm" property="personIds"multiple="true" size="2"><html:options property="ids" labelProperty="names"/></html:select>
html:check標簽生成一個(gè)checkbox。這里的value值可以是true，yes或on。如果您要提交其它的值(如某種形式的標識)應該考慮使用html:multibox標簽。
注意:為了正確的處理沒(méi)有選中的checkbox您必須在reset()中設置對應的屬性為false。
下面的代碼示例了html:checkbox標簽的用法，其中CheckboxForm中聲明了三個(gè)boolean類(lèi)型的域，如下：
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>
如果選中后被提交則相應的屬性的值為true。
html:radio標簽生成一個(gè)radio。主要的用法有兩種，下面我們通過(guò)代碼來(lái)示例。
下面的代碼示例了html:radio標簽的一般用法，如果被提交則選中的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標簽的典型用法，其中的persons和bean:define標簽中的一致，您可以參考bean:define標簽。我只介紹這個(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標簽生成多個(gè)checkbox。當您要使用大量的checkbox時(shí)使用這個(gè)標簽非常方便，可以使您避免在A(yíng)ctionForm中聲明大量的boolean類(lèi)型的變量，帶之以一個(gè)數組就行了。
注意:為了正確的處理沒(méi)有選中的checkbox您必須在reset()中設置數組的長(cháng)度為0。
下面的代碼示例了html:multibox標簽的一般用法，如果被提交則選中的所有checkbox的value值將被提交到multiboxForm中的selectedItems中，這是一個(gè)String[]數組。
<html:multibox name="multiboxForm" property="selectedItems"value="00001"/><html:multibox name="multiboxForm" property="selectedItems"value="00002"/>
下面的代碼示例了html:multibox標簽的典型用法：
<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標簽生成一個(gè)錨點(diǎn)(<a>)元素。我從html:link標簽如何構造基本url和如何構造query參數兩個(gè)方面來(lái)介紹這個(gè)標簽。
構造基本url是依據該標簽的如下四個(gè)屬性進(jìn)行的，這四個(gè)屬性一次只能出現一個(gè)。讓我們看看它們：
構造query參數，下面列舉了可能的形式，其中baseurl只是一個(gè)占位符：
下面我們以代碼示例來(lái)說(shuō)明每一種html:link的用法，首先讓我們花點(diǎn)時(shí)間看看相關(guān)action中的代碼：
<!-- 下面所有代碼的數據都是在這里構造的 -->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)設置一個(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標簽的indexed屬性和indexId屬性的用法，這兩個(gè)屬性只有html:link標簽嵌套在logic:iterate標簽中時(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><!-- 下面是上面代碼的運行結果(產(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"確定的，而該參數的值為元素在集合中的位置。-->
html:rewrite標簽和html:link標簽類(lèi)似只是不生成錨點(diǎn)(<a>)，而是簡(jiǎn)單的輸出字符串。
html:errors標簽和html:messages標簽的功能相似，所以我們放到一起來(lái)介紹。
html:errors標簽將由name屬性指定的ActionMessages、ActionErrors、String和String[]直接輸出到頁(yè)面中。
html:messages標簽將用由name屬性(注意message屬性值對它的影響)指定的ActionMessages、ActionErrors、String和String[]創(chuàng )建一個(gè)新的屬性和scripting變量，使用id屬性值作為名稱(chēng)。
html:errors標簽和html:messages標簽的property屬性是用來(lái)為errors和messages分類(lèi)的。我們可以給這兩個(gè)標簽指定property屬性，以便只顯示某一類(lè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的構造：
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標簽代碼示例：
<html:errors/><br/><html:errors property="property4"/>
messages標簽代碼示例：
<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標簽生成用于校驗的javascript腳本代碼。
下面的代碼片段示例了html:javascript標簽的基本用法，其中formName屬性的值是在validation.xml文件的<formset>中定義的form的名稱(chēng)。有一點(diǎn)值得注意的是在確定<formset>時(shí)要使用合適的language屬性值。
<html:javascript formName="dataForm"/>
html:xhtml標簽在頁(yè)面中一出現就是告訴該頁(yè)的所有其它的Struts html標簽以XHTML1.0兼容的形式輸出。這和將html:html標簽的xhtml屬性值指定為true有些類(lèi)似。如果上述情況都沒(méi)有出現，Struts html標簽將以html4.01兼容的形式輸出。
logic:iterate標簽用來(lái)迭代集合，您可以使用如下方式來(lái)為這個(gè)標簽指定其要疊代的集合：
上面所提到的集合可以是：
如果您疊代的集合中含有null的值，這時(shí)需要采取一定的措施，因為這時(shí)logic:iterate不會(huì )在page作用域中創(chuàng )建對象。一般是使用<logic:present>標簽或<logic:notPresent>標簽來(lái)判斷一下。
下面是logic:iterate疊代ArrayList的示例的對象引用關(guān)系和部分代碼：
圖中的persons列表是在ListAction中填充的，在這里只是簡(jiǎn)單的加入了三個(gè)Person對象，在實(shí)際的應用中這些數據應該取自數據庫。具體的代碼如下：
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");}標簽輸出的結果為：
00001-->趙辰00002-->李為芳00003-->王微
如果指定的值出現該標簽就會(huì )創(chuàng )建其標簽體內的內容。該標簽用于以下情況：
下面的代碼示例了logic:present標簽檢查具有指定名稱(chēng)User-Agent的header是否出現：
<logic:present header="User-Agent">您的瀏覽器是<bean:header id="userAgent" name="User-Agent"/><bean:write name="userAgent"/>。<br/></logic:present>
logic:notPresent標簽的應用正好和logic:present標簽相反。
logic:messagesPresent標簽用于以下情況：
標簽的message屬性值為true時(shí)將以Globals.MESSAGE_KEY為key在request作用域中查找Message，其它情況下，將name的值作為key查找，如果name 沒(méi)有出現，默認值為Globals.ERROR_KEY。
下面的代碼示例了logic:messagesPresent標簽的典型用法：
<logic:messagesPresent><ul><html:messages id="message"><li><bean:write name="message"/></li></html:messages></ul></logic:messagesPresent>
標簽logic:messagesNotPresent的應用正好和logic:messagesPresent的應用相反。
logic:empty標簽是用來(lái)判斷是否為空的。如果為空，該標簽體中嵌入的內容就會(huì )被處理。該標簽用于以下情況：
下面的代碼示例了logic:empty標簽判斷集合persons是否為空：
<logic:empty name="listForm" property = "persons"><div>集合persons為空!</div></logic:empty>
logic:notEmpty標簽的應用正好和logic:empty標簽相反。
logic:match標簽用來(lái)處理子串匹配問(wèn)題。
如果指定的值匹配該標簽就會(huì )創(chuàng )建其標簽體內的內容。該標簽用于以下情況：
下面的代碼示例了logic:match標簽的典型用法：
<logic:present header="User-Agent"><logic:match header="User-Agent" value="MSIE 6.0">MS IE 6.0</logic:match></logic:present>
logic:notMatch標簽的應用正好和logic:match標簽相反。
這里要介紹的不只是logic:equal(=)標簽，而是要介紹一類(lèi)標簽，這類(lèi)標簽完成比較運算，包括：
該類(lèi)標簽的用法類(lèi)似，我們只介紹logic:equal標簽，其它的留給您自己去完成。
logic:equal是用來(lái)判斷是否相等的。如果相等，該標簽體中嵌入的內容就會(huì )被處理。該標簽用于以下情況：
我覺(jué)得將forward和redirect這兩個(gè)動(dòng)作放到一起對比著(zhù)介紹更加有利于理解，基于此原因也就將logic:forward和logic:redirect這兩個(gè)標簽也拿到這里一起介紹了。
讓我們看看這兩個(gè)動(dòng)作的區別：
redirect比f(wàn)orward慢，因為瀏覽器要做二次請求。還有就是要注意，在第一次的請求作用域(request作用域)內的bean對于第二次請求是不可見(jiàn)的。
理解了上面描述的區別也就知道了什么時(shí)候該選用logic:forward標簽什么時(shí)候該選用logic:redirect標簽了。logic:forward標簽完成PageContext.forward()或HttpServletResponse.sendRedirect()，如何選擇由控制器決定。logic:redirect標簽完成HttpServletResponse.sendRedirect()。
在使用logic:redirect標簽時(shí)我們可以向使用html:link一樣構造baseurl和query參數。如果您感興趣可以參考html:link標簽。
這篇指南的背景是Struts-1.2.9，其中的所有的代碼示例也都是在這個(gè)版本下調試通過(guò)的。目前Struts仍然在快速的發(fā)展中，但是從開(kāi)發(fā)者應用的角度來(lái)講還是比較穩定的。因此我有理由相信其中的代碼示例也可以很好的運行在其它的版本之上。最后希望這篇指南能夠讓您心情愉快！
聯(lián)系客服
