Structs - 标签库，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 标签库
- <html>标签
它有两个属性：locale和xhtml，两者都不是必需的。
说明：生成的结果取决于Struts应用程序所位于的服务器的locale。如果你将应用程序部署到一个不同locale的服务器，你不需要改变代码，Locale会自动调整。<html:html locale=\"true\"> 此行代码解析后：
<html en\">
- <base>标签：表示所包含页面的绝对位置。这个标签只有内嵌在head标签中才有效。
<html:base/> 此行代码解析后：
<base href=\"http://www.mymain.com/myStrutsApp/testing.jsp\">
<img>标签
最重要的属性page：图象文件的路径，前面必须带有一个斜线。
其它属性：heignt、width、alt。
<html:img page=\"/logo.gif\" height=\"50\" width=\"200\" alt=\"Web Logo\"/> - <link>标签
<html:link page=\"/index.html\">Click demo</html:link> 此行代码解析后：
<a href=\"/index.html\">Click demo</a>
- <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：相应的信息在错误信息的单独列表后显示。
- <form>标签系列
使用<form>标签时必须遵循一些规则：
- 标签中必须包含一个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相关联的。
任何包含在<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属性时你需要给它指定元素的名称。
有没有看到这个标签库是如何建立JavaScript来定焦到password元素上的? 这也是该库让人着迷的地方之一。你不用担心如何在客户端进行编程，它会帮你自动生成。<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>
还可以看到，<form>标签中method属性的缺省值是POST。
<text>标签、<hidden>标签、<textarea>标签、<radio>标签、<checkbox>标签、<submit>标签、<reset>标签：
都有一个property属性，最后会被转换成HTML中的name属性，当然还有name和value属性。
<password>标签
该标签中的一个很重要的属性是"redisplay"，它用于重新显示以前输入到这个区域中的值。该属性的缺省值为true。然而，为了使password不能被重新显示，你或许希望将该属性的值设为false。<html:password property=\"password\" redisplay=\"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>
- 标签中必须包含一个action属性，它是这个标签中唯一必需的属性。如果不具备该属性则JSP页面会抛出一个异常。之后你必须给这个action属性指定一个有效值。一个有效值是指应用程序的Struts配置文件中元素里的任何一个子元素的访问路径。而且相应的元素中必须有一个name属性，它的值是form bean的名称。
Logic 标签库
此标签库可以分为三种类型：条件、循环、转发/重定向。
一.) 条件类型
- logic:empty和logic:notEmpty
logic:empty标签判断脚本变量是否为null，是否是一个空的字符串(长度为0)，是否是一个空的collection或map(调用isEmpty()方法来判断)。logic:notEmpty标签类似。
上段代码表示当一个名为myBean的bean在所有的scope中都不存在时，输出The bean is missing；存在的话输出The bean is not missing。<logic:empty name="myBean"> The bean is missing
</logic:empty>
<logic:notEmpty name="myBean">
The bean is not missing
</logic:notEmpty>
此标签有三个属性：name、property和scope。
- logic:equal, logic:notEqual, logic:lessThan, logic:greaterThan,logic:lessEqual, and logic:greaterEqual
这堆logic:*equal*标签从名字上就能知道意思，它们使用起来有些笨拙。
有如下属性：name、property、scope、value、cookie、header、parameter。
<logic:equal name="bean" property="doubleProperty" value="<%= doub1 %>"> equal
</logic:equal>
<logic:greaterEqual name="bean" property="doubleProperty" value="<%= doub1 %>">
greaterEqual
</logic:greaterEqual>
- logic:present和logic:notPresent
检查header、request parameter、cookie、JavaBean或JavaBean propertie是否存在且不等于null。另外还可以检查当前用户的身份，使用属性user和role。
其它的属性有：name、property、scope、cookie、header、parameter。
上段代码检查在page作用域内名为myBean的bean是否有一个prop属性。<logic:notPresent name="myBean" property="prop" scope="page"> The bean property bean.prop is present
</logic:notPresent>
- logic:match和logic:notMatch
比较两字符串是否相等，可以比较字符串的开始的、结尾的或其中的某个部分。
location属性：指定从某个位置开始进行比较。
其它的属性有：name、property、scope、value、cookie、header、parameter。
下面的例子是检查浏览器类型：
<logic:match header="User-Agent" value="Mozilla"> Mozilla!
</logic:match>
<logic:notMatch header="User-Agent" value="Mozilla">
Not Mozilla :(
</logic:notMatch>
检查bean属性是否匹配"hello world"字符串：
<logic:match name="bean" property="stringProperty" value="hello world"> Hello World!
</logic:match>
<logic:notMatch name="bean" property="stringProperty" value="hello world">
I'm so sad and lonely.
</logic:notMatch>
检查名为"name"的请求参数是否是"xyz"的子字符串，但是子字符串必须从"xyz"的索引位置1开始(也就是说子字符串必须是"y"或"yz")：
<logic:match parameter="name" value="xyz" location="1"> The parameter name is a sub-string of the string xyz from index 1
</logic:match>
二.) 循环类型
logic:iterate
重复嵌套在此标签体内的指定集合的元素，集合必须为如下类型：array 、Collection(包括ArrayList和Vector）、Enumeration、Iterator、Map(包括HashMap、Hashtable和TreeMap)。例如：
上面的代码迭代了一个employee的集合，是department属性employees的一个集合，作用域为request。
<logic:iterate > …
<bean:write name="employee" property="username" />
…
<bean:write name="employee" property="name" />
…
<bean:write name="employee" property="phone" />
…
</logic:iterate>
为了输出第五个到第十个employee，需要使用length和offset属性：
<logic:iterate > …
<bean:write name="employee" property="username" />
…
<bean:write name="employee" property="name" />
…
<bean:write name="employee" property="phone" />
…
</logic:iterate>
你可以定义一个变量保存当前的索引值：
<ol> <logic:iterate >
<li>
<em>
<bean:write name="element"/>
</em>
[<bean:write name="index"/>]</li>
</logic:iterate>
</ol>
三.) 转发/重定向类型
logic:forward和logic:redirect
logic:forward标签和jsp:forward标签和相似，但它可以使用global forward中的一个ActionForward：
<logic:forward name="login" /> ----------------------------------------------------------------------------------------------------------------------------------
与上面相关的global forward中的代码：
<global-forwards>
<forward name="login" path="/loginForm.jsp"/>
</global-forwards>
logic:redirect标签和上面的标签类似，但它默认调用的方法是response.sendRedirect()，取代了上面的requestDispatcher.forward()。最大的不同是它支持所有html:link标签的属性，所以你能够指定request参数：
<logic:redirect name="login" param paramName="employee" property="id" /> 提示：1.) 在MVC框架下，不推荐使用这两个标签，你应该是从controller中选择下一个view，而不是从view中选择。
2.) 在Jsp页面中不要过多的使用logic标签。
Structs - 标签库（Bean）- -
Bean 标签库
此标签库和Java Bean有很强的关联性，设计的本意是要在JSP 和JavaBean 之间提供一个接口。Struts 提供了一套小巧有用的标签库来操纵JavaBean和相关的对象：cookie、 header、 parameter、 define、write、message、 include、page、resource、size、struts。
- 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 /> // 这段代码定义了一个名为sessionID的脚本变量，如果找不到一个名为JSESSIONID的cookie，那sessionID
// 的值就被设置为JSESSIONID-ISUNDEFINED。
下面代码会输出一些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"/> …
下面是在request中输出所有header的例子：
<% java.util.Enumeration names =((HttpServletRequest) request).getHeaderNames();
%>
…
<%
while (names.hasMoreElements()) {
String name = (String) names.nextElement();
%>
<bean:header />
… <%= name %>
… <%= head %>
…
<%
}
%>
下面是parameter的例子：
<bean:parameter /> <bean:parameter /> // 此处定义了一个param2[]。
<bean:parameter />
于其它标签结合使用：
<bean:header /> <P>You are viewing this page with: <bean:write name="browser"/></P>
----------------------------------------------------------------------------------------------------------------------------------
<bean:cookie
value="New User" />
<P>Welcome <bean:write name="username" property="value"/!</P>
// 根据cookie创建一个新的Bean，如果用户名称已经存储在cookie中，它就不显示为一个新用户。
- bean:define：有三个用途。
一是定义新字符串常量：
<bean:define /> <bean:define + user.getName() %>'/>
<bean:define value='<%= request.getRequestURI() %>'/>
二是复制一个现有的bean给新的bean：
<bean:define /> <bean:define >定义脚本变量的类型，默认为Object
三是复制一个现有的bean的属性给新的bean：
<bean:define /> <bean:define />
//toScope属性指新bean的scope，默认为page
上段代码的意思是把名为bar的bean的baz属性赋值给foo，foo的类型为String(默认)。
bean:include
这个标签和bean:include标签和相似，不同点就是它定义了一个可以复用的脚本变量。用id属性命名一个新的脚本变量，还支持forward、href、page和transaction.属性，和html:link中的属性意义一样。
<bean:include /> 然后你能够在多个地方(scope为page)调用：
<bean:write name="footerSpacer" />
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个参数
bean:page：把Jsp中的内部对象做为脚本变量。
<bean:page /> bean:resource：获得应用程序的资源，这个资源可以是一个String或从java.io.InputStream中读入。使用ServletContext.getResource()ServletContext.getResourceAsStream() 方法检索web应用中的资源，如果在检索资源时发生问题，就会产生一个ruquest time异常。
使用input属性时，资源会做为一个InputStream，如果不指定就被当成一个String。
<bean:resource /> bean:size：得到存储在array、collection或map中的数目，类型为java.lang.Integer。
<bean:size /> bean:struts：复制Struct 对象(三种类型)给新的bean，scope为page。
<bean:struts /> <bean:struts />
<bean:struts />
bean:write：以字符串形式输出bean的属性值。
filter属性：设为true时，将HTML保留字转换为实体("<" 转换为 <);
ignore属性：如果对象不存在，不会抛出异常。
<bean:write name="userRegistration" property="email" scope="request"/>
