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
标签库
1.
<html>
标签
它有两个属性: locale 和 xhtml ,两者都不是必需的。
它有两个属性: locale 和 xhtml ,两者都不是必需的。
<html:html locale=/"true/"> 此行代码解析后: <html lang=/"en/"> |
2.
说明:生成的结果取决于
Struts
应用程序所位于的服务器的
locale
。如果你将应用程序部署到一个不同
locale
的服务器,你不需要改变代码,
Locale
会自动调整。
3.
<base>
标签:表示所包含页面的绝对位置。这个标签只有内嵌在
head
标签中才有效。
<html:base/> 此行代码解析后: <base href=/"http://www.mymain.com/myStrutsApp/testing.jsp/"> |
4.
<img>
标签
最重要的属性 page :图象文件的路径,前面必须带有一个斜线。
其它属性: heignt 、 width 、 alt 。
最重要的属性 page :图象文件的路径,前面必须带有一个斜线。
其它属性: heignt 、 width 、 alt 。
<html:img page=/"/logo.gif/" height=/"50/" width=/"200/" alt=/"Web Logo/"/>
|
5.
<link>
标签
<html:link page=/"/index.html/">Click demo</html:link> 此行代码解析后: <a href=/"/index.html/">Click demo</a> |
6.
<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 :相应的信息在错误信息的单独列表后显示。
说明:这个标签在 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 :相应的信息在错误信息的单独列表后显示。
7.
<form>
标签系列
使用 <form> 标签时必须遵循一些规则:
使用 <form> 标签时必须遵循一些规则:
1.
标签中必须包含一个
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 相关联的。 |
2.
3.
任何包含在
<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 属性时你需要给它指定元素的名称。
<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 。
此标签库和 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 对象的一些属性:
下面代码会输出一些 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 的例子:
下面是在 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 的例子:
下面是 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 中,它就不显示为一个新用户。 |
6.
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() %>'/> |
8.
二是复制一个现有的 bean 给新的 bean :
二是复制一个现有的 bean 给新的 bean :
<bean:define id="foo" name="bar"/> <bean:define id="baz" name="bop" type="com.mycompany.MyClass"/> //定义脚本变量的类型,默认为 Object |
9.
三是复制一个现有的 bean 的属性给新的 bean :
三是复制一个现有的 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 |
10.
上段代码的意思是把名为
bar
的
bean
的
baz
属性赋值给
foo
,
foo
的类型为
String(
默认
)
。
11.
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" /> |
12.
13.
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 个参数 |
14.
15.
bean:page
:把
Jsp
中的内部对象做为脚本变量。
<bean:page id="requestObj" property="request"/>
|
16.
17.
bean:resource
:获得应用程序的资源,这个资源可以是一个
String
或从
java.io.InputStream
中读入。使用
ServletContext.getResource()ServletContext.getResourceAsStream()
方法检索
web
应用中的资源,如果在检索资源时发生问题,就会产生一个
ruquest time
异常。
<bean:resource id="webxml" name="/WEB-INF/web.xml"/>
|
18.
使用
input
属性时,资源会做为一个
InputStream
,如果不指定就被当成一个
String
。
19.
bean:size
:得到存储在
array
、
collection
或
map
中的数目,类型为
java.lang.Integer
。
<bean:size id="count" name="employees" />
|
20.
21.
bean:struts
:复制
Struct
对象
(
三种类型
)
给新的
bean
,
scope
为
page
。
<bean:struts id="form" formBean="CustomerForm"/> <bean:struts id="fwd" forward="success"/> <bean:struts id="map" mapping="/saveCustomer"/> |
22.
23.
bean:write
:以字符串形式输出
bean
的属性值。
filter 属性:设为 true 时,将 HTML 保留字转换为实体 ("<" 转换为 <);
ignore 属性:如果对象不存在,不会抛出异常。
filter 属性:设为 true 时,将 HTML 保留字转换为实体 ("<" 转换为 <);
ignore 属性:如果对象不存在,不会抛出异常。
<bean:write name="userRegistration" property="email" scope="request"/>
|