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
标签库
1.
<html>
标签
它有两个属性：
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
。
|
<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 ：相应的信息在错误信息的单独列表后显示。
（它包含在模块的 MessageResources 中查找的 message keys ）、或是类型为 org.apache.struts.action.ActionErrors 的一个对象。
如果在应用程序资源中存在相应的信息，那么就可以用下面这些可选的 message keys ：
· errors.header or errors.prefix ：相应的信息在错误信息的单独列表前显示。
· errors.footer or errors.suffix ：相应的信息在错误信息的单独列表后显示。
7.
<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> 标签
<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: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 值也是同样的意思。