Struts标签-html

转载 2007年10月12日 18:45:00
struts标签——html
2007-05-23 14:52

html:base

虽然这里的标题是html:base标签,但是这里也是这篇指南要介绍的第一个Struts html标签。因此我想在这里从整体上简单的介绍一下,最后给出一个对照表。其中的绝大多数标签就不一一介绍了,要介绍的也不会在这里介绍,而是将其独立出来以显重要性。

从用户处收集数据是动态web应用非常重要的一个方面,因此构建输入表单也就自然而然的成为struts框架的一个重要内容。Struts html标签库含有创建Struts输入表单的标签,和其它标签库(bean、logic、nested和tiles)中的标签一起协作就可以产生基于html的用户界面。

下面的对照表会使您对Struts html标签库有一个整体的印象:

 

图示 1. Struts HTML标签和HTML元素对照表
Struts HTML标签和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类型的域,如下:

   
                   
   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>

 

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

 

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兼容的形式输出。

 

Struts2标签<1>-HTML标签与struts2标签区别

一)struts2中的HTML标签与用原始的hteml标签哪个更好?有什么区别?为什么要使用上struts2标签? 1)应该根据实际情况的选取,当你的标签中出现了action返回的参数,选用stru...
  • xiu2016
  • xiu2016
  • 2016年10月14日 14:08
  • 1159

struts1的html详细用法示例

标记可以说是Struts所有标记中最简单的了。它简单的在页面开始处和结尾处产生一个的标记。在Struts1.1以前的版本中,该标记有一个locale属性。如下所示:   该属性的作用是读取...
  • wutongyu0123wutongyu
  • wutongyu0123wutongyu
  • 2015年10月06日 21:30
  • 6139

struts标签+jstl标签之国际化实例

Struts提供了国际化的功能,对于一个面向各国的系统来说,是非常有帮助的。只需要提供每个国家的语言资源包,配置后即可使用。       下面来用一个登录实例来演示一下Struts的国际化配置和显...
  • xiaoxian8023
  • xiaoxian8023
  • 2013年09月18日 09:34
  • 4096

Struts标签-html标签

图示 1. Struts HTML标签和HTML元素对照表 html:cancel html:cancel标签生成一个取消按钮。当点击该按钮后action servlet会绕过相应...
  • janefir
  • janefir
  • 2013年12月06日 11:52
  • 261

Struts1 的html标签的详细讲解与使用

标签 用来创建表单。必须包含一个action属性,否则JSP会抛出一个异常.  常用的属性有以下几个: action:指定用户提交的组件由那个组件方法来处理 method:指定表单提交的方式是post...
  • lycyl
  • lycyl
  • 2015年08月14日 18:03
  • 2025

Struts2标签以及国际化

【参考资料】《java EE技术实验教程》 韩珊珊、王春平编著,清华大学出版社 这里action的有关内容不再赘述。 首先,做一个注册页面,一个注册失败的页面,一个注册成功的页面。注册页面...
  • u013063099
  • u013063099
  • 2017年03月16日 09:14
  • 614

Struts标签入门

Struts标签入门 基本概述     Struts 是 Apache Jakarta 的一个著名的开源项目,目标是为构建基于 Java 的 web 应用程序提供一个框架。Struts 提...
  • q547550831
  • q547550831
  • 2016年01月26日 12:50
  • 1600

struts的html标签库

  • youren_zt
  • youren_zt
  • 2016年08月07日 18:01
  • 153

struts1.2中表单标签的应用---(form及text使用)源码解析

一、以text标签为例 1.配置 web.xml中 /html /WEB-INF/struts-html.tld 2.jsp中的使用 *规格...
  • honghailiang888
  • honghailiang888
  • 2016年10月10日 16:20
  • 434

Struts2标签使用原理解疑

在笔者下载的Struts2的包中,读者可以在/lib下找到struts2-core-2.0.11.1.jar包,解压该包在其根目录下的 /META-INF文件夹下可以看到一个名字为“struts-ta...
  • Baple
  • Baple
  • 2013年11月27日 13:04
  • 1150
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:Struts标签-html
举报原因:
原因补充:

(最多只允许输入30个字)