Struts
标签指南
您使用过旅游指南吗?它总是能让我们快速的找到目的地。我对此有深刻的印象,希望这篇指南也能使您快速的完成Struts标签相关的任务。我深入细致的总结了日常使用Struts的一些经验,感觉Struts标签的用途非常广泛并且功能强大,但是学起来还是比较费时间的。我认为学习Struts标签最好的方式就是参考良好的示例,幸运的是这些示例您可以在下面找到。
关键词:
apache jakarta,struts,bean,html,logic,tag,tags, cookie,define,header,include,message,page,parameter,resource,size,write, base,button,cancel,checkbox,errors,file,form,frame,hidden,html,image,img, javascript,link,messages,multibox,option,options,optionsCollection,password, radio,reset,rewrite,select,submit,text,textarea,xhtml, empty,equal,forward,greaterEqual,greaterThan,iterate,lessEqual,lessThan, match,messagesNotPresent,messagesPresent,notEmpty,notEqual,notMatch,notPresent, present,redirect,nested
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标签库有一个整体的印象:
图示 1. 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类型的域,如下:
<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兼容的形式输出。
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的示例的对象引用关系和部分代码:
图示 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-->
王微
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仍然在快速的发展中,但是从开发者应用的角度来讲还是比较稳定的。因此我有理由相信其中的代码示例也可以很好的运行在其它的版本之上。最后希望这篇指南能够让您心情愉快!
Struts
提供了五个标签库,即:
HTML
、
Bean
、
Logic
、
Template
和
Nested
。
标签库
|
说明
|
HTML
标签
|
用来创建能够和
Struts
框架和其他相应的
HTML
标签交互的
HTML
输入表单
|
Bean
标签
|
在访问
JavaBeans
及其属性,以及定义一个新的
bean
时使用
|
Logic
标签
|
管理条件产生的输出和对象集产生的循环
|
Template
标签
|
随着
Tiles
框架包的出现,此标记已开始减少使用
|
Nested
标签
|
增强对其他的
Struts
标签的嵌套使用的能力
|
标签的公共特征
使用固定属性名称的
Struts
标签:
属性
|
说明
|
id
|
命名自定义标签创建时的脚本变量名。
|
name
|
指出关键字值,在该关键字下可以找到一个存在的
bean
。如果给出了
scope
属性,则仅仅在
scope
中查找。否则,根据标准的顺序在各种
scope
中查找:
(page, request, session, or application)
。
|
property
|
指出
bean
中的某个属性,可以在其中检索值。如果没有标明,则使用对象本身的值。
|
scope
|
定义了
Bean
在哪个范围
(page, request, session, or application)
中被查找。如果没有标明按顺序查找。脚本变量
(
见
id)
将在相同的范围中创建。
|
Struts
标签也支持嵌套引用,例如:
Property="foo.bar.baz" 这相当于进行下面的调用: getFoo().getBar().getBaz() ; 或者做为 setter : getFoo().getBar().setBaz(value) ; |
虽然
Struts
标签的设计原意是为了避免使用
scriptlet
,
scriptlet
的表达式还能够提供给所有的
Struts
标签使用。但请确保使用完整的表达式
:
错误: <html:link href="'<%= "/" + name %>/index.jsp>'> 正确: <html:link href="'<%= "/" + name + "/index.jsp" %>'> // 表达式必须提供整个属性值 |
- <html>标签
它有两个属性:locale和xhtml,两者都不是必需的。
<html:html locale=/"true/"> 此行代码解析后: <html lang=/"en/"> |
- 说明:生成的结果取决于Struts应用程序所位于的服务器的locale。如果你将应用程序部署到一个不同locale的服务器,你不需要改变代码,Locale会自动调整。
- <base>标签:表示所包含页面的绝对位置。这个标签只有内嵌在head标签中才有效。
<html:base/> 此行代码解析后: <base href=/"http://www.mymain.com/myStrutsApp/testing.jsp/"> |
- <img>标签
最重要的属性page:图象文件的路径,前面必须带有一个斜线。
其它属性:heignt、width、alt。
<html:img page=/"/logo.gif/" height=/"50/" width=/"200/" alt=/"Web Logo/"/>
|
- <link>标签
<html:link page=/"/index.html/">Click demo</html:link> 此行代码解析后: <a href=/"/index.html/">Click demo</a> |
- <errors>标签:通过一个简单的<html:errors/>标签,你就可以在一个JSP页面上显示完全自定义的错误信息。功能超强大!!
说明:这个标签在Request对象的属性集合中查找reserved key。如果它找到一个reserved key,它就假设这个key是一个String、或是一个String数组
(它包含在模块的MessageResources中查找的message keys)、或是类型为org.apache.struts.action.ActionErrors的一个对象。
如果在应用程序资源中存在相应的信息,那么就可以用下面这些可选的message keys:
errors.header or errors.prefix:相应的信息在错误信息的单独列表前显示。
errors.footer or errors.suffix:相应的信息在错误信息的单独列表后显示。 - <form>标签系列
使用<form>标签时必须遵循一些规则:
标签中必须包含一个
action
属性,它是这个标签中唯一必需的属性。如果不具备该属性则
JSP
页面会抛出一个异常。之后你必须给这个
action
属性指定一个有效值。一个有效值是指应用程序的
Struts
配置文件中元素里的任何一个子元素的访问路径。而且相应的元素中必须有一个
name
属性,它的值是
form bean
的名称。
<html:form action=/"/login/" > 如果你有上述一个标签 ,那么你的 Struts 配置文件的元素中必须有一个如下显示为粗体的元素: <action-mappings> <action path=/"/login/" type=/"com.javapro.struts.LoginAction/" name=/"loginForm/" scope=/"request/" input=/"/login.jsp/"> <forward name=/"success/" path=/"/mainMenu.jsp/"/> </action> . . . </action-mappings> // 这就是说一个 form 标签是和 form bean 相关联的。 |
任何包含在
<form>
中用来接收用户输入的标签(
<text>
、
<password>
、
<hidden>
、
<textarea>
、
<radio>
、
<checkbox>
、
<select>
)必须在相关的
form bean
中有一个指定的属性值。比如,如果你有一个属性值被指定为
“username”
的
<text>
标签,那么相关的
form bean
中也必须有一个名为
“username”
的属性。输入
<text>
标签中的值会被用于生成
form bean
的
userName
属性。
<form>
标签还有一些不是必须但很有用的
“
次要
”
属性。
比如,你可以用 focus 属性来生成 JavaScript ,它会 “ 定焦 ” ( focus )到该 form 所包含的一个元素上。使用 focus 属性时你需要给它指定元素的名称。
比如,你可以用 focus 属性来生成 JavaScript ,它会 “ 定焦 ” ( focus )到该 form 所包含的一个元素上。使用 focus 属性时你需要给它指定元素的名称。
<body> <html:form action=/"/login/" focus=/"password/"> User Name: <html:text property=/"userName/"/> <br>Password: <html:text property=/"password/"/> <br><html:submit/> </html:form> </body> 代码解析后: <body> <form name=/"loginForm/" method=/"post/" action=/"/myStrutsApp/login.do/"> User Name: <input type=/"text/" name=/"userName/" value=/"/"> <br>Password: <input type=/"text/" name=/"password/" value=/"/"> <br><input type=/"submit/" value=/"Submit/"> </form> <script language=/"JavaScript/" type=/"text/javascript/"> <!-- if (document.forms[/"loginForm/"].elements[/"password/"].type != /"hidden/") document.forms[/"loginForm/"].elements[/"password/"].focus() // --> </script> </body> |
有没有看到这个标签库是如何建立
JavaScript
来定焦到
password
元素上的
?
这也是该库让人着迷的地方之一。你不用担心如何在客户端进行编程,它会帮你自动生成。
还可以看到, <form> 标签中 method 属性的缺省值是 POST 。
<text> 标签、 <hidden> 标签、 <textarea> 标签、 <radio> 标签、 <checkbox> 标签、 <submit> 标签、 <reset> 标签:
都有一个 property 属性,最后会被转换成 HTML 中的 name 属性,当然还有 name 和 value 属性。
<password> 标签
还可以看到, <form> 标签中 method 属性的缺省值是 POST 。
<text> 标签、 <hidden> 标签、 <textarea> 标签、 <radio> 标签、 <checkbox> 标签、 <submit> 标签、 <reset> 标签:
都有一个 property 属性,最后会被转换成 HTML 中的 name 属性,当然还有 name 和 value 属性。
<password> 标签
<html:password property=/"password/" redisplay=/"false/"/>
|
该标签中的一个很重要的属性是
"redisplay"
,它用于重新显示以前输入到这个区域中的值。该属性的缺省值为
true
。然而,为了使
password
不能被重新显示,你或许希望将该属性的值设为
false
。
<select> 标签和 <option> 标签:
<select> 标签和 <option> 标签:
<html:select property=/"color/" size=/"3/"> <html:option value=/"r/">red</html:option> <html:option value= /"g/">green</html:option> <html:option value= /"b/">blue</html:option> </html:select> |
遗补
:
1.)<html:link>
标签
forward
属性:链接到一个
global forward
上;
action
属性:链接到一个
action mapping
上;
href 属性:这个链接会转发给控制器,由控制器做决定; page 属性:一个相对的链接。
用 page 属性链接到 action 上:
href 属性:这个链接会转发给控制器,由控制器做决定; page 属性:一个相对的链接。
用 page 属性链接到 action 上:
<html:link page="/html-link.do"> Linking with the page attribute. </html:link> |
注意,上面的代码中你不必指定 web 的关联。相反的,如果你使用 href 属性,你就必须像下面所示指出 web 的关联 ( 这里的关联就是 struts-exercise) :
<html:link href="/struts-exercise-taglib/html-link.do"> Using Href </html:link> |
很明显,当你在相同的 web 应用程序中做链接是,它比 page 属性更加好。你也能用 href 在不同的服务器上创建链接:
<html:link href="http://otherserver/strutsTut/html-link.do"> Using Href </html:link> |
另一种链接到 html-link.do 的方法是用 action 属性:
<html:link action="/html-link"> Using Action attribute </html:link> |
你也可以以硬编码的方式使用参数:
<html:link page="/htmllink.do?doubleProp=3.3&longProp=32"> Double and long via hard coded changes </html:link> |
或者使用 paramId, paramName, and paramProperty 属性:
<html:link page="/html-link.do" paramId="booleanProperty" paramName="testbean" paramProperty="nested.booleanProperty"> Boolean via paramId, paramName, and paramValue </html:link> |
解析后的代码:
<a href="/struts-exercise-taglib/html-link.do?booleanProperty=false"> Boolean via paramId, paramName, and paramValue </a> |
另外,还能使用带 name 属性的 Map 来实现传递多个参数:
<% java.util.HashMap newValues = new java.util.HashMap(); newValues.put("floatProperty", new Float(444.0)); newValues.put("intProperty", new Integer(555)); newValues.put("stringArray", new String[] { "Value 1", "Value 2", "Value 3" }); pageContext.setAttribute("newValues", newValues); %> ... <html:link action="/html-link" name="newValues"> Float, int, and stringArray via name (Map) </html:link> |
你也能够链接到 Map 类型的 action 上,上面的代码解析后的结果:
<html:messages property="property2" message="true" id="msg" header="messages.header" footer="messages.footer"> <tr><td><%= pageContext.getAttribute("msg") %></td></tr> </html:messages> |
2.) select
和
option
标签
<html:select> 的属性: property -与 ActionForm 中的某个属性对应; size -显示 option 的数目; multiple -默认为 fales ,表示不能多选,当设定为 true 时, property 对应的 ActionForm 的属性必须为数组。
<html:select property="name" size=6 multiple="true">
<html:option> 的属性: key 、 local 、 bundle -指定 Resource Bundle 中的内容。
例如 <html:option value="color1">Orange</html:option>
<html:option value="color1" bundle="htmlselect.Colors" key="htmlselect.red"/>
它和配置文件中的 <message-resources> 元素的 key 属性匹配 --> <message-resource parmeter="HtmlSelectColors" key="htmlselect.Colors"/>
<message-resource> 中配置的资源文件为 HtmlSelectColors.properties ,相关内容为 htmlselect.red=RED
<html:options> 标签,提供了一组 <option> 元素,在 <html:select> 元素中可以包含多个 <html:options> 元素。非常灵活,可以取得集合或数组中的值。
例 1 <html:options collection="coll" property="value" labelProperty="label" /> 这指在 coll 的集合中存放了 options , value 指实际能被提交的值, label 是显示给用户的值。
例 2 <html:options property="value" labelProperty="label" /> collection 属性不被指定时,将使用表单相关的 form bean , form bean 中 value 属性存放 option value , label 属性值显示给用户。
例 3 <html:options name="valueBean" property="values" labelName="labelsBean" labelProperty="labels" /> 这个意思是 value 值存放在名为 valueBean 的 bean 的 vlaues 属性中,它是一个 collection ; label 值也是同样的意思。
<html:optionsCollection> 标签,和 <html:options> 的用法很相似。
例如 <html:select property="custId"><html:optionsCollection property="customers" label="name" value="custId" /></html:select>
这个标签和 org.apache.structs.util.LabelValueBean 结合的很好,如果把 label 和 value 都放到这个对象中,可以很简单的这样应用:
<html:select property="custId"><html:optionsCollection property="customers" /></html:select>
<html:select> 的属性: property -与 ActionForm 中的某个属性对应; size -显示 option 的数目; multiple -默认为 fales ,表示不能多选,当设定为 true 时, property 对应的 ActionForm 的属性必须为数组。
<html:select property="name" size=6 multiple="true">
<html:option> 的属性: key 、 local 、 bundle -指定 Resource Bundle 中的内容。
例如 <html:option value="color1">Orange</html:option>
<html:option value="color1" bundle="htmlselect.Colors" key="htmlselect.red"/>
它和配置文件中的 <message-resources> 元素的 key 属性匹配 --> <message-resource parmeter="HtmlSelectColors" key="htmlselect.Colors"/>
<message-resource> 中配置的资源文件为 HtmlSelectColors.properties ,相关内容为 htmlselect.red=RED
<html:options> 标签,提供了一组 <option> 元素,在 <html:select> 元素中可以包含多个 <html:options> 元素。非常灵活,可以取得集合或数组中的值。
例 1 <html:options collection="coll" property="value" labelProperty="label" /> 这指在 coll 的集合中存放了 options , value 指实际能被提交的值, label 是显示给用户的值。
例 2 <html:options property="value" labelProperty="label" /> collection 属性不被指定时,将使用表单相关的 form bean , form bean 中 value 属性存放 option value , label 属性值显示给用户。
例 3 <html:options name="valueBean" property="values" labelName="labelsBean" labelProperty="labels" /> 这个意思是 value 值存放在名为 valueBean 的 bean 的 vlaues 属性中,它是一个 collection ; label 值也是同样的意思。
<html:optionsCollection> 标签,和 <html:options> 的用法很相似。
例如 <html:select property="custId"><html:optionsCollection property="customers" label="name" value="custId" /></html:select>
这个标签和 org.apache.structs.util.LabelValueBean 结合的很好,如果把 label 和 value 都放到这个对象中,可以很简单的这样应用:
<html:select property="custId"><html:optionsCollection property="customers" /></html:select>
Bean
标签库
此标签库和
Java Bean
有很强的关联性,设计的本意是要在
JSP
和
JavaBean
之间提供一个接口。
Struts
提供了一套小巧有用的标签库来操纵
JavaBean
和相关的对象:
cookie
、
header
、
parameter
、
define
、
write
、
message
、
include
、
page
、
resource
、
size
、
struts
。
1.
bean:cookie
、
bean:header
、
bean:parameter
这三个标签用来重新得到 cookie, request header 和 request parameter 。
bean:header 和 bean:parameter 标签定义了一个字符串; bean:cookie 标签定义了一个 Cookie 对象。你可以使用 value 属性做为默认值。如果找不到指定的值,且默认值没有设定的话,会抛出一个 request time 异常。如果你期望返回多个值的话,可把 multiple 属性设为 true 。
这三个标签用来重新得到 cookie, request header 和 request parameter 。
bean:header 和 bean:parameter 标签定义了一个字符串; bean:cookie 标签定义了一个 Cookie 对象。你可以使用 value 属性做为默认值。如果找不到指定的值,且默认值没有设定的话,会抛出一个 request time 异常。如果你期望返回多个值的话,可把 multiple 属性设为 true 。
<bean:cookie id="sessionID" name="JSESSIONID" value="JSESSIONID-ISUNDEFINED"/>
//
这段代码定义了一个名为
sessionID
的脚本变量,如果找不到一个名为
JSESSIONID
的
cookie
,那
sessionID
//
的值就被设置为
JSESSIONID-ISUNDEFINED
。
|
2.
下面代码会输出一些
Cookie
对象的一些属性:
<jsp:getProperty name="sessionID " property="comment"/> … <jsp:getProperty name="sessionID" property="domain"/> … <jsp:getProperty name="sessionID" property="maxAge"/> … <jsp:getProperty name="sessionID" property="path"/> … <jsp:getProperty name="sessionID" property="value"/> … <jsp:getProperty name="sessionID" property="version"/> … |
3.
下面是在
request
中输出所有
header
的例子:
<% java.util.Enumeration names =((HttpServletRequest) request).getHeaderNames(); %> … <% while (names.hasMoreElements()) { String name = (String) names.nextElement(); %> <bean:header id="head" name="<%= name %>"/> … <%= name %> … <%= head %> … <% } %> |
4.
下面是
parameter
的例子:
<bean:parameter id="param1" name="param1"/> <bean:parameter id="param2" name="param2" multiple="true"/> // 此处定义了一个 param2[] 。 <bean:parameter id="param3" name="param3" value="UNKNOWN VALUE"/> |
5.
于其它标签结合使用:
<bean:header id="browser" name="User-Agent"/> <P>You are viewing this page with: <bean:write name="browser"/></P> ---------------------------------------------------------------------- <bean:cookie id="username" name="UserName" scope="session" value="New User" /> <P>Welcome <bean:write name="username" property="value"/!</P> // 根据 cookie 创建一个新的 Bean ,如果用户名称已经存储在 cookie 中,它就不显示为一个新用户。 |
7. bean:define
:有三个用途。一是定义新字符串常量:
<bean:define id="foo" value="This is a new String"/> <bean:define id="bar" value='<%= "Hello, " + user.getName() %>'/> <bean:define id="last" scope="session" value='<%= request.getRequestURI() %>'/> |
6.
二是复制一个现有的
bean
给新的
bean
:
<bean:define id="foo" name="bar"/> <bean:define id="baz" name="bop" type="com.mycompany.MyClass"/> // 定义脚本变量的类型,默认为 Object |
7.
三是复制一个现有的
bean
的属性给新的
bean
:
<bean:define id="bop" name="user" property="role[3].name"/> <bean:define id="foo" name="bar" property="baz" scope="request" toScope="session"/> //toScope 属性指新 bean 的 scope ,默认为 page |
8.
上段代码的意思是把名为
bar
的
bean
的
baz
属性赋值给
foo
,
foo
的类型为
String(
默认
)
。
9.
bean:include
这个标签和 bean:include 标签和相似,不同点就是它定义了一个可以复用的脚本变量。用 id 属性命名一个新的脚本变量,还支持 forward 、 href 、 page 和 transaction. 属性,和 html:link 中的属性意义一样。
这个标签和 bean:include 标签和相似,不同点就是它定义了一个可以复用的脚本变量。用 id 属性命名一个新的脚本变量,还支持 forward 、 href 、 page 和 transaction. 属性,和 html:link 中的属性意义一样。
<bean:include id="footerSpacer" page="/long/path/footerSpacer.jsp"/> 然后你能够在多个地方 (scope 为 page) 调用: <bean:write name="footerSpacer" /> |
10.
bean:message
用来实现对国际化的支持的一个标签,配合 java.util 数据包中定义的 Locale 和 ResourceBundle 类来完成这个任务,用 java.text.MessageFormat 类配置消息的格式。
首先要指定资源文件的名称。这个文件会包含用默认语言编写的在程序中会出现的所有消息,这些消息以 “ 关键字 - 值 ” 的形式存储。文件需要存储在类路径下,路径要作为初始化参数传送给 ActionServlet 。
实现国际化的规定:所有的资源文件必须都存储在基本资源文件所在的目录中。基本资源文件包含的是用默认地区语言 - 本地语言编写的消息。如果基本资源文件的名称是 ApplicationResources.properties ,那么用其他特定语言编写的资源文件的名称就应该是 ApplicationResources_xx.properties(xx 为 ISO 编码,如英语是 en) 。因此这些文件应包含相同的关键字,但关键字的值是用特定语言编写的。
然后, ActionServlet 的区域初始化参数必须与一个 true 值一起传送,这样 ActionServlet 就会在用户会话中的 Action.LOCALE_KEY 关键字下存储一个特定用户计算机的区域对象。现在可以运行一个国际化的 web 站点,它可以根据用户计算机上的设置的区域自动以相应的语言显示。
使用特定的字符串来替换部分消息:
用来实现对国际化的支持的一个标签,配合 java.util 数据包中定义的 Locale 和 ResourceBundle 类来完成这个任务,用 java.text.MessageFormat 类配置消息的格式。
首先要指定资源文件的名称。这个文件会包含用默认语言编写的在程序中会出现的所有消息,这些消息以 “ 关键字 - 值 ” 的形式存储。文件需要存储在类路径下,路径要作为初始化参数传送给 ActionServlet 。
实现国际化的规定:所有的资源文件必须都存储在基本资源文件所在的目录中。基本资源文件包含的是用默认地区语言 - 本地语言编写的消息。如果基本资源文件的名称是 ApplicationResources.properties ,那么用其他特定语言编写的资源文件的名称就应该是 ApplicationResources_xx.properties(xx 为 ISO 编码,如英语是 en) 。因此这些文件应包含相同的关键字,但关键字的值是用特定语言编写的。
然后, ActionServlet 的区域初始化参数必须与一个 true 值一起传送,这样 ActionServlet 就会在用户会话中的 Action.LOCALE_KEY 关键字下存储一个特定用户计算机的区域对象。现在可以运行一个国际化的 web 站点,它可以根据用户计算机上的设置的区域自动以相应的语言显示。
使用特定的字符串来替换部分消息:
在资源文件中的定义:
info.myKey = The numbers entered are {0},{1},{2},{3} 标记的使用: <bean:message key="info.myKey" arg0="5" arg1="6" arg2="7" arg3="8"/> Jsp 页面的显示: The numbers entered are 5,6,7,8 // 最多支持 4 个参数 |
11.
bean:page
:把
Jsp
中的内部对象做为脚本变量。
<bean:page id="requestObj" property="request"/>
|
12.
bean:resource
:获得应用程序的资源,这个资源可以是一个
String
或从
java.io.InputStream
中读入。使用
ServletContext.getResource()ServletContext.getResourceAsStream()
方法检索
web
应用中的资源,如果在检索资源时发生问题,就会产生一个
ruquest time
异常。
<bean:resource id="webxml" name="/WEB-INF/web.xml"/>
|
13.
使用
input
属性时,资源会做为一个
InputStream
,如果不指定就被当成一个
String
。
14.
bean:size
:得到存储在
array
、
collection
或
map
中的数目,类型为
java.lang.Integer
。
<bean:size id="count" name="employees" />
|
15.
bean:struts
:复制
Struct
对象
(
三种类型
)
给新的
bean
,
scope
为
page
。
<bean:struts id="form" formBean="CustomerForm"/> <bean:struts id="fwd" forward="success"/> <bean:struts id="map" mapping="/saveCustomer"/> |
16.
bean:write
:以字符串形式输出
bean
的属性值。
filter 属性:设为 true 时,将 HTML 保留字转换为实体 ("<" 转换为 <);
ignore 属性:如果对象不存在,不会抛出异常。
filter 属性:设为 true 时,将 HTML 保留字转换为实体 ("<" 转换为 <);
ignore 属性:如果对象不存在,不会抛出异常。
<bean:write name="userRegistration" property="email" scope="request"/>
|