Struts是Apache Jakarta的一個著名的開源項目，目標是爲構建基於Java的web應用程序提供一個框架。
Struts提供了非常多的標籤，依據功能和使用習慣的不同被分到了五個標籤庫中:
- Bean Tags:該標籤庫包含的標籤可以用來創建bean、訪問bean和訪問bean的屬性。同時提供了依據cookies、headers和parameters的值創建相關bean的能力。
- HTML Tags:該標籤庫包含的標籤可以用來創建Struts輸入表單。
- Logic Tags:該標籤庫包含的標籤可以用來進行邏輯判斷、集合迭代和流程控制。
- Nested Tags:該標籤庫建立在前三個標籤庫的基礎上，具有前三個標籤庫的所有功能，只是允許標籤間的嵌套。
- Tiles Tags:該標籤庫包含的標籤可以用來創建tiles樣式的頁面。
這篇指南主要介紹前三個標籤庫中的標籤。如果您對後兩類標籤也感興趣可以查閱參考資料中的Struts的用戶指南。
bean:cookie
cookie最早是由Netscape公司提出來的，用來存儲客戶的少量狀態信息。如果您對cookie的具體細節感興趣可以查閱參考資料中的cookie spec。
bean: cookie標籤取回請求中名稱爲name的cookie的值。如果沒有指定multiple屬性則依據剛取回的值創建一個Cookie類型的bean。如果指定了multiple屬性則依據剛取回的值創建一個Cookie[]類型的數組。然後用id屬性值將Cookie或Cookie[]綁定到page 作用域中(這種綁定是爲了其它標籤能夠使用該值)，並創建對應的scripting變量(這種變量是爲了JSP腳本能夠使用該值)。
下面的代碼片段示例瞭如何使用bean:cookie標籤讀取名爲JSESSIONID的cookie的值，並且使用了兩種方式進行了輸出：
<logic:present cookie="JSESSIONID">
<bean:cookie id="jSession" name="JSESSIONID"/>
<!-- 其它標籤通過綁定到page作用域中的屬性使用該值 -->
這個cookie的名稱是<bean:write name="jSession" property="name"/>，值爲<bean:write name="jSession" property="value"/>。<br/>
<!-- JSP腳本通過scripting變量使用該值 -->
<%
String name = jSession.getName();
String value = jSession.getValue();
out.println("這個cookie的名稱是"+name+"，值爲"+value+"。<br/>");
%>
</logic:present>
bean:define
bean: define標籤在toScope(如果沒有指定值就使用page作用域)指定的作用域中創建一個新屬性，同時創建一個scripting變量。我們可以通過id值使用它們。新創建的屬性可以由其它標籤使用，而新創建的scripting變量可以由JSP腳本使用。
我們可以使用三種方式爲新創建的屬性和scripting變量賦值：
- 通過該標籤的name、property和scope取回值，並且保持類型的一致性，除非取回的值爲Java的原始類型，這時會使用適合的包裝器類對這些值進行包裝。
- 通過該標籤的value指定值，這時新創建的屬性和scripting變量的類型爲java.lang.String。
- 通過在該標籤的體中嵌入值，這時新創建的屬性和scripting變量的類型爲java.lang.String。
下面的代碼片段示例瞭如何使用bean:define標籤創建新屬性values和新scripting變量values，它將listForm中persons的值取出來賦給values:
<bean:define id="values" name="listForm" property = "persons" type="java.util.List"/>
下面給出ListForm的代碼片段以幫助您更好的理解，其中Person是一個只有id和name兩個屬性的簡單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標籤創建的新屬性values:
<logic:iterate id="person" name="values"> <bean:write name="person" property="id"/><br/> </logic:iterate>
下面的代碼片段示例了JSP腳本如何使用bean:define標籤創建的新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標籤取回請求中名稱爲name的header的值。如果沒有指定multiple屬性則依據剛取回的值創建一個String類型的bean。如果指定了multiple屬性則依據剛取回的值創建一個String[]類型的數組。然後用id屬性值將String或String[]綁定到page 作用域中(這種綁定是爲了其它標籤能夠使用該值)，並創建對應的scripting變量(這種變量是爲了JSP腳本能夠使用該值)。
下面是我的瀏覽器發送的header的內容，這些內容和瀏覽器有關，因此您的瀏覽器發送的內容可能和下面列出的不同。不過這沒有關係，因爲要理解bean:header標籤您只要對這些內容有一個大概的認識就足夠了。
accept: */* accept-language: zh-cn accept-encoding: gzip, deflate user-agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.1.4322) host: localhost:8080 connection: Keep-Alive
下面的代碼片段示例瞭如何使用bean:header標籤讀取名爲User-Agent的header的值，並且使用了兩種方式進行了輸出：
<logic:present header="User-Agent">
<!-- 其它標籤通過綁定到page作用域中的屬性使用該值 -->
您的瀏覽器是<bean:header id="userAgent" name="User-Agent"/>
<bean:write name="userAgent"/>。<br/>
<!-- JSP腳本通過scripting變量使用該值 -->
<%
out.println("您的瀏覽器是"+userAgent+"。<br/>");
%>
</logic:present>
bean:include
bean:include標籤對指定url(由forward、href或page確定)處的資源做一個請求，將響應數據作爲一個String類型的bean綁定到page作用域，同時創建一個scripting變量。我們可以通過id值訪問它們。
下面的代碼片段示例了bean:include標籤的用法，其中include.txt文件包含要include的內容，然後將這些內容輸出:
<bean:include id="value" page="/include.txt"/> <!-- 其它標籤通過綁定到page作用域中的屬性使用該值 --> <bean:write name="value"/><br/> <!-- JSP腳本通過scripting變量使用該值 --> <% out.println(value); %>
bean:message
bean:message標籤用來從指定的locale中取回國際化的消息並輸出，在這個過程中我們還可以傳遞五個以內的參數。message key可以通過key直接指定，也可以通過name和property間接的指定。
bean:message標籤有兩種指定message key的方式，一是通過key屬性直接指定；二是通過name和property屬性間接的指定，其中message key是在message resources文件中定義的。
我們可以在struts-config.xml文件中使用<message-resources>來設置message resources文件。
爲了介紹該標籤我使用了三個message resources文件，三個文件的名字分別爲Resources.properties、Resources_en.properties和 Resources_zh.properties。在struts-config.xml文件中的設置(這裏不用設置三個，struts會依據 locale自動找到對應的文件)如下：
<message-resources parameter="Resources" />
三個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的兩個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下我們得到了如下的兩個結果：
在locale爲zh時的結果： Resources_zh.properties. Resources.properties. 在locale爲en時的結果： Resources_en.properties. Resources.properties.
讓我們來看一下在locale爲zh時如何得到的是上面的結果。因爲locale爲zh所以 <bean:message key="from"/><br/>先找Resources_zh.properties這個文件從中得到form鍵的值。而< bean:message key="resource"/><br/>也會先找Resources_zh.properties這個文件但這次沒有找到 resource鍵，這時Struts會到Resources.properties這個文件中找，很幸運這裏找到了。如果還沒有找到，或message resource文件不存在就會拋出異常。當locale爲en時類似，您可以自己試試。
bean:page
bean: page標籤將頁上下文中的application、config、request、response 或 session取出，然後用id屬性值將它們綁定到page作用域中(這種綁定是爲了其它標籤能夠使用該值)，並創建對應的scripting變量(這種變量是爲了JSP腳本能夠使用該值)。
下面的代碼片段示例了bean:page標籤取出response，然後使用bean:write標籤將response的characterEncoding和contentType屬性輸出：
<bean:page id="res" property="response"/> <!-- 其它標籤通過綁定到page作用域中的屬性使用該值 --> <bean:write name="res" property="characterEncoding"/><br/> <bean:write name="res" property="contentType"/><br/> <!-- JSP腳本通過scripting變量使用該值 --> <% String characterEncoding = res.getCharacterEncoding(); String contentType = res.getContentType(); out.println(characterEncoding+"<br/>"); out.println(contentType+"<br/>"); %>
您可以用和上面類似的代碼訪問application、config、request 或 session中的任何一個對象。
bean:parameter
bean: parameter標籤取回請求中的參數值。如果沒有指定multiple屬性則依據剛取回的值創建一個String類型的bean。如果指定了 multiple屬性則依據剛取回的值創建一個String[]類型的數組。然後用id屬性值將String或String[]綁定到page作用域中 (這種綁定是爲了其它標籤能夠使用該值)，並創建對應的scripting變量(這種變量是爲了JSP腳本能夠使用該值)。
下面的兩個代碼片段使用相同的url傳遞參數，url的形式爲http://127.0.0.1:8080/struts- demo/parameter.jsp?param=1¶m=2¶m=3。前面的代碼片段中沒有指定multiple屬性，因此p是String類型而且僅僅讀取了參數的第一個值。後面的代碼片段中指定了multiple屬性的值，因此ps是String[]類型的包含所有參數的值。
<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標籤取回指定的web應用程序的資源，以InputStream或String的形式保存到page作用域中並且創建scripting 變量。採用什麼形式取決於標籤的input屬性，如果指定input則以InputStream的形式保存，如果沒有指定input則以String的形式保存。
下面的兩個代碼片段示例了bean:resource標籤，其中resource.txt是要使用的資源文件。前面的代碼片段中沒有指定input屬性，因此以String的形式處理資源文件，bean: write標籤輸出資源文件的內容。後面的代碼片段中指定了input屬性的值，因此以InputStream的形式使用資源文件，兩個bean: write標籤分別輸出InputStream對象的實例名(如java.io.ByteArrayInputStream@16dadf9)和類名(如 class java.io.ByteArrayInputStream)。
<bean:resource id="str" name="/resource.txt"/> <!-- 其它標籤通過綁定到page作用域中的屬性使用該值 --> <bean:write name="str"/><br/> <!-- JSP腳本通過scripting變量使用該值 --> <% out.println(str+"<br/>"); %>
<bean:resource id="is" input="true" name="/resource.txt"/> <!-- 其它標籤通過綁定到page作用域中的屬性使用該值 --> <bean:write name="is"/><br/> <bean:write name="is" property="class"/> <!-- JSP腳本通過scripting變量使用該值 --> <% out.println(is+"<br/>"); out.println(is.getClass()+"<br/>"); %>
bean:size
bean:size標籤創建一個java.lang.Integer類型的bean，這個bean的值爲該標籤指定的Collection或Map中所含元素的個數。 這可以和logic:iterate標籤配合使用，因爲logic:iterate標籤不能得到所疊代的集合的元素的個數，這有時候很不方便。
下面的代碼片段示例了bean:size標籤取出persons中還有元素的個數，其中listForm和persons的定義參見bean:define標籤部分：
<logic:notEmpty name="listForm" property = "persons"> <bean:size id="size" name="listForm" property = "persons"/> <bean:write name="size"/> </logic:notEmpty>
bean:struts
bean:struts標籤取回Struts的內部對象formBean、forward或mapping的值，然後用id綁定到page作用域中(這種綁定是爲了其它標籤能夠使用該值)，並創建對應的scripting變量(這種變量是爲了JSP腳本能夠使用該值)。
下面的代碼片段示例了bean:struts標籤取出listForm對象，讓我們先來看一下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:listForm type:org.solo.struts.form.ListForm dynamic:false
bean:write
bean:write標籤將指定的bean的屬性值寫到當前的JspWriter中，並且可以對輸出進行格式化。
下面的代碼片段示例了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中定義的一個java.util.Date類型的域(值爲new Date())，format.date.standard是在資源文件中的一個鍵(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 2006 06/04/2006 2006-06-04
html:base
雖然這裏的標題是html:base標籤，但是這裏也是這篇指南要介紹的第一個Struts html標籤。因此我想在這裏從整體上簡單的介紹一下，最後給出一個對照表。其中的絕大多數標籤就不一一介紹了，要介紹的也不會在這裏介紹，而是將其獨立出來以顯重要性。
從用戶處收集數據是動態web應用非常重要的一個方面，因此構建輸入表單也就自然而然的成爲struts框架的一個重要內容。Struts html標籤庫含有創建Struts輸入表單的標籤，和其它標籤庫(bean、logic、nested和tiles)中的標籤一起協作就可以產生基於 html的用戶界面。
下面的對照表會使您對Struts html標籤庫有一個整體的印象：
html:cancel
html: cancel標籤生成一個取消按鈕。當點擊該按鈕後action servlet會繞過相應的form bean的validate()方法，同時將控制權交給相應的action。在該action中可以使用Action.isCancelled (HttpServletRequest)方法判斷是否被取消了。如果返回true表示這個action被取消了，否則表示這個action沒有被取消。
請注意，如果您修改了html:cancel標籤的property屬性值，那麼struts提供的cancel探測機制就失效了，您自己必須提供類似的機制。
下面是可取消的action的配置文件，注意<set-property property="cancellable" value="true"/>這一行，如果不添加Struts會拋出 org.apache.struts.action.InvalidCancelException異常。這是我在完成本指南的過程中發現的唯一向下不兼容的地方。
<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被取消時要做的事情寫在這裏
return mapping.findForward("cancel");
}else{
//action沒有被取消時要做的事情寫在這裏
return mapping.findForward("success");
}
html:select
html: select標籤生成一個select元素。是單選還是多選取決於該標籤的multiple屬性。如果指定了multiple="true"則爲多選，此時對應的屬性應該是一個數組。如果沒有指定multiple="true"則爲單選，此時對應的屬性應該是標量。
注意：爲了正確的處理沒有做任何的選擇的情況，在ActionForm中的reset()方法中必須將標量屬性設置爲默認值而將數組的長度置爲0。
另外的一個重要問題就是struts如何生成option元素了，這個任務struts交給了html:option、html:options和html:optionsCollection三個標籤。
html:option標籤
html:option標籤生成一個HTML的option元素。該標籤必須嵌在html:select標籤中。它的顯示文本來自其標籤體，也可以來自於資源文件。它的value屬性用來指定什麼值將要被提交。
<html:option value="one">one</html:option> <html:option value="two">two</html:option>
html:options標籤
html:options標籤生成多個HTML的option元素。該標籤必須嵌在html:select標籤中。而且工作方式有些特殊，它的name與property屬性和其它標籤的name與property屬性意義不一致，讓我們具體看一下它的工作方式。
- 指定collection屬性
- 沒有指定collection屬性
指定collection屬性
讓我通過示例來介紹在指定collection屬性時該標籤的工作方式，首先要說明selectForm中的persons和listForm中的persons完全一致。請參見bean:define標籤。
下面的代碼先利用bean:define標籤將selectForm中的persons取到page作用域中，然後html:options標籤再依據 collection="personCollection"選中這個persons並將其中的每一個對象(Person類型)生成一個option元素。該標籤的property="id"表示persons中的對象(Person類型)的id屬性將作爲option元素的value值。該標籤的 labelProperty="name"表示persons中的對象(Person類型)的name屬性將作爲option元素的label值。
當這個select提交時所選擇的值將被提交到selectForm(name="selectForm")中的person對象(這是在 SelectForm中聲明的一個Person類型的域專門用來接收提交的值)的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>
沒有指定collection屬性
讓我通過示例來介紹沒有指定collection屬性時該標籤的工作方式，先來看看ids和names的定義：
private List<String> ids = null; private List<String> names = null;
上面的代碼來自SelectForm，其中ids是一個String的列表，names也是一個 String的列表。我們暫時假定這兩個列表含有相同數目的元素。有了這些讓我們開始介紹下面的代碼。html:options標籤用ids中的第i個值作爲option元素的value值同時使用names中相同位置的值(第i個值)作爲option元素的label值。如果ids比names長那麼多出的ids中的值將即作爲option的value又作爲option的label。如果ids比names短那麼多出的names的值會被丟掉。
當這個select提交時所選擇的值將被提交到selectForm(name="selectForm")中的person對象(這是在 SelectForm中聲明的一個Person類型的域專門用來接收提交的值)的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標籤生成多個HTML的option元素。該標籤必須嵌在html:select標籤中。它的功能和html: options標籤的相同，但是它的name與property屬性和其它標籤的name與property屬性意義一致，理解起來比較自然。
讓我通過示例來介紹html:optionsCollection標籤的用法。首先依據name="selectForm"和property= "persons"取到selectForm中的persons列表，然後將列表中的對象(Person類型)的id屬性作爲option元素的 value值(value="id")，將列表中的對象(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>
下面是一個多選的示例，雖然示例中使用了html:options標籤，但是html: option和html:optionsCollection也能夠用來多選。而且您還必須意識到html:option、html:options和 html:optionsCollection這三個標籤可以同時使用。代碼中的personIds是SelectForm中聲明的一個String[] 類型的數組用來接收提交的多個值。
<html:select name="selectForm" property="personIds" multiple="true" size="2"> <html:options property="ids" labelProperty="names"/> </html:select>
html:checkbox
html:check標籤生成一個checkbox。這裏的value值可以是true，yes或on。如果您要提交其它的值(如某種形式的標識)應該考慮使用html:multibox標籤。
注意:爲了正確的處理沒有選中的checkbox您必須在reset()中設置對應的屬性爲false。
下面的代碼示例了html:checkbox標籤的用法，其中CheckboxForm中聲明瞭三個boolean類型的域，如下：
<!-- 略掉了get方法(也可以是isXXX形式)和set方法 --> 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
html:radio標籤生成一個radio。主要的用法有兩種，下面我們通過代碼來示例。
下面的代碼示例了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標籤。我只介紹這個<html:radio idName="person" property="id" value="id">，idName指定html:radio要使用的bean(這裏爲person)，value="id"表示person的 id屬性將作爲radio元素的value值而property="id"表示提交時選中的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標籤生成多個checkbox。當您要使用大量的checkbox時使用這個標籤非常方便，可以使您避免在ActionForm中聲明大量的boolean類型的變量，帶之以一個數組就行了。
注意:爲了正確的處理沒有選中的checkbox您必須在reset()中設置數組的長度爲0。
下面的代碼示例了html:multibox標籤的一般用法，如果被提交則選中的所有checkbox的value值將被提交到multiboxForm中的selectedItems中，這是一個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
html:link標籤生成一個錨點(<a>)元素。我從html:link標籤如何構造基本url和如何構造query參數兩個方面來介紹這個標籤。
構造基本url是依據該標籤的如下四個屬性進行的，這四個屬性一次只能出現一個。讓我們看看它們：
- forward，指定一個全局ActionForward的名稱。另外如果forward是module相關的則該forward必須指向一個action而不能是一個頁面。
- action，指定一個Action的名稱。
- href，struts會直接使用這個值而不會對其進行任何處理。
- page，指定一個頁面的路徑，必須以/開始。
構造query參數，下面列舉了可能的形式，其中baseurl只是一個佔位符：
- 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(混合)
下面我們以代碼示例來說明每一種html:link的用法，首先讓我們花點時間看看相關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");
}
<!-- 這用來設置一個位置 --> <html:link linkName="top"/> <!-- 這用來定位到上面的那個位置 --> <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屬性的用法，這兩個屬性只有html:link標籤嵌套在logic:iterate標籤中時纔可用。
<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> <!-- 下面是上面代碼的運行結果(產生的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標籤類似只是不生成錨點(<a>)，而是簡單的輸出字符串。
html:errors
html:errors標籤和html:messages標籤的功能相似，所以我們放到一起來介紹。
html:errors標籤將由name屬性指定的ActionMessages、ActionErrors、String和String[]直接輸出到頁面中。
html:messages標籤將用由name屬性(注意message屬性值對它的影響)指定的ActionMessages、ActionErrors、String和String[]創建一個新的屬性和scripting變量，使用id屬性值作爲名稱。
html:errors標籤和html:messages標籤的property屬性是用來爲errors和messages分類的。我們可以給這兩個標籤指定property屬性，以便只顯示某一類的錯誤或消息。
在資源文件增加了如下的內容：
# -- 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
html:javascript標籤生成用於校驗的javascript腳本代碼。
下面的代碼片段示例了html:javascript標籤的基本用法，其中formName屬性的值是在validation.xml文件的< formset>中定義的form的名稱。有一點值得注意的是在確定<formset>時要使用合適的language屬性值。
<html:javascript formName="dataForm"/>
html:xhtml
html: xhtml標籤在頁面中一出現就是告訴該頁的所有其它的Struts html標籤以XHTML1.0兼容的形式輸出。這和將html:html標籤的xhtml屬性值指定爲true有些類似。如果上述情況都沒有出現， Struts html標籤將以html4.01兼容的形式輸出。
logic:iterate
logic:iterate標籤用來迭代集合，您可以使用如下方式來爲這個標籤指定其要疊代的集合：
- 使用一個運行時表達式，這個表達式的值是一個集合。
- 用name屬性引用一個JSP Bean，這個JSP Bean本身就是一個集合。
- 用name屬性引用一個JSP Bean，這個JSP Bean的一個屬性是一個集合，這時可以聯合使用property來指定這個集合。
上面所提到的集合可以是：
- 對象類型或原子類型的數組(Array)。
- java.util.Collection的實現，包括ArrayList，Vector。
- java.util.Enumeration的實現。
- java.util.Iterator的實現。
- java.util.Map的實現，包括HashMap，Hashtable和TreeMap。
如果您疊代的集合中含有null的值，這時需要採取一定的措施，因爲這時logic:iterate不會在page作用域中創建對象。一般是使用<logic:present>標籤或<logic:notPresent>標籤來判斷一下。
下面是logic:iterate疊代ArrayList的示例的對象引用關係和部分代碼：
圖中的persons列表是在ListAction中填充的，在這裏只是簡單的加入了三個Person對象，在實際的應用中這些數據應該取自數據庫。具體的代碼如下：
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-->王微
logic:present
如果指定的值出現該標籤就會創建其標籤體內的內容。該標籤用於以下情況：
- 檢查具有指定名稱的cookie是否出現。
- 檢查具有指定名稱的header是否出現。
- 檢查具有指定名稱的JSP Bean是否出現 或 檢查具有指定名稱的JSP Bean中的property屬性是否出現。
- 檢查request中指定名稱的參數是否出現。
- 檢查當前的認證用戶是否與指定的安全角色相關聯。
- 檢查當前認證的主體是否具有指定的名字。
下面的代碼示例了logic:present標籤檢查具有指定名稱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
logic:messagesPresent標籤用於以下情況：
- 在request作用域中存在一個ActionMessages對象，標籤的property屬性和ActionMessages中的property對應。
- 在request作用域中存在一個ActionErrors對象，標籤的property屬性和ActionErrors中的property對應。
- 存在一個String對象，將其轉換(構造)成ActionMessage然後在添加到ActionMessages中。
- 存在一個String Array對象，將數組中的每一個String轉換成一個ActionMessage，在將其添加到ActionMessages中。
標籤的message屬性值爲true時將以Globals.MESSAGE_KEY爲key在request作用域中查找Message，其它情況下，將name的值作爲key查找，如果name 沒有出現，默認值爲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
logic:empty標籤是用來判斷是否爲空的。如果爲空，該標籤體中嵌入的內容就會被處理。該標籤用於以下情況：
- 當Java對象爲null時
- 當String對象爲""時
- 當java.util.Collection對象中的isEmpty()返回true時
- 當java.util.Map對象中的isEmpty()返回true時
下面的代碼示例了logic:empty標籤判斷集合persons是否爲空：
<logic:empty name="listForm" property = "persons"> <div>集合persons爲空!</div> </logic:empty>
logic:notEmpty標籤的應用正好和logic:empty標籤相反。
logic:match
logic:match標籤用來處理子串匹配問題。
如果指定的值匹配該標籤就會創建其標籤體內的內容。該標籤用於以下情況：
- 檢查具有指定名稱的cookie是否與該標籤的value匹配。
- 檢查具有指定名稱的header是否與該標籤的value匹配。
- 檢查具有指定名稱的JSP Bean是否與該標籤的value匹配 或 檢查具有指定名稱的JSP Bean中的property屬性值是否與該標籤的value匹配。
- 檢查request中指定名稱的參數值是否與該標籤的value匹配。
下面的代碼示例了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
這裏要介紹的不只是logic:equal(=)標籤，而是要介紹一類標籤，這類標籤完成比較運算，包括：
- logic:equal(=)
- logic:notEqual(!=)
- logic:greaterEqual(>=)
- logic:lessEqual(<=)
- logic:graterThan(>)
- logic:lessThan(<)
該類標籤的用法類似，我們只介紹logic:equal標籤，其它的留給您自己去完成。
logic:equal是用來判斷是否相等的。如果相等，該標籤體中嵌入的內容就會被處理。該標籤用於以下情況：
- 比較由該標籤的cookie屬性指定的cookie的值是否與該標籤的value屬性值相等。
- 比較由該標籤的header屬性指定的header的值是否與該標籤的value屬性值相等。
- 比較由該標籤的name屬性指定的JSP Bean是否與該標籤的value屬性值相等(property屬性不出現)或比較由該標籤的name屬性指定的JSP Bean中的property屬性值是否與該標籤的value屬性值相等。
- 比較由該標籤的parameter屬性指定的參數值(request中)是否與該標籤的value屬性值相等。
logic:forward
我覺得將forward和redirect這兩個動作放到一起對比着介紹更加有利於理解，基於此原因也就將logic:forward和logic:redirect這兩個標籤也拿到這裏一起介紹了。
讓我們看看這兩個動作的區別：
- forward是在servlet內部執行，瀏覽器完全不會感知到這個動作，原始的url也不會改變，瀏覽器重新裝載的話也只是對原始的請求進行簡單的重複。
- redirect則分成兩個步驟：第一步是web應用程序告訴瀏覽器第二個url，然後瀏覽器向第二個url發送請求。
redirect比forward慢，因爲瀏覽器要做二次請求。還有就是要注意，在第一次的請求作用域(request作用域)內的bean對於第二次請求是不可見的。
理解了上面描述的區別也就知道了什麼時候該選用logic:forward標籤什麼時候該選用logic:redirect標籤了。logic: forward標籤完成PageContext.forward()或HttpServletResponse.sendRedirect()，如何選擇由控制器決定。logic:redirect標籤完成HttpServletResponse.sendRedirect()。
在使用logic:redirect標籤時我們可以向使用html:link一樣構造baseurl和query參數。如果您感興趣可以參考html:link標籤。
總結
這篇指南的背景是Struts-1.2.9，其中的所有的代碼示例也都是在這個版本下調試通過的。目前Struts仍然在快速的發展中，但是從開發者應用的角度來講還是比較穩定的。因此我有理由相信其中的代碼示例也可以很好的運行在其它的版本之上。最後希望這篇指南能夠讓您心情愉快！
- 圖解 Tomcat 體系結構
- 使用Log4j進行日誌記錄
- Struts的官方文檔
- Struts的用戶指南
- cookie spec，這是關於Cookie最的全面的說明。
- HTML元素