Struts标签(大全)二

回页首

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            property="persons"/>            <html:select  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  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  property="person.id" size="1">            <html:optionsCollection  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  property="personIds"            multiple="true" size="2">            <html:options property="ids" labelProperty="names"/>            </html:select>

回页首

html:check标签生成一个checkbox。这里的value值可以是true，yes或on。如果您要提交其它的值(如某种形式的标识)应该考虑使用html:multibox标签。

注意:为了正确的处理没有选中的checkbox您必须在reset()中设置对应的属性为false。

下面的代码示例了html:checkbox标签的用法，其中CheckboxForm中声明了三个boolean类型的域，如下：

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

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

如果选中后被提交则相应的属性的值为true。

回页首

html:radio标签生成一个radio。主要的用法有两种，下面我们通过代码来示例。

下面的代码示例了html:radio标签的一般用法，如果被提交则选中的radio的value值将被提交到radioForm中的id中。

<html:radio  property="id" value="00001">            One            </html:radio>            <html:radio  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  property="persons">            <logic:iterate   property="persons">            <html:radio idName="person" property="id" value="id">            <bean:write  property="name"/>            </html:radio>            </logic:iterate>            </logic:notEmpty>

回页首

html:multibox标签生成多个checkbox。当您要使用大量的checkbox时使用这个标签非常方便，可以使您避免在ActionForm中声明大量的boolean类型的变量，带之以一个数组就行了。

注意:为了正确的处理没有选中的checkbox您必须在reset()中设置数组的长度为0。

下面的代码示例了html:multibox标签的一般用法，如果被提交则选中的所有checkbox的value值将被提交到multiboxForm中的selectedItems中，这是一个String[]数组。

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

下面的代码示例了html:multibox标签的典型用法：

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

回页首

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"  property="paramSingleMap">            多参单值            </html:link><br/>            <html:link page="/link.do"  property="paramMultiMap">            单参多值            </html:link><br/>            <html:link page="/link.do"  property="paramSMMap">            混合            </html:link>

下面的代码示例了html:link标签的indexed属性和indexId属性的用法，这两个属性只有html:link标签嵌套在logic:iterate标签中时才可用。

<logic:iterate   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: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 >            <li><bean:write /></li>            </html:messages>            </ul>            </logic:messagesPresent>            <br/>            <logic:messagesPresent>            <ul>            <html:messages  property="property4">            <li><bean:write /></li>            </html:messages>            </ul>            </logic:messagesPresent>

图示 2. 上面的两段代码示例运行结果相同，如下所示：

回页首

html:javascript标签生成用于校验的javascript脚本代码。

下面的代码片段示例了html:javascript标签的基本用法，其中formName属性的值是在validation.xml文件的 <formset>中定义的form的名称。有一点值得注意的是在确定<formset>时要使用合适的language属性 值。

<html:javascript formName="dataForm"/>

回页首

html:xhtml标签在页面中一出现就是告诉该页的所有其它的Struts html标签以XHTML1.0兼容的形式输出。这和将html:html标签的xhtml属性值指定为true有些类似。如果上述情况都没有出现， Struts html标签将以html4.01兼容的形式输出。

回页首

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的示例的对象引用关系和部分代码：

图示 3. logic:iterate中对象的引用关系

图中的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-->王微

回页首

如果指定的值出现该标签就会创建其标签体内的内容。该标签用于以下情况：

• 检查具有指定名称的cookie是否出现。
• 检查具有指定名称的header是否出现。
• 检查具有指定名称的JSP Bean是否出现 或 检查具有指定名称的JSP Bean中的property属性是否出现。
• 检查request中指定名称的参数是否出现。
• 检查当前的认证用户是否与指定的安全角色相关联。
• 检查当前认证的主体是否具有指定的名字。

下面的代码示例了logic:present标签检查具有指定名称User-Agent的header是否出现：

<logic:present header="User-Agent">            您的浏览器是<bean:header  />            <bean:write />。<br/>            </logic:present>

logic:notPresent标签的应用正好和logic:present标签相反。

回页首

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 >            <li><bean:write /></li>            </html:messages>            </ul>            </logic:messagesPresent>

标签logic:messagesNotPresent的应用正好和logic:messagesPresent的应用相反。

回页首

logic:empty标签是用来判断是否为空的。如果为空，该标签体中嵌入的内容就会被处理。该标签用于以下情况：

• 当Java对象为null时
• 当String对象为""时
• 当java.util.Collection对象中的isEmpty()返回true时
• 当java.util.Map对象中的isEmpty()返回true时

下面的代码示例了logic:empty标签判断集合persons是否为空：

<logic:empty  property = "persons">            <div>集合persons为空!</div>            </logic:empty>

logic:notEmpty标签的应用正好和logic:empty标签相反。

回页首

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: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属性值相等。

回页首

我觉得将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，其中的所有的代码示例也都是在这个版本下调试通过的。