Struts标签(大全)
2008-08-19 08:33
344 查看
Struts是ApacheJakarta的一个著名的开源项目,目标是为构建基于Java的web应用程序提供一个框架。
Struts提供了非常多的标签,依据功能和使用习惯的不同被分到了五个标签库中:
BeanTags:该标签库包含的标签可以用来创建bean、访问bean和访问bean的属性。同时提供了依据cookies、headers和parameters的值创建相关bean的能力。
HTMLTags:该标签库包含的标签可以用来创建Struts输入表单。
LogicTags:该标签库包含的标签可以用来进行逻辑判断、集合迭代和流程控制。
NestedTags:该标签库建立在前三个标签库的基础上,具有前三个标签库的所有功能,只是允许标签间的嵌套。
TilesTags:该标签库包含的标签可以用来创建tiles样式的页面。
这篇指南主要介绍前三个标签库中的标签。如果您对后两类标签也感兴趣可以查阅参考资料中的Struts的用户指南。
回页首
cookie最早是由Netscape公司提出来的,用来存储客户的少量状态信息。如果您对cookie的具体细节感兴趣可以查阅参考资料中的cookiespec。
bean:cookie标签取回请求中名称为name的cookie的值。如果没有指定multiple属性则依据刚取回的值创建一个Cookie类型的bean。如果指定了multiple属性则依据刚取回的值创建一个Cookie[]类型的数组。然后用id属性值将Cookie或Cookie[]绑定到page作用域中(这种绑定是为了其它标签能够使用该值),并创建对应的scripting变量(这种变量是为了JSP脚本能够使用该值)。
下面的代码片段示例了如何使用bean:cookie标签读取名为JSESSIONID的cookie的值,并且使用了两种方式进行了输出:
我们可以使用三种方式为新创建的属性和scripting变量赋值:
下面给出ListForm的代码片段以帮助您更好的理解,其中Person是一个只有id和name两个属性的简单bean:
下面的代码片段示例了logic:iterate标签如何使用bean:define标签创建的新属性values:
下面的代码片段示例了JSP脚本如何使用bean:define标签创建的新scripting变量values:
下面是我的浏览器发送的header的内容,这些内容和浏览器有关,因此您的浏览器发送的内容可能和下面列出的不同。不过这没有关系,因为要理解bean:header标签您只要对这些内容有一个大概的认识就足够了。
下面的代码片段示例了如何使用bean:header标签读取名为User-Agent的header的值,并且使用了两种方式进行了输出:
下面的代码片段示例了bean:include标签的用法,其中include.txt文件包含要include的内容,然后将这些内容输出:
bean:message标签有两种指定messagekey的方式,一是通过key属性直接指定;二是通过name和property属性间接的指定,其中messagekey是在messageresources文件中定义的。
我们可以在struts-config.xml文件中使用<message-resources>来设置messageresources文件。
为了介绍该标签我使用了三个messageresources文件,三个文件的名字分别为Resources.properties、Resources_en.properties和Resources_zh.properties。在struts-config.xml文件中的设置(这里不用设置三个,struts会依据locale自动找到对应的文件)如下:
三个messageresources文件中定义的messagekey为:
下面的代码片段示例了bean:message标签的用法:
上面的代码中含有改变locale的两个html:link标签,要使它们工作您的struts-config.xml文件中必须含有下面定义的form和action:
在不同的locale下我们得到了如下的两个结果:
让我们来看一下在locale为zh时如何得到的是上面的结果。因为locale为zh所以<bean:messagekey="from"/><br/>先找Resources_zh.properties这个文件从中得到form键的值。而<bean:messagekey="resource"/><br/>也会先找Resources_zh.properties这个文件但这次没有找到resource键,这时Struts会到Resources.properties这个文件中找,很幸运这里找到了。如果还没有找到,或messageresource文件不存在就会抛出异常。当locale为en时类似,您可以自己试试。
下面的代码片段示例了bean:page标签取出response,然后使用bean:write标签将response的characterEncoding和contentType属性输出:
您可以用和上面类似的代码访问application、config、request或session中的任何一个对象。
下面的两个代码片段使用相同的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:resource标签,其中resource.txt是要使用的资源文件。前面的代码片段中没有指定input属性,因此以String的形式处理资源文件,bean:write标签输出资源文件的内容。后面的代码片段中指定了input属性的值,因此以InputStream的形式使用资源文件,两个bean:write标签分别输出InputStream对象的实例名(如java.io.ByteArrayInputStream@16dadf9)和类名(如classjava.io.ByteArrayInputStream)。
下面的代码片段示例了bean:size标签取出persons中还有元素的个数,其中listForm和persons的定义参见bean:define标签部分:
下面的代码片段示例了bean:struts标签取出listForm对象,让我们先来看一下listForm的定义在读代码:
上面代码运行的结果为:
下面的代码片段示例了bean:write标签输出User-Agent:
下面的代码片段示例了bean:write标签格式化输出当前日期,其中now是在DataForm中定义的一个java.util.Date类型的域(值为newDate()),format.date.standard是在资源文件中的一个键(format.date.standard=yyyy-MM-dd):
上面代码运行的结果为:
从用户处收集数据是动态web应用非常重要的一个方面,因此构建输入表单也就自然而然的成为struts框架的一个重要内容。Strutshtml标签库含有创建Struts输入表单的标签,和其它标签库(bean、logic、nested和tiles)中的标签一起协作就可以产生基于html的用户界面。
Struts提供了非常多的标签,依据功能和使用习惯的不同被分到了五个标签库中:
BeanTags:该标签库包含的标签可以用来创建bean、访问bean和访问bean的属性。同时提供了依据cookies、headers和parameters的值创建相关bean的能力。
HTMLTags:该标签库包含的标签可以用来创建Struts输入表单。
LogicTags:该标签库包含的标签可以用来进行逻辑判断、集合迭代和流程控制。
NestedTags:该标签库建立在前三个标签库的基础上,具有前三个标签库的所有功能,只是允许标签间的嵌套。
TilesTags:该标签库包含的标签可以用来创建tiles样式的页面。
这篇指南主要介绍前三个标签库中的标签。如果您对后两类标签也感兴趣可以查阅
回页首
cookie最早是由Netscape公司提出来的,用来存储客户的少量状态信息。如果您对cookie的具体细节感兴趣可以查阅
bean:cookie标签取回请求中名称为name的cookie的值。如果没有指定multiple属性则依据刚取回的值创建一个Cookie类型的bean。如果指定了multiple属性则依据刚取回的值创建一个Cookie[]类型的数组。然后用id属性值将Cookie或Cookie[]绑定到page作用域中(这种绑定是为了其它标签能够使用该值),并创建对应的scripting变量(这种变量是为了JSP脚本能够使用该值)。
下面的代码片段示例了如何使用bean:cookie标签读取名为JSESSIONID的cookie的值,并且使用了两种方式进行了输出:
<logic:presentcookie="JSESSIONID">
<bean:cookie/>
<!--其它标签通过绑定到page作用域中的属性使用该值-->
这个cookie的名称是<bean:writeproperty="name"/>,
值为<bean:writeproperty="value"/>。<br/>
<!--JSP脚本通过scripting变量使用该值-->
<%
String
Stringvalue=jSession.getValue();
out.println("这个cookie的名称是"+name+",值为"+value+"。
<br/>");
%>
</logic:present>
回页首
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:defineproperty="persons"
type="java.util.List"/>
下面给出ListForm的代码片段以帮助您更好的理解,其中Person是一个只有id和name两个属性的简单bean:
publicclassListFormextendsActionForm{
privateList<Person>persons=null;
publicList<Person>getPersons(){
returnpersons;
}
publicvoidsetPersons(List<Person>persons){
this.persons=persons;
}
publicvoidreset(ActionMappingmapping,
HttpServletRequestrequest){
persons=null;
}
}
下面的代码片段示例了logic:iterate标签如何使用bean:define标签创建的新属性values:
<logic:iterate>
<bean:writeproperty="id"/><br/>
</logic:iterate>
下面的代码片段示例了JSP脚本如何使用bean:define标签创建的新scripting变量values:
<%
Personp=newPerson();
for(inti=0;i<values.size();i++){
p=(Person)values.get(i);
out.println(p.getId());
out.println("<br/>");
}
%>
回页首
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;MSIE6.0;//应该在同一行
WindowsNT5.1;SV1;.NETCLR1.1.4322)
host:localhost:8080
connection:Keep-Alive
下面的代码片段示例了如何使用bean:header标签读取名为User-Agent的header的值,并且使用了两种方式进行了输出:
<logic:presentheader="User-Agent">
<!--其它标签通过绑定到page作用域中的属性使用该值-->
您的浏览器是<bean:header/>
<bean:write/>。<br/>
<!--JSP脚本通过scripting变量使用该值-->
<%
out.println("您的浏览器是"+userAgent+"。<br/>");
%>
</logic:present>
回页首
bean:include标签对指定url(由forward、href或page确定)处的资源做一个请求,将响应数据作为一个String类型的bean绑定到page作用域,同时创建一个scripting变量。我们可以通过id值访问它们。下面的代码片段示例了bean:include标签的用法,其中include.txt文件包含要include的内容,然后将这些内容输出:
<bean:includepage="/include.txt"/>
<!--其它标签通过绑定到page作用域中的属性使用该值-->
<bean:write/><br/>
<!--JSP脚本通过scripting变量使用该值-->
<%
out.println(value);
%>
回页首
bean:message标签用来从指定的locale中取回国际化的消息并输出,在这个过程中我们还可以传递五个以内的参数。messagekey可以通过key直接指定,也可以通过name和property间接的指定。bean:message标签有两种指定messagekey的方式,一是通过key属性直接指定;二是通过name和property属性间接的指定,其中messagekey是在messageresources文件中定义的。
我们可以在struts-config.xml文件中使用<message-resources>来设置messageresources文件。
为了介绍该标签我使用了三个messageresources文件,三个文件的名字分别为Resources.properties、Resources_en.properties和Resources_zh.properties。在struts-config.xml文件中的设置(这里不用设置三个,struts会依据locale自动找到对应的文件)如下:
<message-resourcesparameter="Resources"/>
三个messageresources文件中定义的messagekey为:
<!--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:messagekey="from"/><br/>
<bean:messagekey="resource"/><br/>
<html:linkaction="/locale?language=en">English</html:link>
<html:linkaction="/locale?language=zh">Chinese</html:link>
上面的代码中含有改变locale的两个html:link标签,要使它们工作您的struts-config.xml文件中必须含有下面定义的form和action:
<form-bean
type="org.apache.struts.action.DynaActionForm">
<form-propertytype="java.lang.String"/>
<form-propertytype="java.lang.String"/>
<!--action成功后要跳到那里-->
<form-propertytype="java.lang.String"
initial="/message.jsp"/>
</form-bean>
<actionpath="/locale"type="org.apache.struts.actions.LocaleAction"
scope="request">
</action>
在不同的locale下我们得到了如下的两个结果:
在locale为zh时的结果:
Resources_zh.properties.
Resources.properties.
在locale为en时的结果:
Resources_en.properties.
Resources.properties.
让我们来看一下在locale为zh时如何得到的是上面的结果。因为locale为zh所以<bean:messagekey="from"/><br/>先找Resources_zh.properties这个文件从中得到form键的值。而<bean:messagekey="resource"/><br/>也会先找Resources_zh.properties这个文件但这次没有找到resource键,这时Struts会到Resources.properties这个文件中找,很幸运这里找到了。如果还没有找到,或messageresource文件不存在就会抛出异常。当locale为en时类似,您可以自己试试。
回页首
bean:page标签将页上下文中的application、config、request、response或session取出,然后用id属性值将它们绑定到page作用域中(这种绑定是为了其它标签能够使用该值),并创建对应的scripting变量(这种变量是为了JSP脚本能够使用该值)。下面的代码片段示例了bean:page标签取出response,然后使用bean:write标签将response的characterEncoding和contentType属性输出:
<bean:pageproperty="response"/>
<!--其它标签通过绑定到page作用域中的属性使用该值-->
<bean:writeproperty="characterEncoding"/><br/>
<bean:writeproperty="contentType"/><br/>
<!--JSP脚本通过scripting变量使用该值-->
<%
StringcharacterEncoding=res.getCharacterEncoding();
StringcontentType=res.getContentType();
out.println(characterEncoding+"<br/>");
out.println(contentType+"<br/>");
%>
您可以用和上面类似的代码访问application、config、request或session中的任何一个对象。
回页首
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/>
<bean:write/>
<bean:parametermultiple="true"/>
<logic:iterate>
<bean:write/><br/>
</logic:iterate>
回页首
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)和类名(如classjava.io.ByteArrayInputStream)。
<bean:resource/>
<!--其它标签通过绑定到page作用域中的属性使用该值-->
<bean:write/><br/>
<!--JSP脚本通过scripting变量使用该值-->
<%
out.println(str+"<br/>");
%>
<bean:resourceinput="true"/>
<!--其它标签通过绑定到page作用域中的属性使用该值-->
<bean:write/><br/>
<bean:writeproperty="class"/>
<!--JSP脚本通过scripting变量使用该值-->
<%
out.println(is+"<br/>");
out.println(is.getClass()+"<br/>");
%>
回页首
bean:size标签创建一个java.lang.Integer类型的bean,这个bean的值为该标签指定的Collection或Map中所含元素的个数。这可以和logic:iterate标签配合使用,因为logic:iterate标签不能得到所叠代的集合的元素的个数,这有时候很不方便。下面的代码片段示例了bean:size标签取出persons中还有元素的个数,其中listForm和persons的定义参见bean:define标签部分:
<logic:notEmptyproperty="persons">
<bean:sizeproperty="persons"/>
<bean:write/>
</logic:notEmpty>
回页首
bean:struts标签取回Struts的内部对象formBean、forward或mapping的值,然后用id绑定到page作用域中(这种绑定是为了其它标签能够使用该值),并创建对应的scripting变量(这种变量是为了JSP脚本能够使用该值)。下面的代码片段示例了bean:struts标签取出listForm对象,让我们先来看一下listForm的定义在读代码:
<!--listForm的定义<form-bean
type="org.solo.struts.form.ListForm"/>-->
<bean:strutsformBean="listForm"/>
name:<bean:writeproperty="name"/><br/>
type:<bean:writeproperty="type"/><br/>
dynamic:<bean:writeproperty="dynamic"/><br/>
上面代码运行的结果为:
name:listForm
type:org.solo.struts.form.ListForm
dynamic:false
回页首
bean:write标签将指定的bean的属性值写到当前的JspWriter中,并且可以对输出进行格式化。下面的代码片段示例了bean:write标签输出User-Agent:
<logic:presentheader="User-Agent">
<bean:header/>
<bean:write/>
</logic:present>
下面的代码片段示例了bean:write标签格式化输出当前日期,其中now是在DataForm中定义的一个java.util.Date类型的域(值为newDate()),format.date.standard是在资源文件中的一个键(format.date.standard=yyyy-MM-dd):
<bean:defineproperty="now"/>
<br/><bean:write/>
<br/><bean:writeformat="MM/dd/yyyy"/>
<br/><bean:writeformatKey="format.date.standard"/>
上面代码运行的结果为:
SunJun0417:04:05CST2006
06/04/2006
2006-06-04
回页首
虽然这里的标题是html:base标签,但是这里也是这篇指南要介绍的第一个Strutshtml标签。因此我想在这里从整体上简单的介绍一下,最后给出一个对照表。其中的绝大多数标签就不一一介绍了,要介绍的也不会在这里介绍,而是将其独立出来以显重要性。从用户处收集数据是动态web应用非常重要的一个方面,因此构建输入表单也就自然而然的成为struts框架的一个重要内容。Strutshtml标签库含有创建Struts输入表单的标签,和其它标签库(bean、logic、nested和tiles)中的标签一起协作就可以产生基于html的用户界面。
相关文章推荐
- Struts标签大全
- struts标签大全续
- struts标签大全
- Struts标签大全
- Struts2标签大全,个人整理struts标签全、struts2标签全集学习
- struts标签介绍大全
- struts2 标签大全
- Struts标签(大全2)
- Struts标签大全(转自CSDN的thinkpadleo专栏)
- struts标签大全详细介绍
- struts标签介绍大全
- struts 标签 大全
- JSTL 标签大全详解
- 在JS里面,取struts的<html:form>标签里面的<html:text property="title"/>值
- [转]Struts配置文件详解,web.xml以及struts-cofig.xml,以及struts-cofig.xml中各个标签的作用。
- Struts标签 - html - link
- html基本标签大全
- bean标签库---Struts标签库
- 开发Struts 2项目遇到的一个问题,就是在struts-tags标签库下没有了s:datetimepicker标签的解决办法
- Struts标签实现循环效果