Struts1 标签库
说明
Struts提供了五个标签库，即：HTML、Bean、Logic、Template和Nested。
HTML
标签 ： 用来创建能够和Struts 框架和其他相应的HTML 标签交互的HTML 输入表单
Bean
标签： 在访问JavaBeans 及其属性，以及定义一个新的bean 时使用
Logic
标签： 管理条件产生的输出和对象集产生的循环
Template标签：随着Tiles框架包的出现，此标记已开始减少使用
Nested标签： 增强对其他的Struts 标签的嵌套使用的能力
标签的公共特征
>> styleId：命名自定义标签创建时的脚本变量名。
>> name ：指出关键字值，在该关键字下可以找到一个存在的bean 。如果给出了scope属性，则仅仅在scope中查找。否则，根据标准的顺序在各种scope中查找。标准顺序为 (page, request, session, or application)。
>> property ：指出bean 中的某个属性，可以在其中检索值。如果没有标明，则使用对象本身的值。
>> <text>标签、<hidden>标签、<textarea>标签、<radio>标签、<checkbox>标签、<submit>标签、<reset>标签都有一个property属性，最后会被转换成HTML中的name属性
>>
scope ：定义了Bean在哪个范围(page, request, session, or
application)中被查找。如果没有标明按顺序查找。脚本变量(见styleId)将在相同的范围中创建。
说明：
- Struts
标签也支持嵌套引用。
eg：
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 标签库
struts标签使用举例-HTML
1、html:base
表示所包含页面的绝对位置。这个标签只有内嵌在head标签中才有效。
<html:base/>
此行代码解析后：
<base
href=\”http://www.mymain.com/myStrutsApp/testing.jsp\”>
同html的base元素。Html的base的作用：
2、 html:cancel
该标签生成一个取消按钮。当点击该按钮后action servlet会绕过相应的form bean的validate()方法，同时将控制权交给相应的action。在action中可使用Action.isCancelled(HttpServletRequest)方法判断是否被取消了。如果返回true表示这个action被取消了，否则表示这个action没有被取消。
eg. <html:cancel>取消</html:cancel>
3、html:form
1) 标签中必须包含一个action属性，它是这个标签中唯一必需的属性。如果不具备该属性则JSP页面会抛出一个异常。之后你必须给这个action属性指定一个有效值。一个有效值是指应用程序的Struts配置文件中元素里的任何一个子元素的访问路径。而且相应的元素中必须有一个name属性，它的值是form bean的名称。
<html:form
action=”/login.do” >
如果你有上述一个标签 ，那么你的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) 任何包含在<form>中用来接收用户输入的标签（<text>、<password>、<hidden>、<textarea>、<radio>、<checkbox>、<select>）必须在相关的form bean中有一个指定的属性值。比如，如果你有一个属性值被指定为“username”的<text>标签，那么相关的form bean中也必须有一个名为“username”的属性。输入<text>标签中的值会被用于生成form bean的userName属性。
3)可以用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
type=”text/javascript”>
<!–
if
(document.forms[“loginForm”].elements[“password”].type !=
“hidden”)
document.forms[“loginForm”].elements[“password”].focus()
// –>
</script>
</body>
4、html:select标签
该标签生成一个select元素。multiple属性决定是否为多选。如果指定了multiple=”true”则为多选，此时对应的属性应该是一个数组。否则，此时对应的属性应该是标量。
注意：为了正确的处理未作选择的情况，在ActionForm中的reset()方法中必须将标量属性设置为默认值而将数组的长度置为0。
另外的一个重要问题就是struts如何生成option元素了，这个任务struts交给了html:option、html:options和html:optionsCollection三个标签。
1）html:option
该标签生成一个HTML的option元素。该标签必须嵌在html:select标签中。它的显示文本来自其标签体，也可以来自于资源文件。
eg.
<html:option
value=”red”>red</html:option>
<html:option
value=”blue”>blue</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
2）html:options
该标签生成多个HTML的option元素。该标签必须嵌在html:select标签中。
A.指定collection属性的方式举例如下：
<html:select name=”selectForm”
property=”orgId” size=”1″>
<html:options
collection=”orgCollection” (coll)
property=”orgId” (value)
labelProperty=”orgName”/> (label)
</html:select>
注意：orgCollection是在某个引藏对象范围(pageContext,rqeust,…)内存在的
B.未指定collection属性方式的举例如下：
<html:select name=”selectForm”
property=”orgId” size=”1″>
<html:options property=”orgIds”
labelProperty=”orgNames”/>
</html:select>
3）html:optionsCollection标签
该标签生成多个HTML的option元素。其功能和html:options标签的相同。
<html:select
name=”selectForm” property=”orgIds”
size=”1″>
<html:optionsCollection
name=”selectForm”
property=”orgs”
label=”orgName”
value=”orgId”/>
</html:select>
注意：orgs一定是在ActionForm里面出现的一个Collection类型的Bean
5、html:checkbox标签
该标签生成checkbox元素
eg
<html:checkbox
property=”loves” value=”bb”
name=”studentForm”/>bb
<html:checkbox
property=”loves” value=”cc”
name=”studentForm”/>cc
<html:checkbox
property=”loves” value=”dd” name=”studentForm”/>dd
在名为studentForm中有一个名为loves的String类型的数组来与此标签对应，这样才能在studentForm中接收到该标签的多选值
6、html:multibox标签
该标签用法同html:checkbox
8、html:radio标签
该标签生成radio元素
eg
<html:radio
property=”sex” name=”studentForm” value=”男”/>男
在名为studentForm中有一个名为sex的String类型的属性来与此标签对应，这样才能在studentForm中接收到该标签的单选值
9、html:img标签
最重要的属性page：图象文件的路径，前面必须带有一个斜线。其它属性：heignt、width、alt。
<html:img
page=”/logo.gif” height=”50″
width=”200″ alt=”Web Logo”/>
10、html:link标签
<html:link
page=”/index.html”>Click demo</html:link>
此行代码解析后：
<a
href=”/index.html”>Click demo</a>
11、html:html标签
它有两个属性：locale和xhtml，两者都不是必需的。
<html:html locale=\”true\”>
此行代码解析后：
<html lang=\”en\”>
说明：
生成的结果取决于Struts应用程序所位于的服务器的locale。如果你将应用程序部署到一个不同locale的服务器，你不需要改变代码，Locale会自动调整。
12、html: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：相应的信息在错误信息的单独列表后显示。
13、html:password
eg:
<html:password
property=”password”
redisplay=”false”/>
该标签中的一个很重要的属性是”redisplay”，它用于重新显示以前输入到这个区域中的值。该属性的缺省值为true。然而，为了使password不能被重新显示，你或许希望将该属性的值设为false。
struts标签使用举例-logic
1、logic:empty
该标签是用来判断是否为空的。如果为空，该标签体中嵌入的内容就会被处理。该标签用于以下情况：
1）当Java对象为null时；
2）当String对象为””时；
3）当java.util.Collection对象中的isEmpty()返回true时；
4）当java.util.Map对象中的isEmpty()返回true时。
eg.
< logic:empty name=”userList”>
…
< /logic:empty>
该句等同于：
if (userList.isEmpty()) {
…
}
2、logic:notEmpty
该标签的应用正好和logic:empty标签相反，略。
3、 logic:equal
该标签为等于比较符。
eg1. 比较用户的状态属性是否1，若为1，输出“启用“;
< logic:equal name=”user”
property=”state” value=”1″>
启用
< /logic:equal>
eg2. 如果上例中的value值是动态获得的，例如需要通过bean:write输出，因struts不支持标签嵌套，可采用EL来解决该问题。
<logic:equal name=”charge”
property=”num”
value=”${business.num}”>
……
< /logic:equal>
4、logic:notEqual
该标签意义与logic:equal相反，使用方法类似，略。
5、 logic:forward
该标签用于实现页面导向，查找配置文件的全局forward。
eg. < logic:forward name=”index”/>
6、 logic:greaterEqual
为大于等于比较符。
eg. 当某学生的成绩大于等于90时，输出“优秀”：
< logic:greaterEqual name=”student” property=”score”
value=”90″>
优秀
< /logic:greaterEqual>
7、 logic:greaterThan
此为大于比较符，使用方法同logic:greaterEqual，略;
8、 logic:lessEqual
此为小于等于比较符，使用方法同logic:greaterEqual,略;
9、 logic:lessThan
此为小于比较符，使用方法同logic:greaterEqual,略;
10、 logic:match
此标签比较对象是否相等；
eg1. 检查在request范围内的name属性是否包含“amigo”串：
< logic:match name=”name”
scope=”request” value=”amigo”>
< bean:write name=”name”/>中有一个“amigo”串。
< /logic:match>
eg2. 检查在request范围内的name属性是否已“amigo”作为起始字符串：
< logic:match
name=”name” scope=”request” value=”amigo”
location=”start”>
< bean:write name=”name”/>以“amigo”作为起始字符串。
<
/logic:match>
eg3.
<
logic:match header=”user-agent” value=”Windows”>
你运行的是Windows系统
<
/logic:match>
11、 logic:notMatch
此标签用于比较对象是否不相同，与logic:match意义相反，使用方法类似，略。
12、 logic:messagePresent
该标签用于判断ActionMessages/ActionErrors对象是否存在；
eg. 如果存在error信息，将其全部输出：
< logic:messagePresent
property=”error”>
< html:messages
property=”error” id=”errMsg” >
<
bean:write name=”errMsg”/>
< /html:messages>
< /logic:messagePresent >
13、 logic:messagesNotPresent
该标签用于判断ActionMessages/ActionErrors对象是否不存在,使用方法与logic:messagePresent类似，略
14、 logic:present
此标签用于判断request对象传递参数是否存在。
eg1. user对象和它的name属性在request中都存在时，输出相应字符串：
< logic:present name=”user”
property=”name”>
user对象和该对象的name属性都存在
< /logic:present>
eg2. 若有一个名字为“user”的JavaBean，输出对应字符串：
< logic:present name=”user” >
有一个名字为“user”的JavaBean。
< /logic:present>
eg3.
< logic:present header=”user-agent”>
we got a user-agent header.
< /logic:present>
15、 logic:notPresent
此标签用于判断request对象传递参数是否不存在，意义与了logic:present相反，使用方法类似，略。
16、 logic:redirect
该标签用于实现页面转向，可传递参数。
eg1. < logic:redirect href=”http://www.chinaitlab.com”/>
17、
logic:iterator
用于显示列表为collection的值（List ,ArrayList,HashMap等）。
eg1. 逐一输出用户列表(userlList)中用户的姓名：
< logic:iterate id=”user”
name=”userList”>
< bean:write name=”user”
property=”name”/>< br>
< /logic:iterate>
eg2. 从用户列表中输出从1开始的两个用户的姓名:
< logic:iterate id=”user” name=”userList”
indexId=”index” offset=”1″ length=”2″>
< bean:write name=”index”/>.
< bean:write name=”user”
property=”name”/>< br>
< /logic:iterate>
eg3. logic:iterator标签的嵌套举例
< logic:iterate id=”user” indexId=”index”
name=”userList”>
< bean:write name=”index”/>.
< bean:write name=”user”
property=”name”/>< br>
< logic:iterate id=”address”
name=”user” property=”addressList” length=”3″
offset=”1″>
< bean:write name=”address”/><
br>
< /logic:iterate>
<
/logic:iterate>
struts标签使用举例-BEAN
1、bean:write
该标签将指定的bean的属性值写到当前的JspWriter中，并且可以对输出进行格式化。
例如在struts的action着那个通过request.setAttribute(“names”,
“dddd”);将属性值dddd中放入names，可在jsp页面中通过bean:write将names属性输出。
eg：<bean:write name=”names”/>
对于日期型的属性，可在bean:write标签中指定format来输出日期格式，
eg：<bean:write name=”date”
format=”MM/dd/yyyy”/>
如果要输出某对象的某属性，例如属性名为person的对象的name属性，可通过如下方式：
eg:<bean:write
name=”person” property=”name”/>
2、bean:message
该标签用来从指定的locale中取回国际化的消息并输出，在这个过程中我们还可以传递5个以内的参数。message key可以通过key直接指定，也可以通过name和property间接的指定。
eg1. <bean:message key=”welcome.title.content”/>
该句要求在资源文件中有welcome.title.content的键值对（资源文件ApplicationSource.properties在struts的配置文件中指定）。
eg2. 传递参数信息的bean:message的用法，
<bean:message
key=”greeting” arg1=”good morning” arg2=”good
evening”/>
在资源文件中greeting的配置举例如下：
greeting = hello,
{0}, {1}.
3、bean:parameter
该标签取回请求中的参数值。如果没有指定multiple属性则依据刚取回的值创建一个String类型的bean，否则根据刚取回的值创建一个String[]类型的数组。然后用id属性值将String或String[]绑定到page作用域中(这种绑定是为了其它标签能够使用该值)，并创建对应的scripting变量(这种变量是为了JSP脚本能够使用该值)。
eg. 当请求如下的jsp页面时:http://localhost:8080/test.jsp?orgId=1
在test.jsp页中可通过如下方式获得orgId参数：
<bean:parameter id=”ok”
name=”orgId”/>
<bean:write name=”ok”/>
4、bean:size
该标签创建一个java.lang.Integer类型的bean，该值为该标签指定的Collection或Map，List中所含元素的个数。它可和logic:iterate标签配合使用。
如下语句输出userList属性中元素的个数：
eg. <bean:size
id=”size” name=”userList”/>
<bean:write name=”size”/>
struts标签使用举例-NESTED
Struts
Nested标签库的分两部分：
1) 一部分用于表达JavaBean之间的嵌套关系
2) 另一部分能够在特定的嵌套级别提供和其他Struts标签相同的功能。
a) <nested:nest>，定义一个新的嵌套级别
b) <nested:writeNesting>，输出当前嵌套级别信息
c) <nested:nest>标签可以表达JavaBean之间的嵌套关系
eg.
以三个JavaBean为例，分别是：PersonForm Bean，Person Bean和Address Bean，在PersonForm Bean中包含一个Person Bean类型的属性person，在Person Bean中又包含一个Address Bean类型的属性address。
则用nested标签表示如下：
定义两个<nested:nest>标签，第一个<nested：nest>标签嵌套在<html:form>标签中，如下：
<html:form action=”/showPerson”>
<nested:nest
property=”person”>
LastName:
<nested:text property=”lastName”/><BR>
…..
</nested:nest>
</html:form>
以上<nested:nest>标签的上层JavaBean位于<html:form>表单标签对应的PersonForm Bean，<nested:nest>标签的property属性为“person”,代表PersonForm Bean的person属性，这个person属性代表Person Bean，因此嵌套在<nested:nest>标签内部的Nested标签都相对于这个Person Bean，例如第一个<nested:text>标签的property属性”lastName“，代表Person Bean的lastName属性。
第二个<nested:nest>标签嵌套在第一个<nested:nest>标签内部：如下
<html:form
action=”/showPerson”>
<nested:nest property=”person”>
………….
<nested:nest
property=”address”>
Current nesting is :
<nested:writeNesting/><br>
Street 1:<nested:text property=”street1″/><BR>
</nested:nest>
</nested:nest>
</html:form>
在以上代码中，第二个<nested:nest>标签的property属性为“address”,代表PersonBean 的address属性，这个address属性代表Address Bean，因此嵌套在第二个<nested:nest>标签内部的Nested标签都相对于这个Address Bean。
第二个<nested:nest>标签内还嵌套了一个<nested:writeNesting>标签，它显示当前的嵌套级别，输出结果为”person.address”.
在默认情况下，<nested:nest>标签的property属性为当前ActionForm Bean的某个属性，或者位于上层<nested:nest>标签对应的JavaBean的某个属性。
可以使用<nested:root>标签来显式指定顶层级别的JavaBean。
<nested:root>标签的name属性指定JavaBean的名字，嵌套在<nested:root>标签中的<nested:nest>标签的property属性为这个JavaBean的某个属性。
和其他标签库中的标签功能相同的Nested标签
许多Nestd标签库中的标签具有和其他标签库中的标签相同的功能，区别在于Nested标签库中的标签属性相对于当前的嵌套级别，例如
<nested:nest property =
“person”>
Last name
:<nested:text property=”lastName”/>
</nested:nest>
上面的<nested:text>标签和<html:text>标签具有相同的功能，都可以生成文本框，两者的区别在于<nested:text>标签的property属性为位于当前嵌套级别对应的JavaBean的某个属性，而<html:text>标签的property属性为於当前表单对应的ActionForm Bean的某个属性。
比如我有一个User类和一个UserInfo类，前者记录用户的帐号密码，后者记录用户的详细信息。前者也有一个UserInfo属性，这样它们两者是嵌套了。
现在我要把这个用户的帐号和详细信息都显示到界面上。
一种方式是在actionForm中用两个属性User user和UserInfo userInfo来存储，在jsp中就可以用如下方式显示出来：
<nested:nest property=”user”>
帐号：<nested:write property=”account”/>
</nested:nest>
<nested:nest property=”userInfo”>
姓名：<nested:write property=”name”/>
性别：<nested:write property=”sex”/>
</nested:nest>
由于user和userInfo本身就是嵌套的，所以第二种方式就在actionForm中使用一个User user属性即可：
<nested:nest property=”user”>
帐号：<nested:write property=”account”/>
<nested:nest property=”userInfo”>
姓名：<nested:write property=”name”/>
性别：<nested:write property=”sex”/>
</nested:nest>
</nested:nest>
这样处理是不是很方便了，actionForm可以直接放上数据存储对象，如果使用了hibernate做数据持久层，我们就可以直接把持久化对象放入actionForm来显示到界面上，不用在actionForm里写很多属性来分别存储数据，也免去了给这些属性分别赋值的过程。
如果我们把上边例子中的<nested:write/>标记换成<nested:text/>，这就类似于<html:text/>标记，是一个输入框，这样我们就可以把界面上输入一次提交到actionForm中的这个数据存储对象，比如user。我们在action中就可以直接获得这个user进行处理，非常方便。
