📄 struts标签.htm
字号:
</PRE>
<P>下面是对应的action中的代码：</P><PRE>if(isCancelled(request)){
//action被取消时要做的事情写在这里
return mapping.findForward("cancel");
}else{
//action没有被取消时要做的事情写在这里
return mapping.findForward("success");
}
</PRE>
<DIV><A title=回页首
href="http://www.solol.org/technologic/java/j-struts/#top">回页首</A></DIV>
<H2><A name=d3e409>html:select</A></H2>
<P>html:select标签生成一个select元素。是单选还是多选取决于该标签的multiple属性。如果指定了multiple="true"则为多选，此时对应的属性应该是一个数组。如果没有指定multiple="true"则为单选，此时对应的属性应该是标量。</P>
<P>注意：为了正确的处理没有做任何的选择的情况，在ActionForm中的reset()方法中必须将标量属性设置为默认值而将数组的长度置为0。</P>
<P>另外的一个重要问题就是struts如何生成option元素了，这个任务struts交给了html:option、html:options和html:optionsCollection三个标签。</P>
<P>html:option标签</P>
<P>html:option标签生成一个HTML的option元素。该标签必须嵌在html:select标签中。它的显示文本来自其标签体，也可以来自于资源文件。它的value属性用来指定什么值将要被提交。</P><PRE><html:option value="one">one</html:option>
<html:option value="two">two</html:option>
</PRE>
<P>html:options标签</P>
<P>html:options标签生成多个HTML的option元素。该标签必须嵌在html:select标签中。而且工作方式有些特殊，它的name与property属性和其它标签的name与property属性意义不一致，让我们具体看一下它的工作方式。</P>
<UL>
<LI>指定collection属性
<LI>没有指定collection属性 </LI></UL>
<P>指定collection属性</P>
<P>让我通过示例来介绍在指定collection属性时该标签的工作方式，首先要说明selectForm中的persons和listForm中的persons完全一致。请参见bean:define标签。</P>
<P>下面的代码先利用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值。</P>
<P>当这个select提交时所选择的值将被提交到selectForm(name="selectForm")中的person对象(这是在SelectForm中声明的一个Person类型的域专门用来接收提交的值)的id属性中(property="person.id")。</P><PRE><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>
</PRE>
<P>没有指定collection属性</P>
<P>让我通过示例来介绍没有指定collection属性时该标签的工作方式，先来看看ids和names的定义：</P><PRE> private List<String> ids = null;
private List<String> names = null;
</PRE>
<P>上面的代码来自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的值会被丢掉。</P>
<P>当这个select提交时所选择的值将被提交到selectForm(name="selectForm")中的person对象(这是在SelectForm中声明的一个Person类型的域专门用来接收提交的值)的id属性中(property="person.id")。</P><PRE><html:select name="selectForm" property="person.id" size="1">
<html:options property="ids" labelProperty="names"/>
</html:select>
</PRE>
<P>html:optionsCollection标签</P>
<P>html:optionsCollection标签生成多个HTML的option元素。该标签必须嵌在html:select标签中。它的功能和html:options标签的相同，但是它的name与property属性和其它标签的name与property属性意义一致，理解起来比较自然。</P>
<P>让我通过示例来介绍html:optionsCollection标签的用法。首先依据name="selectForm"和property="persons"取到selectForm中的persons列表，然后将列表中的对象(Person类型)的id属性作为option元素的value值(value="id")，将列表中的对象(Person类型)的name属性作为option元素的label值(label="name")。</P><PRE><html:select name="selectForm" property="person.id" size="1">
<html:optionsCollection name="selectForm" property="persons" label="name" value="id"/>
</html:select>
</PRE>
<P>下面是一个多选的示例，虽然示例中使用了html:options标签，但是html:option和html:optionsCollection也能够用来多选。而且您还必须意识到html:option、html:options和html:optionsCollection这三个标签可以同时使用。代码中的personIds是SelectForm中声明的一个String[]类型的数组用来接收提交的多个值。</P><PRE><html:select name="selectForm" property="personIds" multiple="true" size="2">
<html:options property="ids" labelProperty="names"/>
</html:select>
</PRE>
<DIV><A title=回页首
href="http://www.solol.org/technologic/java/j-struts/#top">回页首</A></DIV>
<H2><A name=d3e504>html:checkbox</A></H2>
<P>html:check标签生成一个checkbox。这里的value值可以是true，yes或on。如果您要提交其它的值(如某种形式的标识)应该考虑使用html:multibox标签。</P>
<P>注意:为了正确的处理没有选中的checkbox您必须在reset()中设置对应的属性为false。</P>
<P>下面的代码示例了html:checkbox标签的用法，其中CheckboxForm中声明了三个boolean类型的域，如下：</P><PRE> <!-- 略掉了get方法(也可以是isXXX形式)和set方法 -->
private boolean one = false;
private boolean two = false;
private boolean three = false;
</PRE><PRE><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>
</PRE>
<P>如果选中后被提交则相应的属性的值为true。</P>
<DIV><A title=回页首
href="http://www.solol.org/technologic/java/j-struts/#top">回页首</A></DIV>
<H2><A name=d3e529>html:radio</A></H2>
<P>html:radio标签生成一个radio。主要的用法有两种，下面我们通过代码来示例。</P>
<P>下面的代码示例了html:radio标签的一般用法，如果被提交则选中的radio的value值将被提交到radioForm中的id中。</P><PRE><html:radio name="radioForm" property="id" value="00001">One</html:radio>
<html:radio name="radioForm" property="id" value="00002">Two</html:radio>
</PRE>
<P>下面的代码示例了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属性。
</P><PRE><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>
</PRE>
<DIV><A title=回页首
href="http://www.solol.org/technologic/java/j-struts/#top">回页首</A></DIV>
<H2><A name=d3e550>html:multibox</A></H2>
<P>html:multibox标签生成多个checkbox。当您要使用大量的checkbox时使用这个标签非常方便，可以使您避免在ActionForm中声明大量的boolean类型的变量，带之以一个数组就行了。</P>
<P>注意:为了正确的处理没有选中的checkbox您必须在reset()中设置数组的长度为0。</P>
<P>下面的代码示例了html:multibox标签的一般用法，如果被提交则选中的所有checkbox的value值将被提交到multiboxForm中的selectedItems中，这是一个String[]数组。</P><PRE><html:multibox name="multiboxForm" property="selectedItems" value="00001"/>
<html:multibox name="multiboxForm" property="selectedItems" value="00002"/>
</PRE>
<P>下面的代码示例了html:multibox标签的典型用法：</P><PRE><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>
</PRE>
<DIV><A title=回页首
href="http://www.solol.org/technologic/java/j-struts/#top">回页首</A></DIV>
<H2><A name=d3e576>html:link</A></H2>
<P>html:link标签生成一个锚点(<a>)元素。我从html:link标签如何构造基本url和如何构造query参数两个方面来介绍这个标签。</P>
<P>构造基本url是依据该标签的如下四个属性进行的，这四个属性一次只能出现一个。让我们看看它们：
<UL>
<LI>forward，指定一个全局ActionForward的名称。另外如果forward是module相关的则该forward必须指向一个action而不能是一个页面。
<LI>action，指定一个Action的名称。
<LI>href，struts会直接使用这个值而不会对其进行任何处理。
<LI>page，指定一个页面的路径，必须以/开始。 </LI></UL>
<P></P>
<P>构造query参数，下面列举了可能的形式，其中baseurl只是一个占位符：
<UL>
<LI>baseurl?p=00001(单参单值)
<LI>baseurl?p1=00001&p2=00002&p3=00003(多参单值)
<LI>baseurl?p=00001&p=00002&p=00003(单参多值)
<LI>baseurl?p1=00001&p2=00002&p=00001&p=00002&p=00003(混合)
</LI></UL>
<P></P>
<P>下面我们以代码示例来说明每一种html:link的用法，首先让我们花点时间看看相关action中的代码：</P><PRE><!-- 下面所有代码的数据都是在这里构造的 -->
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");
}
</PRE><PRE><!-- 这用来设置一个位置 -->
<html:link linkName="top"/>
<!-- 这用来定位到上面的那个位置 -->
<html:link page="/link.do" anchor="top">Go Top</html:link>
</PRE><PRE><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>
</PRE>
<P>下面的代码示例了html:link标签的indexed属性和indexId属性的用法，这两个属性只有html:link标签嵌套在logic:iterate标签中时才可用。</P><PRE><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"确定的，而该参数的值为元素在集合中的位置。
-->
</PRE>
<P>html:rewrite标签和html:link标签类似只是不生成锚点(<a>)，而是简单的输出字符串。</P>
<DIV><A title=回页首
href="http://www.solol.org/technologic/java/j-struts/#top">回页首</A></DIV>
<H2><A name=d3e643>html:errors</A></H2>
<P>html:errors标签和html:messages标签的功能相似，所以我们放到一起来介绍。</P>
<P>html:errors标签将由name属性指定的ActionMessages、ActionErrors、String和String[]直接输出到页面中。</P>
<P>html:messages标签将用由name属性(注意message属性值对它的影响)指定的ActionMessages、ActionErrors、String和String[]创建一个新的属性和scripting变量，使用id属性值作为名称。</P>
<P>html:errors标签和html:messages标签的property属性是用来为errors和messages分类的。我们可以给这两个标签指定property属性，以便只显示某一类的错误或消息。</P>
<P>在资源文件增加了如下的内容：</P><PRE># -- 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} .
</PRE>
<P>下面的代码示例了actionErrors的构造：</P><PRE>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;
}
</PRE>
<P>errors标签代码示例：</P><PRE><html:errors/>
<br/>
<html:errors property="property4"/>
</PRE>
<P>messages标签代码示例：</P><PRE><logic:messagesPresent>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -