JSP Struts
之
HTML
标签库详解
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
:相应的信息在错误信息的单独列表后显示。
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>
标签
<html:password property=\"password\" redisplay=\"false\"/>
|
该标签中的一个很重要的属性是
"redisplay"
,它用于重新显示以前输入到这个区域中的值。该属性的缺省值为
true
。然而,为了使
password
不能被重新显示,你或许希望将该属性的值设为
false
。
<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
上:
<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.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>
JSP Struts
之
Bean
标签库详解
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
。
<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
中,它就不显示为一个新用户。
|
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:define id="foo" name="bar"/> <bean:define id="baz" name="bop" type="com.mycompany.MyClass"/> //定义脚本变量的类型,默认为Object
|
9.
三是复制一个现有的
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="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
站点,它可以根据用户计算机上的设置的区域自动以相应的语言显示。
使用特定的字符串来替换部分消息:
在资源文件中的定义: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
属性:如果对象不存在,不会抛出异常。
<bean:write name="userRegistration" property="email" scope="request"/>
|
posted on 2007-03-22 22:34
飞鸟 阅读(587)
评论(0) 编辑 收藏 所属分类:
Struts