JSP视窗组件所使用的struts标记库由四类标记组成：
2. Bean标记：用来在JSP页中管理bean
3. 逻辑标记：用来在JSP页中控制流程
4. HTML标记：用来生成HTML标记，在表单中显示数据，使用会话ID对URL进行编程
5. 模板标记：使用动态模板构造普通格式的页
2.1 Bean标记
这个标记库中包含用于定义新bean、访问bean及其属性的标记。Struts框架提供了多种自定义标记用来在JSP页中处理JavaBean。这些标记被封装在一个普通的标记库中，在文件struts-bean.tld中定义了它的标记库描述器。Bean标记库将标记定义在四个子类别中：
创建和复制bean的标记
脚本变量定义标记
bean翻译标记
消息国际化标记
2.1.1 Bean复制标记
可定义新bean，可复制现有bean，还可从现有bean复制属性。
<bean:define>标记用来：
定义新字符串常数
将现有的bean复制到新定义的bean对象
复制现有bean的属性来创建新的bean
<bean:define>标记属性：
属性描述Id 新定义的bean脚本变量名称，必须设置Type 定义引入脚本变量的类Value 为id属性定义的脚本变量分配一个新的对象Name 目标bean的名称。若value属性没有设置，这个属性就必须设置property Name属性定义的bean的属性名称，用来定义新的bean
13
Scope 源bean的作用域。若没有设置，搜索范围是从页作用域到应用程序作用域toScope 目标bean的作用域。若没有设置，默认值是页作用域
例如：定义一个bean:
<bean:define id=”test” value=”this is a test”/>
源bean在页作用域中被拷贝大哦请求作用域中的另一个bean:
<bean:define id=”targetBean” name=”sourceBean”
scope=”page” toScope=”request”/>
2.1.2 定义脚本变量的标记
从多种资源中定义和生成脚本变量，这些资源包括cookie,请求参数，HTTP标头等等。属性如下：
属性描述Id 脚本变量和要定义的页作用域属性的名称Name cookie/标头/参数的名称multiple 如果这个属性设置了任意一个数值，所有匹配的cookie都会被积累并存储到一个Cookie[](一个数组)类型的bean里。若无设置，指定cookie的第一个值将作为Cookie类型的值Value 如果没有匹配的cookie或数值，就返回这个属性指定的默认值
例如：
<bean:cookie id=”myCookie” name=”userName”/>
脚本变量名称是myCookie，用来创建这个属性的cookie的名称是userName。
<bean:header id=”myHeader” name=”Accept-Language”/>
脚本变量名称是myHeader,请求标头的名称是Accept-Language.
<bean:parameter id=”myParameter” name=”myParameter”>
脚本变量名称是myPatameter,它保存的请求参数的名称也是myParameter.
<bean:include>标记将对一个资源的响应进行检索，并引入一个脚本变量和字符串类型的页作用域属性。这个资源可以是一个页，一个ActionForward或一个外部URL。与<jsp:include>的不同是资源的响应被存储到一个页作用域的bean中，而不是写入到输出流。属性如下：
属性描述Id 脚本变量和要定义的页作用域属性的名称Page 一个内部资源forward 一个ActionForward Href 要包含的资源的完整URL
例如：
<bean:include id=”myInclude” page=”MyJsp?x=1”/>
脚本变量的名称是myInclude，要检索的响应来自资源MyJsp?x=1。
<bean:resource>标记将检索web应用中的资源，并引入一个脚本变量和InputStream或字符串类型的页作用域属性。如果在检索资源时发生问题，就会产生一个请求时间异常。属性如下：
属性描述
14
Id 脚本变量和要定义的页作用域属性的名称Name 资源的相对路径Input 如果这个属性不存在，资源的类型就是字符串
例如：
<bean:resource id=”myResource” name=”/WEB-INF/images/myResource.xml”/>
脚本变量的名称是myResource，要检索的资源的名称是myResource.xml。
2.1.3 显示Bean属性
标记库中定义了<bean:write>标记，用来将bean的属性输送到封装的JSP页写入器。这个标记与<jsp:getProperty>类似，属性如下：
属性描述Name 要进行属性显示的bean的名称property 要显示的属性的名称。如果这个属性类有java.beans.PropertyEditor,getAsText()或toString 方法会被调用Scope Bean的作用域，若没有设置，搜索范围是从页到应用程序作用域Filter 如果设置true,属性中的所有特殊HTML字符都将被转化为相应的实体引用Ignore 如果设置false，当发现属性时会产生一个请求时间异常，否则返回null
例如：
<bean:write name=”myBean” property=”myProperty” scope=”request”
filter=”true”/>
myBean的属性myProperty将会被显示，作用域为请求，如果发现任何HTML特殊字符都将被转化为相应的实体引用。
2.1.4 消息标记和国际化
strtus框架支持国际化和本地化。用户在他们的计算机中定义自己所在的区域，当web应用程序需要输出一条消息时，它将引用一个资源文件，在这个文件中所有的消息都使用了适当的语言。一个应用程序可能提供了很多资源文件，每个文件提供了用不同语言编写的消息。如果没有找到所选语言的资源文件，就将使用默认的资源文件。
struts框架对国际化的支持是使用<bean:message>标记，以及使用java.util数据包中定义的Locale和ResourceBundle类来实现Java2平台对这些任务的支持。Java.text.MessageFormat类定义的技术可以支持消息的格式。利用此功能，开发人员不需了解这些类的细节就可进行国际化和设置消息的格式。
用strtus实现国际化和本地化：
第一步要定义资源文件的名称，这个文件会包含用默认语言编写的在程序中会出现的所有消息。这些消息以“关键字-值”的形式存储，如下：
error.validation.location = The entered location is invalid
这个文件需要存储在类的路径下，而且它的路径要作为初始化参数传送给ActionServlet作为参数进行传递时，路径的格式要符合完整Java类的标准命名规范。比如，如果资源文件存储在WEB-INFclasses目录中，文件名是
15
ApplicationResources.properties，那么需要传递的参数值是ApplicationResources。如果文件在WEB-INFclassescom est中，那么参数值就应该是com.test. ApplicationResources.
为了实现国际化，所有的资源文件必须都存储在基本资源文件所在的目录中。基本资源文件包含的是用默认地区语言-本地语言编写的消息。如果基本资源文件的名称是ApplicationResources.properties，那么用其他特定语言编写的资源文件的名称就应该是ApplicationResources_xx.properties(xx为ISO编码，如英语是en)。因此这些文件应包含相同的关键字，但关键字的值是用特定语言编写的。
ActionServlet的区域初始化参数必须与一个true值一起传送，这样ActionServlet就会在用户会话中的Action.LOCALE_KEY关键字下存储一个特定用户计算机的区域对象。现在可以运行一个国际化的web站点，它可以根据用户计算机上的设置的区域自动以相应的语言显示。
我们还可以使用特定的字符串来替换部分消息，就象用java.text.MessageFormat的方法一样：
error.invalid.number = The number {0} is valid
我们可以把字符串{0}替换成任何我们需要的数字。<bean:message>标签属性如下：
属性描述Key 资源文件中定义消息关键字Locale 用户会话中存储的区域对象的属性名称。若没有设置，默认值是Action.LOCALE_KEY Bundle 在应用程序上下文中，存储资源对象的属性的名称。如果没有设置这个属性，默认值是Action.MESSAGE_KEY arg0 第一个替换参数值arg1 第二个替换参数值arg2 第三个替换参数值arg3 第四个替换参数值
例如：资源文件中定义了一个消息：
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
2.2 逻辑标记
逻辑库的标记能够用来处理外观逻辑而不需要使用scriptlet。Struts逻辑标签库包含的标记能够有条件地产生输出文本，在对象集合中循环从而重复地产生输出文本，以及应用程序流程控制。它也提供了一组在JSP页中处理流程控制的标记。这些标记封装在文件名为struts-logic.tld的标记包中。逻辑标记库定义的标记能够执行下列三个功能：
条件逻辑
重复
转发/重定向响应
16
2.2.1 条件逻辑
struts有三类条件逻辑。第一类可以比较下列实体与一个常数的大小：
cookie
请求参数
bean或bean的参数
请求标头
以下列出了这一类标记：
标记功能<equal> 如果常数与被定义的实体相等，返回true <notEqual> 如果常数与被定义的实体不相等，返回true <greaterEqual> 如果常数大于等于被定义的实体，返回true <lessEqual> 如果常数小于等于被定义的实体，返回true <lessThan> 如果常数小于被定义的实体，返回true <greaterThan> 如果常数大于被定义的实体，返回true
这一类的所有标记有相同的属性
属性描述Value 要进行比较的常数值Cookie 要进行比较的HTTP cookie的名称Header 要进行比较的HTTP请求标头的名称parameter 要进行比较的HTTP请求参数的名称Name 如果要进行比较的是bean或bean的属性，则这个属性代表bean的名称property 要进行比较的bean属性的名称Scope Bean的作用域，如果没有指定作用域，则它的搜索范围是从页到应用程序
例如：
<logic:equal parameter=”name” value=”SomeName”>
The entered name is SomeName
</logic:equal>
判断名为”name”的请求参数的值是否是”SomeName”。
<logic:greaterThan name=”bean” property=”prop” scope=”page” value=”7”>
The value of bean.Prop is greater than 7
</logic:greaterThan>
判断在页的作用域中是否有一个名为”bean”的bean，它有一个prop属性，这个属性的值是否大于7。如果这个属性能够转化为数值，就进行数值比较，否则就进行字符串比较。
第二类条件标记定义了两个标记：
<logic:present>
<logic:notPresent>
它们的功能是在计算标记体之前判断特定的项目是否存在。标记的属性和属性值决定了要进行检查的项目。
属性描述
17
Cookie 由这个属性指定的cookie将被检查是否存在Header 由这个属性指定的请求标头将被检查是否存在parameter 由这个属性指定的请求参数将被检查是否存在Name 如果没有设置property属性，那么有这个属性指定的bean将被检查是否存在。如果设置了，那么bean和bean属性都将被检查是否存在。property 检查有name属性指定的bean中是否存在指定的属性Scope 如果指定了bean的名称，这就是bean的作用域。如果没有指定作用域，搜索的范围从页到应用程序作用域。Role 检查当前已经确认的用户是否属于特殊的角色User 检查当前已经确认的用户是否有特定的名称
例如：
<logic:notPresent name=”bean” property=”prop” scope=”page”>
The bean property bean.prop is present
</logic:notPresent>
标记判断在页作用域中是否存在一个名为”bean”的bean，这个bean有一个prop属性。
第三类条件标记比较复杂，这些标记根据模板匹配的结果检查标记体的内容。换句话说，这些标记判断一个指定项目的值是否是一个特定常数的子字符串：
<logic:match>
<logic:notMatch>
这些标记允许JSP引擎在发现了匹配或是没有发现时计算标记主体。属性如下：
属性描述Cookie 要进行比较的HTTP cookie的名称Header 要进行比较的的HTTP标头的名称parameter 要进行比较的的HTTP请求参数的名称Name 若要对bean或bean的属性进行比较，这个属性是用户指定bean的名称location 如果设置了这个属性的值，将会在这个指定的位置(索引值)进行匹配scope 如果对bean进行比较，这个属性指定了bean的作用域。如果没有设置这个参数，搜索范围是从页到应用程序作用域property 要进行比较的bean的属性名称value 要进行比较的常数值
例如：
<logic:match parameter=”name” value=”xyz” location=”1”>
The parameter name is a sub-string of the string xyz from index 1
</logic:match>
标记检查名为”name”的请求参数是否是”xyz”的子字符串，但是子字符串必须从”xyz”的索引位置1开始（也就是说子字符串必须是”y”或”yz”）。
2.2.2 重复标记
在逻辑标记库中定义了<logic:iterate>标记，它能够根据特定集合中元素的数目对标记体的内容进行重复的检查。集合的类型可以是java.util.Iterator,java.util.Collection
18
,java.util.Map或是一个数组。有三种方法可以定义这个集合：
使用运行时间表达式来返回一个属性集合的集合
将集合定义为bean，并且使用name属性指定存储属性的名称。
使用name属性定义一个bean，并且使用property属性定义一个返回集合的bean属性。
当前元素的集合会被定义为一个页作用域的bean。属性如下，所有这些属性都能使用运行时表达式。
属性描述collection 如果没有设置name属性，它就指定了要进行重复的集合Id 页作用域bean和脚本变量的名称，它保存着集合中当前元素的句柄indexed 页作用域JSP bean的名称，它包含着每次重复完成后集合的当前索引Length 重复的最大次数Name 作为集合的bean的名称，或是一个bean名称，它由property属性定义的属性，是个集合Offset 重复开始位置的索引property 作为集合的Bean属性的名称Scope 如果指定了bean名称，这个属性设置bean的作用域。若没有设置，搜索范围从页到应用程序作用域Type 为当前定义的页作用域bean的类型
例如：
<logic:iterate id=”currentInt”
collection=”<% =myList %>”
type=”java.lang.Integer”
offset=”1”
length=”2”>
<% =currentint %>
</logic:iterate>
代码将从列表中的第一个元素开始重复两个元素并且能够让当前元素作为页作用域和java.lang.Integer类型的脚本变量来使用。也就是说，如果myList包含元素1，2，3，4等，代码将会打印1和2。
2.2.3 转发和重定向标记
转发标记
<logic:forward>标记能够将响应转发给重定向到特定的全局ActionForward上。ActionForward的类型决定了是使用PageContext转发响应，还是使用sendRedirect将响应进行重定向。此标记只有一个”name”属性，用来指定全局ActionForward的名称，例如：
<logic:forward name=”myGlobalForward”/>
重定向标记
<logic:redirect>标记是一个能够执行HTTP重定向的强大工具。根据指定的不同属性，它能够通过不同的方式实现重定向。它还允许开发人员指定重定向URL的查询参数。属性如下：
19
属性描述Forward 映射了资源相对路径的ActionForward Href 资源的完整URL Page 资源的相对路径Name Map类型的页名称，请求，会话或程序属性的名称，其中包含要附加大哦重定向URL（如果没有设置property属性）上的“名称-值”参数。或是具有Map类型属性的bean名称，其中包含相同的信息（没有设置property属性） Property Map类型的bean属性的名称。Bean的名称由name属性指定。Scope 如果指定了bean的名称，这个属性指定搜索bean的范围。如果没有设置，搜索范围从页到应用程序作用域ParamID 定义特定查询参数的名称ParamName 字符串类型的bean的名称，其中包含查询参数的值(如果没有设置paramProperty属性)；或是一个bean的名称，它的属性(在paramProperty属性中指定)包含了查询参数值paramProperty 字符串bean属性的名称，其中包含着查询参数的值ParamScope ParamName定义的bean的搜索范围
使用这个标记时至少要指定forward,href或page中的一个属性，以便标明将响应重定向到哪个资源。
2.3 HTML标记
Struts HTML标记可以大致地分为以下几个功能：
显示表单元素和输入控件
显示错误信息
显示其他HTML元素
2.3.1 显示表单元素和输入控件
struts将HTML表单与为表单操作而定义的ActionForm bean紧密联系在一起。表单输入字段的名称与ActionForm bean里定义的属性名称是对应的。当第一次显示表单时，表单的输入字段是从ActionForm bean中移植过来的，当表单被提交时，请求参数将移植到ActionForm bean实例。
所有可以在<form>标记中使用的用来显示HTML输入控件的内嵌标记都使用下列属性来定义JavaScript事件处理器。
属性描述Onblur 字段失去了焦点Onchange 字段失去了焦点并且数值被更改了Onclick 字段被鼠标点击Ondblclick 字段被鼠标双击Onfocus 字段接收到输入焦点Onkeydown 字段拥有焦点并且有键按下
20
onkeypress 字段拥有焦点并且有键按下并释放Onkeyup 字段拥有焦点并且有键被释放onmousedown 鼠标指针指向字段并且点击onmousemove 鼠标指针指向字段并且在字段内移动onmouseout 鼠标指针指向控件，但是指针在元素外围移动onmouseover 鼠标指针没有指向字段，但是指针在元素内部移动Onmouseup 鼠标指针指向字段，并且释放了鼠标按键
<form>元素中能够被定义的其他一般属性有：
属性描述Accesskey 定义访问输入字段的快捷键Style 定义输入字段的样式styleClass 定义输入字段的样式表类Tabindex 输入字段的tab顺序
a) 表单标记
<html:form>标记用来显示HTML标记，可以指定AcitonForm bean的名称和它的类名。如果没有设置这些属性，就需要有配置文件来指定ActionMapping以表明当前输入的是哪个JSP页，以及从映射中检索的bean名和类。如果在ActionMapping指定的作用域中没有找到指定的名称，就会创建并存储一个新的bean，否则将使用找到的bean。
<form>标记能够包含与各种HTML输入字段相对应的子标记。
<html:form>标记属性如下：
属性描述Action 与表单相关的操作。在配置中，这个操作也用来标识与表单相关的ActionForm bean Enctype 表单HTTP方法的编码类型Focus 表单中需要初始化焦点的字段Method 表单使用的HTTP方法Name 与表单相关的ActionForm bean的名称。如果没有设置这个属性，bean的名称将会从配置信息中获得Onreset 表单复位时的JavaScript事件句柄Onsubmit 表单提交时的JavaScript事件句柄Scope 搜索ActionForm bean的范围。如果没有设置，将从配置文件中获取Style 使用的格式styleClass 这个元素的格式表类Type ActionForm bean的完整名称。如果没有设置，将从配置文件获得
例如：
<html:form action=”validateEmploee.do” method=”post”>
</html:form>
与表单相关的操作路径是validateEmployee,而表单数据是通过POST传递的。对于这个表单来说，ActionForm bean的其他信息，如bean名称类型，作用域，都是从表单指定操作的ActionMapping中检索得到的：
21
<form-beans>
<form-bean name=”empForm” type=”com.example.EmployeeForm”/>
</form-beans>
<action-mappings>
<action path=”/validateEmployee”
type=”com.example.ValidateExampleAction”
name=”empForm”
scope=”request”
input=”/employeeInput.jsp”>
<forward name=”success” path=”/employeeOutput.jsp”>
</action>
</action-mapping>
如果配置文件中包含上述信息，并且请求URI的*.do被映射到ActionServlet，与表单相关的ActionForm bean的名称，类型和作用域分别是empForm,com.example.EmployeeForm和request.这些属性也可以使用<html:form>标记属性进行显示的定义。
以下标记必须嵌套在<html:form>标记里
b) 按钮和取消标记
<html:button>标记显示一个按钮控件；<html:cancel>标记显示一个取消按钮。属性如下：
属性描述Property 定义在表单被提交时返回到服务器的请求参数的名称Value 按钮上的标记
c) 复位和提交标记
<html:reset>和<html:submit>标记分别能够显示HTML复位按钮和提交按钮。
d) 文本和文本区标记
<html:text>和<html:textarea>标记分别HTML文本框和文本区，属性如下：
属性描述Property 定义当表单被提交时送回到服务器的请求参数的名称，或用来确定文本元素当前值的bean的属性名称Name 属性被查询的bean的名称，它决定了文本框和文本区的值。如果没有设置，将使用与这个内嵌表单相关的ActionForm的名称
<html:text>标记还有以下属性：
属性描述Maxlength 能够输入的最大字符数
22
Size 文本框的大小（字符数）
<html:textarea>标记特有的属性如下：
属性描述Rows 文本区的行数Cols 文本区的列数
e) 检查框和复选框标记
<html:checkbox>标记能够显示检查框控件。<html:multibox>标记能够显示HTML复选框控件，请求对象在传递检查框名称时使用的getParameterValues()调用将返回一个字符串数组。属性如下：
属性描述Name Bean的名称，其属性会被用来确定检查是否以选中的状态显示。如果没有设置，将使用与这个内嵌表单相关的ActionFrom bean的名称。Property 检查框的名称，也是决定检查框是否以选中的状态显示的bean属性名称。在复选框的情况下，这个属性必须是一个数组。Value 当检查框被选中时返回到服务器的请求参数的值
例如：
<html:checkbox property=”married” value=”Y”/>
一个名为married的检查框，在表单提交时会返回一个”Y”.
f) 文件标记
<html:file>标记可以显示HTML文件控件。属性如下：
属性描述Name Bean的名称，它的属性将确定文件控件中显示的内容。如果没设置，将使用与内嵌表单相关的ActionForm bean的名称property 这个属性定义了当表单被提交时送回到服务器的请求参数的名称，以及用来确定文件控件中显示内容的bean属性名称Accept 服务器能够处理的内容类型集。它也将对客户浏览器对话框中的可选文件类型进行过滤Value 按钮上的标记，这个按钮能够在本地文件系统中浏览文件
g) 单选钮标记
<html:radio>标记用来显示HTML单选钮控件，属性如下：
属性描述Name Bean的名称，其属性会被用来确定单选钮是否以选中的状态显示。如果没有设置，将使用与这个内嵌表单相关的ActionFrom bean的名称。property 当表单被提交时送回到服务器的请求参数的名称，以及用来确定单选钮是否以被选中状态进行显示的bean属性的名称
23
Value 当单选钮被选中时返回到服务器的值
h) 隐藏标记
<html:hidden>标记能够显示HTML隐藏输入元素，属性如下：
属性描述Name Bean的名称，其属性会被用来确定隐藏元素的当前值。如果没有设置，将使用与这个内嵌表单相关的ActionFrom bean的名称。property 定义了当表单被提交时送回到服务器的请求参数的名称，以及用来确定隐藏元素当前值的bean属性的名称Value 用来初始化隐藏输入元素的值
i) 密码标记
<html:password>标记能够显示HTML密码控件，属性如下：
属性描述maxlength 能够输入的最大字符数Name Bean的名称，它的属性将用来确定密码元素的当前值。如果没有设置，将使用与这个内嵌表单相关的ActionFrom bean的名称。property 定义了当表单被提交时送回到服务器的请求参数的名称，以及用来确定密码元素当前值的bean属性的名称redisplay 在显示这个字段时，如果相应的bean属性已经被设置了数据，这个属性决定了是否显示密码的内容Size 字段的大小
j) 选择标记
<html:select>标记能够显示HTML选择控件，属性如下：
属性描述multiple 表明这个选择控件是否允许进行多选Name Bean的名称，它的属性确定了哪个。如果没有设置，将使用与这个内嵌表单相关的ActionFrom bean的名称。property 定义了当表单被提交时送回到服务器的请求参数的名称，以及用来确定哪个选项需要被选中的bean属性的名称Size 能够同时显示的选项数目Value 用来表明需要被选中的选项
k) 选项标记(这个元素需要嵌套在<html:select>标记里)
<html:option>标记用来显示HTML选项元素集合，属性如下：
24
属性描述collection Bean集合的名称，这个集合存储在某个作用域的属性中。选项的数目与集合中元素的数目相同。Property属性能够定义选项值所使用的bean属性，而labelProperty属性定义选项标记所使用的bean的属性labelName 用来指定存储于某个作用域的bean，这个bean是一个字符串的集合，能够定义<html:option>元素的标记(如果标志与值不相同) labelProperty 与collection属性共同使用时，用来定义了存储于某个作用域的bean，这个bean将返回一个字符串集合，能够用来写入<html:option>元素的value属性Name 如果这是唯一被指定的属性，它就定义了存储于某个作用域的bean，这个bean将返回一个字符串集合，能够用来写入<html:option>元素的value属性property 这个属性在与collection属性共同使用时，定义了每个要显示选项值的独立bean的name属性。如果不是与collection属性共同使用，这个属性定义了由name属性指定的bean的属性名称(如果有name属性)，或是定义了一个ActionForm bean，这个bean将返回一个集合来写入选项的值
我们看一下这个标记的一些例子：
<html:option collection=”optionCollection” property=”optionValue”
labelProperty=”optionLabel”/>
标记假设在某个作用域中有一个名为optionCollection的集合，它包含了一些具有optionValue属性的独立的bean，每个属性将作为一个选项的值。每个选项的标志由bean的optionLabel属性属性进行定义。
<html:option name=”optionValues” labelName=”optionLabels”/>
标记中optionValues代表一个存储在某个作用域中的bean，它是一个字符串集合，能够用来写入选项的值，而optionLabels代表一个存储在某个作用域中的bean，它也是一个字符串集合，能够用来写入选项的标志。
2.3.2.显示错误信息的标记
<html:errors>标记能够与ActionErrors结合在一起来显示错误信息。这个标记首先要从当前区域的资源文件中读取消息关键字errors.header，然后显示消息的文本。接下去它会在ActionErrors对象(通常作为请求参数而存储在Action.ERROR_KEY关键字下)中循环，读取单个ActionError对象的消息关键字，从当前区域的资源文件中读取并格式化相应的消息，并且显示它们。然后它读取与errors.footer关键字相对应的消息并且显示出来。
通过定义property属性能够过滤要显示的消息，这个属性的值应该与ActionErrors对象中存储ActionError对象的关键字对应。属性如下：
属性描述Bundle 表示应用程序作用域属性的名称，它包含着消息资源，其默认值Acion.MESSAGE_KEY Locale 表示会话作用域属性的名称，它存储着用户当前登录的区域信息。其默认值是Action.ERROR_KEY
25
Name 表示请求属性的名称，它存储着ActionErrors对象。其默认值是Action.ERROR_KEY property 这个属性指定了ActionErrors对象中存储每个独立ActionError对象的关键字，它可以过滤消息
例子：
<html:errors/>
显示集合中所有的错误。
<html:errors property=”missing.name”/>
显示存储在missing.name关键字的错误。
2.3.3.其他HTML标记
struts HTML标记还定义了下列标记来显示其他HTML元素：
<html:html> : 显示HTML元素
<html:img> : 显示图象标记
<html:link> : 显示HTML链接或锚点
<html:rewrite> : 创建没有锚点标记的URI
这些标记的详细内容请参照struts文档。
2.4. 模板标记
动态模板是模块化WEB页布局设计的强大手段。Struts模板标记库定义了自定义标记来实现动态模板。
2.4.1.插入标记
<template:insert>标记能够在应用程序的JSP页中插入动态模板。这个标记只有一个template属性，用来定义模板JSP页。要插入到模板的页是有多个<template:put>标记来指定的，而这些标记被定义为<template:insert>标记的主体内容。
2.4.2.放置标记
<template:put>标记是<template:insert>标记内部使用的，用来指定插入到模板的资源。属性如下：
属性描述content 定义要插入的内容，比如一个JSP文件或一个HTML文件direct 如果这个设置为true，由content属性指定的内容将直接显示在JSP上而不是作为包含文件Name 要插入的内容的名称Role 如果设置了这个属性，只有在当前合法用户具有特定角色时才能进行内容的插入。
26
2.4.3.获得标记
在模板JSP页中使用<template:get>标记能够检索由<template:put>标记插入到JSP页的资源。属性如下：
属性描述Name 由<template:put>标记插入的内容的名称Role 如果设置了这个属性，只有在当前合法用户具有特定角色时才能进行内容的检索
2.4.4.使用模板标记
首先编写一个模板JSP页，它将被所有的web页使用：
<html>
<%@ taglib uri=”/template” prefix=”template” %>
<head>
<title></title>
</head>
<body>
<table width=”100%” height=”100%” >
<tr height=”10%”>
<td>
<template:get name=”header”/>
</td>
</tr>
<tr height=”80%”>
<td>
<template:get name=”content”/>
</td>
</tr>
<tr height=”10%”>
<td>
<template:get name=”footer”/>
</td>
</tr>
</table>
</body>
</html>
我们将这个文件命名为template.jsp。这个文件使用<template:get>标记来获得由JSP页使用<template:put>标记提供的内容，并且将内容在一个HTML表格中显示出来。这三个内容是标题，内容和页脚。典型的内容JSP会是这样：
<%@ taglib uri=”/template” prefix=”/template” %>
<template:insert template=”template.jsp”>
<template:put name=”header” content=”header.html”/>
27
<template:put name=”content” content=”employeeList.jsp”/>
<template:put name=”footer” content=”footer.html”/>
</template:insert>
这个应用程序JSP页使用<template:insert标记来定义模板，然后使用<template:put>标记将特定内容名称指定的资源放到模板JSP页中。如果我们有上百个布局相同的页，但突然想改变这个模板，我们只需要改变template.jsp文件。
Struts是Apache Jakarta的一个著名的开源项目，目标是为构建基于Java的web应用程序提供一个框架。
Struts提供了非常多的标签，依据功能和使用习惯的不同被分到了五个标签库中:
Bean Tags:该标签库包含的标签可以用来创建bean、访问bean和访问bean的属性。同时提供了依据cookies、headers和parameters的值创建相关bean的能力。
HTML Tags:该标签库包含的标签可以用来创建Struts输入表单。
Logic Tags:该标签库包含的标签可以用来进行逻辑判断、集合迭代和流程控制。
Nested Tags:该标签库建立在前三个标签库的基础上，具有前三个标签库的所有功能，只是允许标签间的嵌套。
Tiles Tags:该标签库包含的标签可以用来创建tiles样式的页面。
这篇指南主要介绍前三个标签库中的标签。如果您对后两类标签也感兴趣可以查阅参考资料中的Struts的用户指南。
cookie最早是由Netscape公司提出来的，用来存储客户的少量状态信息。如果您对cookie的具体细节感兴趣可以查阅参考资料中的cookie spec。
bean:cookie标签取回请求中名称为name的cookie的值。如果没有指定multiple属性则依据刚取回的值创建一个Cookie类型的bean。如果指定了multiple属性则依据刚取回的值创建一个Cookie[]类型的数组。然后用id属性值将Cookie或Cookie[]绑定到page作用域中(这种绑定是为了其它标签能够使用该值)，并创建对应的scripting变量(这种变量是为了JSP脚本能够使用该值)。
下面的代码片段示例了如何使用bean:cookie标签读取名为JSESSIONID的cookie的值，并且使用了两种方式进行了输出：
<logic:present cookie="JSESSIONID"> <bean:cookie /><!-- 其它标签通过绑定到page作用域中的属性使用该值 --> 这个cookie的名称是<bean:write property="name"/>，值为<bean:write property="value"/>。<br/> <!-- JSP脚本通过scripting变量使用该值 --><%String String value = jSession.getValue(); out.println("这个cookie的名称是"+name+"，值为"+value+"。<br/>");%> </logic:present>
bean:define标签在toScope(如果没有指定值就使用page作用域)指定的作用域中创建一个新属性，同时创建一个scripting变量。我们可以通过id值使用它们。新创建的属性可以由其它标签使用，而新创建的scripting变量可以由JSP脚本使用。
我们可以使用三种方式为新创建的属性和scripting变量赋值：
通过该标签的name、property和scope取回值，并且保持类型的一致性，除非取回的值为Java的原始类型，这时会使用适合的包装器类对这些值进行包装。
通过该标签的value指定值，这时新创建的属性和scripting变量的类型为java.lang.String。
通过在该标签的体中嵌入值，这时新创建的属性和scripting变量的类型为java.lang.String。
下面的代码片段示例了如何使用bean:define标签创建新属性values和新scripting变量values，它将listForm中persons的值取出来赋给values:
<bean:define property = "persons"type="java.util.List"/>
下面给出ListForm的代码片段以帮助您更好的理解，其中Person是一个只有id和name两个属性的简单bean：
public class ListForm extends ActionForm {
private List<Person> persons = null;
public List<Person> getPersons() {
return persons;
}
public void setPersons(List<Person> persons) {
this.persons = persons;
}
public void reset(ActionMapping mapping,HttpServletRequest request) {
persons = null;
}
}
下面的代码片段示例了logic:iterate标签如何使用bean:define标签创建的新属性values:
<logic:iterate ><bean:write property="id"/><br/> </logic:iterate>
下面的代码片段示例了JSP脚本如何使用bean:define标签创建的新scripting变量values:
<%Person p = new Person();for(int i=0;i<values.size();i++){ p = (Person)values.get(i);out.println(p.getId());out.println("<br/>");} %>
回页首
bean:header标签取回请求中名称为name的header的值。如果没有指定multiple属性则依据刚取回的值创建一个String类型的bean。如果指定了multiple属性则依据刚取回的值创建一个String[]类型的数组。然后用id属性值将String或String[]绑定到page作用域中(这种绑定是为了其它标签能够使用该值)，并创建对应的scripting变量(这种变量是为了JSP脚本能够使用该值)。
下面是我的浏览器发送的header的内容，这些内容和浏览器有关，因此您的浏览器发送的内容可能和下面列出的不同。不过这没有关系，因为要理解bean:header标签您只要对这些内容有一个大概的认识就足够了。
accept: */* accept-language: zh-cnaccept-encoding: gzip, deflate user-agent: Mozilla/4.0 (compatible; MSIE 6.0; //应该在同一行 Windows NT 5.1; SV1; .NET CLR 1.1.4322)host: localhost:8080 connection: Keep-Alive
下面的代码片段示例了如何使用bean:header标签读取名为User-Agent的header的值，并且使用了两种方式进行了输出：
<logic:present header="User-Agent"> <!-- 其它标签通过绑定到page作用域中的属性使用该值 -->您的浏览器是<bean:header /> <bean:write />。<br/><!-- JSP脚本通过scripting变量使用该值 --><% out.println("您的浏览器是"+userAgent+"。<br/>");%></logic:present>
回页首
bean:include标签对指定url(由forward、href或page确定)处的资源做一个请求，将响应数据作为一个String类型的bean绑定到page作用域，同时创建一个scripting变量。我们可以通过id值访问它们。
下面的代码片段示例了bean:include标签的用法，其中include.txt文件包含要include的内容，然后将这些内容输出:
<bean:include page="/include.txt"/> <!-- 其它标签通过绑定到page作用域中的属性使用该值 --><bean:write /><br/> <!-- JSP脚本通过scripting变量使用该值 --><%out.println(value);%>
bean:message标签用来从指定的locale中取回国际化的消息并输出，在这个过程中我们还可以传递五个以内的参数。message key可以通过key直接指定，也可以通过name和property间接的指定。
bean:message标签有两种指定message key的方式，一是通过key属性直接指定；二是通过name和property属性间接的指定，其中message key是在message resources文件中定义的。
我们可以在struts-config.xml文件中使用<message-resources>来设置message resources文件。
为了介绍该标签我使用了三个message resources文件，三个文件的名字分别为Resources.properties、Resources_en.properties和Resources_zh.properties。在struts-config.xml文件中的设置(这里不用设置三个，struts会依据locale自动找到对应的文件)如下：
<message-resources parameter="Resources" />
三个message resources文件中定义的message key为：
<!-- Resources.properties --> resource=Resources.properties.from=Resources.properties. <!-- Resources_en.properties -->from=Resources_en.properties. <!-- Resources_zh.properties因为文件的编码被限制为ISO8859所以要有汉字必须用jdk的native2ascii提前转换 -->from=Resources_zh.properties.
下面的代码片段示例了bean:message标签的用法:
<bean:message key="from"/><br/> <bean:message key="resource"/><br/> <html:link action="/locale?language=en">English</html:link> <html:link action="/locale?language=zh">Chinese</html:link>
上面的代码中含有改变locale的两个html:link标签，要使它们工作您的struts-config.xml文件中必须含有下面定义的form和action:
<form-bean type="org.apache.struts.action.DynaActionForm"> <form-property type="java.lang.String" /> <form-property type="java.lang.String" /><!--action成功后要跳到那里--> <form-property type="java.lang.String"initial="/message.jsp"/> </form-bean> <action path="/locale" type="org.apache.struts.actions.LocaleAction" scope="request"></action>
在不同的locale下我们得到了如下的两个结果：
在locale为zh时的结果： Resources_zh.properties.Resources.properties.在locale为en时的结果： Resources_en.properties.Resources.properties.
让我们来看一下在locale为zh时如何得到的是上面的结果。因为locale为zh所以<bean:message key="from"/><br/>先找Resources_zh.properties这个文件从中得到form键的值。而<bean:message key="resource"/><br/>也会先找Resources_zh.properties这个文件但这次没有找到resource键，这时Struts会到Resources.properties这个文件中找，很幸运这里找到了。如果还没有找到，或message resource文件不存在就会抛出异常。当locale为en时类似，您可以自己试试。
回页首
bean:page标签将页上下文中的application、config、request、response 或 session取出，然后用id属性值将它们绑定到page作用域中(这种绑定是为了其它标签能够使用该值)，并创建对应的scripting变量(这种变量是为了JSP脚本能够使用该值)。
下面的代码片段示例了bean:page标签取出response，然后使用bean:write标签将response的characterEncoding和contentType属性输出：
<bean:page property="response"/> <!-- 其它标签通过绑定到page作用域中的属性使用该值 --> <bean:write property="characterEncoding"/><br/> <bean:write property="contentType"/><br/> <!-- JSP脚本通过scripting变量使用该值 --><% String characterEncoding = res.getCharacterEncoding(); String contentType = res.getContentType(); out.println(characterEncoding+"<br/>"); out.println(contentType+"<br/>");%>
您可以用和上面类似的代码访问application、config、request 或 session中的任何一个对象。
回页首
bean:parameter标签取回请求中的参数值。如果没有指定multiple属性则依据刚取回的值创建一个String类型的bean。如果指定了multiple属性则依据刚取回的值创建一个String[]类型的数组。然后用id属性值将String或String[]绑定到page作用域中(这种绑定是为了其它标签能够使用该值)，并创建对应的scripting变量(这种变量是为了JSP脚本能够使用该值)。
下面的两个代码片段使用相同的url传递参数，url的形式为http://127.0.0.1:8080/struts-demo/parameter.jsp?param=1¶m=2¶m=3。前面的代码片段中没有指定multiple属性，因此p是String类型而且仅仅读取了参数的第一个值。后面的代码片段中指定了multiple属性的值，因此ps是String[]类型的包含所有参数的值。
<bean:parameter /> <bean:write />
<bean:parameter multiple="true" /> <logic:iterate ><bean:write /><br/></logic:iterate>
回页首
bean:resource标签取回指定的web应用程序的资源，以InputStream或String的形式保存到page作用域中并且创建scripting变量。采用什么形式取决于标签的input属性，如果指定input则以InputStream的形式保存，如果没有指定input则以String的形式保存。
下面的两个代码片段示例了bean:resource标签，其中resource.txt是要使用的资源文件。前面的代码片段中没有指定input属性，因此以String的形式处理资源文件，bean:write标签输出资源文件的内容。后面的代码片段中指定了input属性的值，因此以InputStream的形式使用资源文件，两个bean:write标签分别输出InputStream对象的实例名(如java.io.ByteArrayInputStream@16dadf9)和类名(如class java.io.ByteArrayInputStream)。
<bean:resource /> <!-- 其它标签通过绑定到page作用域中的属性使用该值 --><bean:write /><br/> <!-- JSP脚本通过scripting变量使用该值 --><%out.println(str+"<br/>");%>
<bean:resource input="true" /> <!-- 其它标签通过绑定到page作用域中的属性使用该值 --><bean:write /><br/> <bean:write property="class"/><!-- JSP脚本通过scripting变量使用该值 --><% out.println(is+"<br/>");out.println(is.getClass()+"<br/>");%>
回页首
bean:size标签创建一个java.lang.Integer类型的bean，这个bean的值为该标签指定的Collection或Map中所含元素的个数。 这可以和logic:iterate标签配合使用，因为logic:iterate标签不能得到所叠代的集合的元素的个数，这有时候很不方便。
下面的代码片段示例了bean:size标签取出persons中还有元素的个数，其中listForm和persons的定义参见bean:define标签部分：
<logic:notEmpty property = "persons"> <bean:size property = "persons"/><bean:write /> </logic:notEmpty>
回页首
bean:struts标签取回Struts的内部对象formBean、forward或mapping的值，然后用id绑定到page作用域中(这种绑定是为了其它标签能够使用该值)，并创建对应的scripting变量(这种变量是为了JSP脚本能够使用该值)。
下面的代码片段示例了bean:struts标签取出listForm对象，让我们先来看一下listForm的定义在读代码：
<!-- listForm的定义<form-bean type="org.solo.struts.form.ListForm" /> --> <bean:struts formBean="listForm"/> name:<bean:write property="name"/><br/> type:<bean:write property="type"/><br/> dynamic:<bean:write property="dynamic"/><br/>
上面代码运行的结果为：
name:listForm type:org.solo.struts.form.ListFormdynamic:false
回页首
bean:write标签将指定的bean的属性值写到当前的JspWriter中，并且可以对输出进行格式化。
下面的代码片段示例了bean:write标签输出User-Agent：
<logic:present header="User-Agent"> <bean:header /><bean:write /></logic:present>
下面的代码片段示例了bean:write标签格式化输出当前日期，其中now是在DataForm中定义的一个java.util.Date类型的域(值为new Date())，format.date.standard是在资源文件中的一个键(format.date.standard=yyyy-MM-dd)：
<bean:define property="now"/> <br/><bean:write /> <br/><bean:write format="MM/dd/yyyy"/> <br/><bean:write formatKey="format.date.standard"/>
上面代码运行的结果为：
Sun Jun 04 17:04:05 CST 2006 06/04/20062006-06-04
回页首
虽然这里的标题是html:base标签，但是这里也是这篇指南要介绍的第一个Struts html标签。因此我想在这里从整体上简单的介绍一下，最后给出一个对照表。其中的绝大多数标签就不一一介绍了，要介绍的也不会在这里介绍，而是将其独立出来以显重要性。
从用户处收集数据是动态web应用非常重要的一个方面，因此构建输入表单也就自然而然的成为struts框架的一个重要内容。Struts html标签库含有创建Struts输入表单的标签，和其它标签库(bean、logic、nested和tiles)中的标签一起协作就可以产生基于html的用户界面。
下面的对照表会使您对Struts html标签库有一个整体的印象：
图示 1. Struts HTML标签和HTML元素对照表
回页首
html:cancel标签生成一个取消按钮。当点击该按钮后action servlet会绕过相应的form bean的validate()方法，同时将控制权交给相应的action。在该action中可以使用Action.isCancelled(HttpServletRequest)方法判断是否被取消了。如果返回true表示这个action被取消了，否则表示这个action没有被取消。
请注意，如果您修改了html:cancel标签的property属性值，那么struts提供的cancel探测机制就失效了，您自己必须提供类似的机制。
下面是可取消的action的配置文件，注意<set-property property="cancellable" value="true"/>这一行，如果不添加Struts会抛出org.apache.struts.action.InvalidCancelException异常。这是我在完成本指南的过程中发现的唯一向下不兼容的地方。
<action path="/cancel" type="org.solo.struts.action.CancelAction"scope="request"> <set-property property="cancellable" value="true"/> <forward path="/cancel.jsp" /></action>
下面是html:cancel标签的代码：
<html:cancel>取消</html:cancel>
下面是对应的action中的代码：
if(isCancelled(request)){ //action被取消时要做的事情写在这里return mapping.findForward("cancel");}else{ //action没有被取消时要做的事情写在这里return mapping.findForward("success");}
回页首
html:select标签生成一个select元素。是单选还是多选取决于该标签的multiple属性。如果指定了multiple="true"则为多选，此时对应的属性应该是一个数组。如果没有指定multiple="true"则为单选，此时对应的属性应该是标量。
注意：为了正确的处理没有做任何的选择的情况，在ActionForm中的reset()方法中必须将标量属性设置为默认值而将数组的长度置为0。
另外的一个重要问题就是struts如何生成option元素了，这个任务struts交给了html:option、html:options和html:optionsCollection三个标签。
html:option标签
html:option标签生成一个HTML的option元素。该标签必须嵌在html:select标签中。它的显示文本来自其标签体，也可以来自于资源文件。它的value属性用来指定什么值将要被提交。
<html:option value="one">one</html:option> <html:option value="two">two</html:option>
html:options标签
html:options标签生成多个HTML的option元素。该标签必须嵌在html:select标签中。而且工作方式有些特殊，它的name与property属性和其它标签的name与property属性意义不一致，让我们具体看一下它的工作方式。
指定collection属性
没有指定collection属性
指定collection属性
让我通过示例来介绍在指定collection属性时该标签的工作方式，首先要说明selectForm中的persons和listForm中的persons完全一致。请参见bean:define标签。
下面的代码先利用bean:define标签将selectForm中的persons取到page作用域中，然后html:options标签再依据collection="personCollection"选中这个persons并将其中的每一个对象(Person类型)生成一个option元素。该标签的property="id"表示persons中的对象(Person类型)的id属性将作为option元素的value值。该标签的labelProperty="name"表示persons中的对象(Person类型)的name属性将作为option元素的label值。
当这个select提交时所选择的值将被提交到selectForm(name="selectForm")中的person对象(这是在SelectForm中声明的一个Person类型的域专门用来接收提交的值)的id属性中(property="person.id")。
<bean:defineproperty="persons"/> <html:select property="person.id" size="1"> <html:options collection="personCollection" property="id" labelProperty="name"/></html:select>
没有指定collection属性
让我通过示例来介绍没有指定collection属性时该标签的工作方式，先来看看ids和names的定义：
private List<String> ids = null; private List<String> names = null;
上面的代码来自SelectForm，其中ids是一个String的列表，names也是一个String的列表。我们暂时假定这两个列表含有相同数目的元素。有了这些让我们开始介绍下面的代码。html:options标签用ids中的第i个值作为option元素的value值同时使用names中相同位置的值(第i个值)作为option元素的label值。如果ids比names长那么多出的ids中的值将即作为option的value又作为option的label。如果ids比names短那么多出的names的值会被丢掉。
当这个select提交时所选择的值将被提交到selectForm(name="selectForm")中的person对象(这是在SelectForm中声明的一个Person类型的域专门用来接收提交的值)的id属性中(property="person.id")。
<html:select property="person.id" size="1"> <html:options property="ids" labelProperty="names"/></html:select>
html:optionsCollection标签
html:optionsCollection标签生成多个HTML的option元素。该标签必须嵌在html:select标签中。它的功能和html:options标签的相同，但是它的name与property属性和其它标签的name与property属性意义一致，理解起来比较自然。
让我通过示例来介绍html:optionsCollection标签的用法。首先依据name="selectForm"和property="persons"取到selectForm中的persons列表，然后将列表中的对象(Person类型)的id属性作为option元素的value值(value="id")，将列表中的对象(Person类型)的name属性作为option元素的label值(label="name")。
<html:select property="person.id" size="1"> <html:optionsCollection property="persons"label="name" value="id"/> </html:select>
下面是一个多选的示例，虽然示例中使用了html:options标签，但是html:option和html:optionsCollection也能够用来多选。而且您还必须意识到html:option、html:options和html:optionsCollection这三个标签可以同时使用。代码中的personIds是SelectForm中声明的一个String[]类型的数组用来接收提交的多个值。
<html:select property="personIds"multiple="true" size="2"> <html:options property="ids" labelProperty="names"/></html:select>
回页首
html:check标签生成一个checkbox。这里的value值可以是true，yes或on。如果您要提交其它的值(如某种形式的标识)应该考虑使用html:multibox标签。
注意:为了正确的处理没有选中的checkbox您必须在reset()中设置对应的属性为false。
下面的代码示例了html:checkbox标签的用法，其中CheckboxForm中声明了三个boolean类型的域，如下：
private boolean one = false;private boolean two = false; private boolean three = false;
<html:checkbox property="one"> One</html:checkbox><html:checkbox property="two">Two </html:checkbox><html:checkbox property="three">Three </html:checkbox>
如果选中后被提交则相应的属性的值为true。
html:radio标签生成一个radio。主要的用法有两种，下面我们通过代码来示例。
下面的代码示例了html:radio标签的一般用法，如果被提交则选中的radio的value值将被提交到radioForm中的id中。
<html:radio property="id" value="00001"> One</html:radio><html:radio property="id" value="00002">Two </html:radio>
下面的代码示例了html:radio标签的典型用法，其中的persons和bean:define标签中的一致，您可以参考bean:define标签。我只介绍这个<html:radio idName="person" property="id" value="id">，idName指定html:radio要使用的bean(这里为person)，value="id"表示person的id属性将作为radio元素的value值而property="id"表示提交时选中的radio的值将被提交给radioForm中的id属性。
<logic:notEmpty property="persons"> <logic:iterate property="persons"> <html:radio idName="person" property="id" value="id"> <bean:write property="name"/></html:radio></logic:iterate> </logic:notEmpty>
回页首
html:multibox标签生成多个checkbox。当您要使用大量的checkbox时使用这个标签非常方便，可以使您避免在ActionForm中声明大量的boolean类型的变量，带之以一个数组就行了。
注意:为了正确的处理没有选中的checkbox您必须在reset()中设置数组的长度为0。
下面的代码示例了html:multibox标签的一般用法，如果被提交则选中的所有checkbox的value值将被提交到multiboxForm中的selectedItems中，这是一个String[]数组。
<html:multibox property="selectedItems" value="00001"/><html:multibox property="selectedItems"value="00002"/>
下面的代码示例了html:multibox标签的典型用法：
<logic:iterate property="persons"> <html:multibox property="selectedItems"><bean:write property="id"/> </html:multibox><bean:write property="name"/></logic:iterate>
回页首
html:link标签生成一个锚点(<a>)元素。我从html:link标签如何构造基本url和如何构造query参数两个方面来介绍这个标签。
构造基本url是依据该标签的如下四个属性进行的，这四个属性一次只能出现一个。让我们看看它们：
forward，指定一个全局ActionForward的名称。另外如果forward是module相关的则该forward必须指向一个action而不能是一个页面。
action，指定一个Action的名称。
href，struts会直接使用这个值而不会对其进行任何处理。
page，指定一个页面的路径，必须以/开始。
构造query参数，下面列举了可能的形式，其中baseurl只是一个占位符：
baseurl?p=00001(单参单值)
baseurl?p1=00001&p2=00002&p3=00003(多参单值)
baseurl?p=00001&p=00002&p=00003(单参多值)
baseurl?p1=00001&p2=00002&p=00001&p=00002&p=00003(混合)
下面我们以代码示例来说明每一种html:link的用法，首先让我们花点时间看看相关action中的代码：
<!-- 下面所有代码的数据都是在这里构造的 --> public ActionForward execute(ActionMapping mapping,ActionForm form, HttpServletRequest request,HttpServletResponse response) { DataForm dataForm = (DataForm) form;dataForm.setParam("00001"); HashMap paramSingleMap = new HashMap();paramSingleMap.put("p1","00001"); paramSingleMap.put("p2","00002");paramSingleMap.put("p3","00003"); dataForm.setParamSingleMap(paramSingleMap); HashMap paramMultiMap = new HashMap(); paramMultiMap.put("p",new String[]{"00001","00002","00003"}); dataForm.setParamMultiMap(paramMultiMap);HashMap paramSMMap = new HashMap(); paramSMMap.put("p1","00001");paramSMMap.put("p2","00002"); paramSMMap.put("p",new String[]{"00001","00002","00003"}); dataForm.setParamSMMap(paramSMMap); List<Person> persons = new ArrayList<Person>(); Person person1 = new Person();person1.setId("00001");person1.setName("赵辰"); Person person2 = new Person();person2.setId("00002");person2.setName("李为芳"); Person person3 = new Person();person3.setId("00003");person3.setName("王微"); persons.add(person1);persons.add(person2);persons.add(person3); dataForm.setPersons(persons);return mapping.findForward("success");}
<!-- 这用来设置一个位置 --><html:link linkName="top"/> <!-- 这用来定位到上面的那个位置 --> <html:link page="/link.do" anchor="top">Go Top</html:link>
<html:link page="/link.do" paramId="p" paramName="dataForm" paramProperty="param">单参单值</html:link><br/> <html:link page="/link.do" property="paramSingleMap">多参单值 </html:link><br/> <html:link page="/link.do" property="paramMultiMap">单参多值 </html:link><br/> <html:link page="/link.do" property="paramSMMap">混合</html:link>
下面的代码示例了html:link标签的indexed属性和indexId属性的用法，这两个属性只有html:link标签嵌套在logic:iterate标签中时才可用。
<logic:iterate property="persons"> <html:link action="/link.do" paramId="person" paramName="person" paramProperty="id" indexed="true" indexId="number">person</html:link> <br/></logic:iterate><!-- 下面是上面代码的运行结果(产生的html) <a href="/struts-demo/link.do?person=00001&number=0">赵辰</a><br/> <a href="/struts-demo/link.do?person=00002&number=1">李为芳</a><br/> <a href="/struts-demo/link.do?person=00003&number=2">王微</a><br/> 其中的number是由indexId="number"确定的，而该参数的值为元素在集合中的位置。-->
html:rewrite标签和html:link标签类似只是不生成锚点(<a>)，而是简单的输出字符串。
回页首
html:errors标签和html:messages标签的功能相似，所以我们放到一起来介绍。
html:errors标签将由name属性指定的ActionMessages、ActionErrors、String和String[]直接输出到页面中。
html:messages标签将用由name属性(注意message属性值对它的影响)指定的ActionMessages、ActionErrors、String和String[]创建一个新的属性和scripting变量，使用id属性值作为名称。
html:errors标签和html:messages标签的property属性是用来为errors和messages分类的。我们可以给这两个标签指定property属性，以便只显示某一类的错误或消息。
在资源文件增加了如下的内容：
# -- standard errors -- errors.header=<ul>errors.prefix=<li>errors.suffix=</li> errors.footer=</ul>error=error with none value . error1=error1 with one value is {0} . error2=error2 with two values are {0} , {1} . error3=error3 with three values are {0} , {1} , {2} . error4=error4 with four values are {0} , {1} , {2} ,{3} .
下面的代码示例了actionErrors的构造：
public ActionErrors validate(ActionMapping mapping, HttpServletRequest request) {ActionErrors actionErrors = new ActionErrors(); actionErrors.add("property1",new ActionMessage("error")); actionErrors.add("property2",new ActionMessage("error1","value0")); actionErrors.add("property2",new ActionMessage("error2","value0","value1")); actionErrors.add("property3", new ActionMessage("error3","value0","value1","value2")); actionErrors.add("property3", new ActionMessage("error4","value0","value1","value2","value3")); actionErrors.add("property4", new ActionMessage("error1",new Object[]{"value0"})); actionErrors.add("property4", new ActionMessage("error2",new Object[]{"value0","value1"})); actionErrors.add("property4", new ActionMessage("error3",new Object[]{"value0","value1","value2"})); actionErrors.add("property5", new ActionMessage("error4",new Object[]{"value0","value1","value2","value3"})); actionErrors.add("notBundle",new ActionMessage("not a bundle key",false)); return actionErrors;}
errors标签代码示例：
<html:errors/><br/> <html:errors property="property4"/>
messages标签代码示例：
<logic:messagesPresent> <ul><html:messages ><li><bean:write /></li> </html:messages></ul></logic:messagesPresent><br/> <logic:messagesPresent><ul> <html:messages property="property4"> <li><bean:write /></li></html:messages></ul> </logic:messagesPresent>
图示 2. 上面的两段代码示例运行结果相同，如下所示：
回页首
html:javascript标签生成用于校验的javascript脚本代码。
下面的代码片段示例了html:javascript标签的基本用法，其中formName属性的值是在validation.xml文件的<formset>中定义的form的名称。有一点值得注意的是在确定<formset>时要使用合适的language属性值。
<html:javascript formName="dataForm"/>
回页首
html:xhtml标签在页面中一出现就是告诉该页的所有其它的Struts html标签以XHTML1.0兼容的形式输出。这和将html:html标签的xhtml属性值指定为true有些类似。如果上述情况都没有出现，Struts html标签将以html4.01兼容的形式输出。
回页首
logic:iterate标签用来迭代集合，您可以使用如下方式来为这个标签指定其要叠代的集合：
使用一个运行时表达式，这个表达式的值是一个集合。
用name属性引用一个JSP Bean，这个JSP Bean本身就是一个集合。
用name属性引用一个JSP Bean，这个JSP Bean的一个属性是一个集合，这时可以联合使用property来指定这个集合。
上面所提到的集合可以是：
对象类型或原子类型的数组(Array)。
java.util.Collection的实现，包括ArrayList，Vector。
java.util.Enumeration的实现。
java.util.Iterator的实现。
java.util.Map的实现，包括HashMap，Hashtable和TreeMap。
如果您叠代的集合中含有null的值，这时需要采取一定的措施，因为这时logic:iterate不会在page作用域中创建对象。一般是使用<logic:present>标签或<logic:notPresent>标签来判断一下。
下面是logic:iterate叠代ArrayList的示例的对象引用关系和部分代码：
图示 3. logic:iterate中对象的引用关系
图中的persons列表是在ListAction中填充的，在这里只是简单的加入了三个Person对象，在实际的应用中这些数据应该取自数据库。具体的代码如下：
public ActionForward execute(ActionMapping mapping,ActionForm form, HttpServletRequest request, HttpServletResponse response) { ListForm listForm = (ListForm) form; List<Person> persons = new ArrayList<Person>(); Person person1 = new Person();person1.setId("00001");person1.setName("赵辰"); Person person2 = new Person();person2.setId("00002");person2.setName("李为芳"); Person person3 = new Person();person3.setId("00003");person3.setName("王微"); persons.add(person1);persons.add(person2);persons.add(person3); listForm.setPersons(persons);return mapping.findForward("success");}
标签输出的结果为：
00001-->赵辰00002-->李为芳00003-->王微
回页首
如果指定的值出现该标签就会创建其标签体内的内容。该标签用于以下情况：
检查具有指定名称的cookie是否出现。
检查具有指定名称的header是否出现。
检查具有指定名称的JSP Bean是否出现 或 检查具有指定名称的JSP Bean中的property属性是否出现。
检查request中指定名称的参数是否出现。
检查当前的认证用户是否与指定的安全角色相关联。
检查当前认证的主体是否具有指定的名字。
下面的代码示例了logic:present标签检查具有指定名称User-Agent的header是否出现：
<logic:present header="User-Agent">您的浏览器是<bean:header /> <bean:write />。<br/></logic:present>
logic:notPresent标签的应用正好和logic:present标签相反。
回页首
logic:messagesPresent标签用于以下情况：
在request作用域中存在一个ActionMessages对象，标签的property属性和ActionMessages中的property对应。
在request作用域中存在一个ActionErrors对象，标签的property属性和ActionErrors中的property对应。
存在一个String对象，将其转换(构造)成ActionMessage然后在添加到ActionMessages中。
存在一个String Array对象，将数组中的每一个String转换成一个ActionMessage，在将其添加到ActionMessages中。
标签的message属性
2. Bean标记：用来在JSP页中管理bean
3. 逻辑标记：用来在JSP页中控制流程
4. HTML标记：用来生成HTML标记，在表单中显示数据，使用会话ID对URL进行编程
5. 模板标记：使用动态模板构造普通格式的页
2.1 Bean标记
这个标记库中包含用于定义新bean、访问bean及其属性的标记。Struts框架提供了多种自定义标记用来在JSP页中处理JavaBean。这些标记被封装在一个普通的标记库中，在文件struts-bean.tld中定义了它的标记库描述器。Bean标记库将标记定义在四个子类别中：
创建和复制bean的标记
脚本变量定义标记
bean翻译标记
消息国际化标记
2.1.1 Bean复制标记
可定义新bean，可复制现有bean，还可从现有bean复制属性。
<bean:define>标记用来：
定义新字符串常数
将现有的bean复制到新定义的bean对象
复制现有bean的属性来创建新的bean
<bean:define>标记属性：
属性描述Id 新定义的bean脚本变量名称，必须设置Type 定义引入脚本变量的类Value 为id属性定义的脚本变量分配一个新的对象Name 目标bean的名称。若value属性没有设置，这个属性就必须设置property Name属性定义的bean的属性名称，用来定义新的bean
13
Scope 源bean的作用域。若没有设置，搜索范围是从页作用域到应用程序作用域toScope 目标bean的作用域。若没有设置，默认值是页作用域
例如：定义一个bean:
<bean:define id=”test” value=”this is a test”/>
源bean在页作用域中被拷贝大哦请求作用域中的另一个bean:
<bean:define id=”targetBean” name=”sourceBean”
scope=”page” toScope=”request”/>
2.1.2 定义脚本变量的标记
从多种资源中定义和生成脚本变量，这些资源包括cookie,请求参数，HTTP标头等等。属性如下：
属性描述Id 脚本变量和要定义的页作用域属性的名称Name cookie/标头/参数的名称multiple 如果这个属性设置了任意一个数值，所有匹配的cookie都会被积累并存储到一个Cookie[](一个数组)类型的bean里。若无设置，指定cookie的第一个值将作为Cookie类型的值Value 如果没有匹配的cookie或数值，就返回这个属性指定的默认值
例如：
<bean:cookie id=”myCookie” name=”userName”/>
脚本变量名称是myCookie，用来创建这个属性的cookie的名称是userName。
<bean:header id=”myHeader” name=”Accept-Language”/>
脚本变量名称是myHeader,请求标头的名称是Accept-Language.
<bean:parameter id=”myParameter” name=”myParameter”>
脚本变量名称是myPatameter,它保存的请求参数的名称也是myParameter.
<bean:include>标记将对一个资源的响应进行检索，并引入一个脚本变量和字符串类型的页作用域属性。这个资源可以是一个页，一个ActionForward或一个外部URL。与<jsp:include>的不同是资源的响应被存储到一个页作用域的bean中，而不是写入到输出流。属性如下：
属性描述Id 脚本变量和要定义的页作用域属性的名称Page 一个内部资源forward 一个ActionForward Href 要包含的资源的完整URL
例如：
<bean:include id=”myInclude” page=”MyJsp?x=1”/>
脚本变量的名称是myInclude，要检索的响应来自资源MyJsp?x=1。
<bean:resource>标记将检索web应用中的资源，并引入一个脚本变量和InputStream或字符串类型的页作用域属性。如果在检索资源时发生问题，就会产生一个请求时间异常。属性如下：
属性描述
14
Id 脚本变量和要定义的页作用域属性的名称Name 资源的相对路径Input 如果这个属性不存在，资源的类型就是字符串
例如：
<bean:resource id=”myResource” name=”/WEB-INF/images/myResource.xml”/>
脚本变量的名称是myResource，要检索的资源的名称是myResource.xml。
2.1.3 显示Bean属性
标记库中定义了<bean:write>标记，用来将bean的属性输送到封装的JSP页写入器。这个标记与<jsp:getProperty>类似，属性如下：
属性描述Name 要进行属性显示的bean的名称property 要显示的属性的名称。如果这个属性类有java.beans.PropertyEditor,getAsText()或toString 方法会被调用Scope Bean的作用域，若没有设置，搜索范围是从页到应用程序作用域Filter 如果设置true,属性中的所有特殊HTML字符都将被转化为相应的实体引用Ignore 如果设置false，当发现属性时会产生一个请求时间异常，否则返回null
例如：
<bean:write name=”myBean” property=”myProperty” scope=”request”
filter=”true”/>
myBean的属性myProperty将会被显示，作用域为请求，如果发现任何HTML特殊字符都将被转化为相应的实体引用。
2.1.4 消息标记和国际化
strtus框架支持国际化和本地化。用户在他们的计算机中定义自己所在的区域，当web应用程序需要输出一条消息时，它将引用一个资源文件，在这个文件中所有的消息都使用了适当的语言。一个应用程序可能提供了很多资源文件，每个文件提供了用不同语言编写的消息。如果没有找到所选语言的资源文件，就将使用默认的资源文件。
struts框架对国际化的支持是使用<bean:message>标记，以及使用java.util数据包中定义的Locale和ResourceBundle类来实现Java2平台对这些任务的支持。Java.text.MessageFormat类定义的技术可以支持消息的格式。利用此功能，开发人员不需了解这些类的细节就可进行国际化和设置消息的格式。
用strtus实现国际化和本地化：
第一步要定义资源文件的名称，这个文件会包含用默认语言编写的在程序中会出现的所有消息。这些消息以“关键字-值”的形式存储，如下：
error.validation.location = The entered location is invalid
这个文件需要存储在类的路径下，而且它的路径要作为初始化参数传送给ActionServlet作为参数进行传递时，路径的格式要符合完整Java类的标准命名规范。比如，如果资源文件存储在WEB-INFclasses目录中，文件名是
15
ApplicationResources.properties，那么需要传递的参数值是ApplicationResources。如果文件在WEB-INFclassescom est中，那么参数值就应该是com.test. ApplicationResources.
为了实现国际化，所有的资源文件必须都存储在基本资源文件所在的目录中。基本资源文件包含的是用默认地区语言-本地语言编写的消息。如果基本资源文件的名称是ApplicationResources.properties，那么用其他特定语言编写的资源文件的名称就应该是ApplicationResources_xx.properties(xx为ISO编码，如英语是en)。因此这些文件应包含相同的关键字，但关键字的值是用特定语言编写的。
ActionServlet的区域初始化参数必须与一个true值一起传送，这样ActionServlet就会在用户会话中的Action.LOCALE_KEY关键字下存储一个特定用户计算机的区域对象。现在可以运行一个国际化的web站点，它可以根据用户计算机上的设置的区域自动以相应的语言显示。
我们还可以使用特定的字符串来替换部分消息，就象用java.text.MessageFormat的方法一样：
error.invalid.number = The number {0} is valid
我们可以把字符串{0}替换成任何我们需要的数字。<bean:message>标签属性如下：
属性描述Key 资源文件中定义消息关键字Locale 用户会话中存储的区域对象的属性名称。若没有设置，默认值是Action.LOCALE_KEY Bundle 在应用程序上下文中，存储资源对象的属性的名称。如果没有设置这个属性，默认值是Action.MESSAGE_KEY arg0 第一个替换参数值arg1 第二个替换参数值arg2 第三个替换参数值arg3 第四个替换参数值
例如：资源文件中定义了一个消息：
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
2.2 逻辑标记
逻辑库的标记能够用来处理外观逻辑而不需要使用scriptlet。Struts逻辑标签库包含的标记能够有条件地产生输出文本，在对象集合中循环从而重复地产生输出文本，以及应用程序流程控制。它也提供了一组在JSP页中处理流程控制的标记。这些标记封装在文件名为struts-logic.tld的标记包中。逻辑标记库定义的标记能够执行下列三个功能：
条件逻辑
重复
转发/重定向响应
16
2.2.1 条件逻辑
struts有三类条件逻辑。第一类可以比较下列实体与一个常数的大小：
cookie
请求参数
bean或bean的参数
请求标头
以下列出了这一类标记：
标记功能<equal> 如果常数与被定义的实体相等，返回true <notEqual> 如果常数与被定义的实体不相等，返回true <greaterEqual> 如果常数大于等于被定义的实体，返回true <lessEqual> 如果常数小于等于被定义的实体，返回true <lessThan> 如果常数小于被定义的实体，返回true <greaterThan> 如果常数大于被定义的实体，返回true
这一类的所有标记有相同的属性
属性描述Value 要进行比较的常数值Cookie 要进行比较的HTTP cookie的名称Header 要进行比较的HTTP请求标头的名称parameter 要进行比较的HTTP请求参数的名称Name 如果要进行比较的是bean或bean的属性，则这个属性代表bean的名称property 要进行比较的bean属性的名称Scope Bean的作用域，如果没有指定作用域，则它的搜索范围是从页到应用程序
例如：
<logic:equal parameter=”name” value=”SomeName”>
The entered name is SomeName
</logic:equal>
判断名为”name”的请求参数的值是否是”SomeName”。
<logic:greaterThan name=”bean” property=”prop” scope=”page” value=”7”>
The value of bean.Prop is greater than 7
</logic:greaterThan>
判断在页的作用域中是否有一个名为”bean”的bean，它有一个prop属性，这个属性的值是否大于7。如果这个属性能够转化为数值，就进行数值比较，否则就进行字符串比较。
第二类条件标记定义了两个标记：
<logic:present>
<logic:notPresent>
它们的功能是在计算标记体之前判断特定的项目是否存在。标记的属性和属性值决定了要进行检查的项目。
属性描述
17
Cookie 由这个属性指定的cookie将被检查是否存在Header 由这个属性指定的请求标头将被检查是否存在parameter 由这个属性指定的请求参数将被检查是否存在Name 如果没有设置property属性，那么有这个属性指定的bean将被检查是否存在。如果设置了，那么bean和bean属性都将被检查是否存在。property 检查有name属性指定的bean中是否存在指定的属性Scope 如果指定了bean的名称，这就是bean的作用域。如果没有指定作用域，搜索的范围从页到应用程序作用域。Role 检查当前已经确认的用户是否属于特殊的角色User 检查当前已经确认的用户是否有特定的名称
例如：
<logic:notPresent name=”bean” property=”prop” scope=”page”>
The bean property bean.prop is present
</logic:notPresent>
标记判断在页作用域中是否存在一个名为”bean”的bean，这个bean有一个prop属性。
第三类条件标记比较复杂，这些标记根据模板匹配的结果检查标记体的内容。换句话说，这些标记判断一个指定项目的值是否是一个特定常数的子字符串：
<logic:match>
<logic:notMatch>
这些标记允许JSP引擎在发现了匹配或是没有发现时计算标记主体。属性如下：
属性描述Cookie 要进行比较的HTTP cookie的名称Header 要进行比较的的HTTP标头的名称parameter 要进行比较的的HTTP请求参数的名称Name 若要对bean或bean的属性进行比较，这个属性是用户指定bean的名称location 如果设置了这个属性的值，将会在这个指定的位置(索引值)进行匹配scope 如果对bean进行比较，这个属性指定了bean的作用域。如果没有设置这个参数，搜索范围是从页到应用程序作用域property 要进行比较的bean的属性名称value 要进行比较的常数值
例如：
<logic:match parameter=”name” value=”xyz” location=”1”>
The parameter name is a sub-string of the string xyz from index 1
</logic:match>
标记检查名为”name”的请求参数是否是”xyz”的子字符串，但是子字符串必须从”xyz”的索引位置1开始（也就是说子字符串必须是”y”或”yz”）。
2.2.2 重复标记
在逻辑标记库中定义了<logic:iterate>标记，它能够根据特定集合中元素的数目对标记体的内容进行重复的检查。集合的类型可以是java.util.Iterator,java.util.Collection
18
,java.util.Map或是一个数组。有三种方法可以定义这个集合：
使用运行时间表达式来返回一个属性集合的集合
将集合定义为bean，并且使用name属性指定存储属性的名称。
使用name属性定义一个bean，并且使用property属性定义一个返回集合的bean属性。
当前元素的集合会被定义为一个页作用域的bean。属性如下，所有这些属性都能使用运行时表达式。
属性描述collection 如果没有设置name属性，它就指定了要进行重复的集合Id 页作用域bean和脚本变量的名称，它保存着集合中当前元素的句柄indexed 页作用域JSP bean的名称，它包含着每次重复完成后集合的当前索引Length 重复的最大次数Name 作为集合的bean的名称，或是一个bean名称，它由property属性定义的属性，是个集合Offset 重复开始位置的索引property 作为集合的Bean属性的名称Scope 如果指定了bean名称，这个属性设置bean的作用域。若没有设置，搜索范围从页到应用程序作用域Type 为当前定义的页作用域bean的类型
例如：
<logic:iterate id=”currentInt”
collection=”<% =myList %>”
type=”java.lang.Integer”
offset=”1”
length=”2”>
<% =currentint %>
</logic:iterate>
代码将从列表中的第一个元素开始重复两个元素并且能够让当前元素作为页作用域和java.lang.Integer类型的脚本变量来使用。也就是说，如果myList包含元素1，2，3，4等，代码将会打印1和2。
2.2.3 转发和重定向标记
转发标记
<logic:forward>标记能够将响应转发给重定向到特定的全局ActionForward上。ActionForward的类型决定了是使用PageContext转发响应，还是使用sendRedirect将响应进行重定向。此标记只有一个”name”属性，用来指定全局ActionForward的名称，例如：
<logic:forward name=”myGlobalForward”/>
重定向标记
<logic:redirect>标记是一个能够执行HTTP重定向的强大工具。根据指定的不同属性，它能够通过不同的方式实现重定向。它还允许开发人员指定重定向URL的查询参数。属性如下：
19
属性描述Forward 映射了资源相对路径的ActionForward Href 资源的完整URL Page 资源的相对路径Name Map类型的页名称，请求，会话或程序属性的名称，其中包含要附加大哦重定向URL（如果没有设置property属性）上的“名称-值”参数。或是具有Map类型属性的bean名称，其中包含相同的信息（没有设置property属性） Property Map类型的bean属性的名称。Bean的名称由name属性指定。Scope 如果指定了bean的名称，这个属性指定搜索bean的范围。如果没有设置，搜索范围从页到应用程序作用域ParamID 定义特定查询参数的名称ParamName 字符串类型的bean的名称，其中包含查询参数的值(如果没有设置paramProperty属性)；或是一个bean的名称，它的属性(在paramProperty属性中指定)包含了查询参数值paramProperty 字符串bean属性的名称，其中包含着查询参数的值ParamScope ParamName定义的bean的搜索范围
使用这个标记时至少要指定forward,href或page中的一个属性，以便标明将响应重定向到哪个资源。
2.3 HTML标记
Struts HTML标记可以大致地分为以下几个功能：
显示表单元素和输入控件
显示错误信息
显示其他HTML元素
2.3.1 显示表单元素和输入控件
struts将HTML表单与为表单操作而定义的ActionForm bean紧密联系在一起。表单输入字段的名称与ActionForm bean里定义的属性名称是对应的。当第一次显示表单时，表单的输入字段是从ActionForm bean中移植过来的，当表单被提交时，请求参数将移植到ActionForm bean实例。
所有可以在<form>标记中使用的用来显示HTML输入控件的内嵌标记都使用下列属性来定义JavaScript事件处理器。
属性描述Onblur 字段失去了焦点Onchange 字段失去了焦点并且数值被更改了Onclick 字段被鼠标点击Ondblclick 字段被鼠标双击Onfocus 字段接收到输入焦点Onkeydown 字段拥有焦点并且有键按下
20
onkeypress 字段拥有焦点并且有键按下并释放Onkeyup 字段拥有焦点并且有键被释放onmousedown 鼠标指针指向字段并且点击onmousemove 鼠标指针指向字段并且在字段内移动onmouseout 鼠标指针指向控件，但是指针在元素外围移动onmouseover 鼠标指针没有指向字段，但是指针在元素内部移动Onmouseup 鼠标指针指向字段，并且释放了鼠标按键
<form>元素中能够被定义的其他一般属性有：
属性描述Accesskey 定义访问输入字段的快捷键Style 定义输入字段的样式styleClass 定义输入字段的样式表类Tabindex 输入字段的tab顺序
a) 表单标记
<html:form>标记用来显示HTML标记，可以指定AcitonForm bean的名称和它的类名。如果没有设置这些属性，就需要有配置文件来指定ActionMapping以表明当前输入的是哪个JSP页，以及从映射中检索的bean名和类。如果在ActionMapping指定的作用域中没有找到指定的名称，就会创建并存储一个新的bean，否则将使用找到的bean。
<form>标记能够包含与各种HTML输入字段相对应的子标记。
<html:form>标记属性如下：
属性描述Action 与表单相关的操作。在配置中，这个操作也用来标识与表单相关的ActionForm bean Enctype 表单HTTP方法的编码类型Focus 表单中需要初始化焦点的字段Method 表单使用的HTTP方法Name 与表单相关的ActionForm bean的名称。如果没有设置这个属性，bean的名称将会从配置信息中获得Onreset 表单复位时的JavaScript事件句柄Onsubmit 表单提交时的JavaScript事件句柄Scope 搜索ActionForm bean的范围。如果没有设置，将从配置文件中获取Style 使用的格式styleClass 这个元素的格式表类Type ActionForm bean的完整名称。如果没有设置，将从配置文件获得
例如：
<html:form action=”validateEmploee.do” method=”post”>
</html:form>
与表单相关的操作路径是validateEmployee,而表单数据是通过POST传递的。对于这个表单来说，ActionForm bean的其他信息，如bean名称类型，作用域，都是从表单指定操作的ActionMapping中检索得到的：
21
<form-beans>
<form-bean name=”empForm” type=”com.example.EmployeeForm”/>
</form-beans>
<action-mappings>
<action path=”/validateEmployee”
type=”com.example.ValidateExampleAction”
name=”empForm”
scope=”request”
input=”/employeeInput.jsp”>
<forward name=”success” path=”/employeeOutput.jsp”>
</action>
</action-mapping>
如果配置文件中包含上述信息，并且请求URI的*.do被映射到ActionServlet，与表单相关的ActionForm bean的名称，类型和作用域分别是empForm,com.example.EmployeeForm和request.这些属性也可以使用<html:form>标记属性进行显示的定义。
以下标记必须嵌套在<html:form>标记里
b) 按钮和取消标记
<html:button>标记显示一个按钮控件；<html:cancel>标记显示一个取消按钮。属性如下：
属性描述Property 定义在表单被提交时返回到服务器的请求参数的名称Value 按钮上的标记
c) 复位和提交标记
<html:reset>和<html:submit>标记分别能够显示HTML复位按钮和提交按钮。
d) 文本和文本区标记
<html:text>和<html:textarea>标记分别HTML文本框和文本区，属性如下：
属性描述Property 定义当表单被提交时送回到服务器的请求参数的名称，或用来确定文本元素当前值的bean的属性名称Name 属性被查询的bean的名称，它决定了文本框和文本区的值。如果没有设置，将使用与这个内嵌表单相关的ActionForm的名称
<html:text>标记还有以下属性：
属性描述Maxlength 能够输入的最大字符数
22
Size 文本框的大小（字符数）
<html:textarea>标记特有的属性如下：
属性描述Rows 文本区的行数Cols 文本区的列数
e) 检查框和复选框标记
<html:checkbox>标记能够显示检查框控件。<html:multibox>标记能够显示HTML复选框控件，请求对象在传递检查框名称时使用的getParameterValues()调用将返回一个字符串数组。属性如下：
属性描述Name Bean的名称，其属性会被用来确定检查是否以选中的状态显示。如果没有设置，将使用与这个内嵌表单相关的ActionFrom bean的名称。Property 检查框的名称，也是决定检查框是否以选中的状态显示的bean属性名称。在复选框的情况下，这个属性必须是一个数组。Value 当检查框被选中时返回到服务器的请求参数的值
例如：
<html:checkbox property=”married” value=”Y”/>
一个名为married的检查框，在表单提交时会返回一个”Y”.
f) 文件标记
<html:file>标记可以显示HTML文件控件。属性如下：
属性描述Name Bean的名称，它的属性将确定文件控件中显示的内容。如果没设置，将使用与内嵌表单相关的ActionForm bean的名称property 这个属性定义了当表单被提交时送回到服务器的请求参数的名称，以及用来确定文件控件中显示内容的bean属性名称Accept 服务器能够处理的内容类型集。它也将对客户浏览器对话框中的可选文件类型进行过滤Value 按钮上的标记，这个按钮能够在本地文件系统中浏览文件
g) 单选钮标记
<html:radio>标记用来显示HTML单选钮控件，属性如下：
属性描述Name Bean的名称，其属性会被用来确定单选钮是否以选中的状态显示。如果没有设置，将使用与这个内嵌表单相关的ActionFrom bean的名称。property 当表单被提交时送回到服务器的请求参数的名称，以及用来确定单选钮是否以被选中状态进行显示的bean属性的名称
23
Value 当单选钮被选中时返回到服务器的值
h) 隐藏标记
<html:hidden>标记能够显示HTML隐藏输入元素，属性如下：
属性描述Name Bean的名称，其属性会被用来确定隐藏元素的当前值。如果没有设置，将使用与这个内嵌表单相关的ActionFrom bean的名称。property 定义了当表单被提交时送回到服务器的请求参数的名称，以及用来确定隐藏元素当前值的bean属性的名称Value 用来初始化隐藏输入元素的值
i) 密码标记
<html:password>标记能够显示HTML密码控件，属性如下：
属性描述maxlength 能够输入的最大字符数Name Bean的名称，它的属性将用来确定密码元素的当前值。如果没有设置，将使用与这个内嵌表单相关的ActionFrom bean的名称。property 定义了当表单被提交时送回到服务器的请求参数的名称，以及用来确定密码元素当前值的bean属性的名称redisplay 在显示这个字段时，如果相应的bean属性已经被设置了数据，这个属性决定了是否显示密码的内容Size 字段的大小
j) 选择标记
<html:select>标记能够显示HTML选择控件，属性如下：
属性描述multiple 表明这个选择控件是否允许进行多选Name Bean的名称，它的属性确定了哪个。如果没有设置，将使用与这个内嵌表单相关的ActionFrom bean的名称。property 定义了当表单被提交时送回到服务器的请求参数的名称，以及用来确定哪个选项需要被选中的bean属性的名称Size 能够同时显示的选项数目Value 用来表明需要被选中的选项
k) 选项标记(这个元素需要嵌套在<html:select>标记里)
<html:option>标记用来显示HTML选项元素集合，属性如下：
24
属性描述collection Bean集合的名称，这个集合存储在某个作用域的属性中。选项的数目与集合中元素的数目相同。Property属性能够定义选项值所使用的bean属性，而labelProperty属性定义选项标记所使用的bean的属性labelName 用来指定存储于某个作用域的bean，这个bean是一个字符串的集合，能够定义<html:option>元素的标记(如果标志与值不相同) labelProperty 与collection属性共同使用时，用来定义了存储于某个作用域的bean，这个bean将返回一个字符串集合，能够用来写入<html:option>元素的value属性Name 如果这是唯一被指定的属性，它就定义了存储于某个作用域的bean，这个bean将返回一个字符串集合，能够用来写入<html:option>元素的value属性property 这个属性在与collection属性共同使用时，定义了每个要显示选项值的独立bean的name属性。如果不是与collection属性共同使用，这个属性定义了由name属性指定的bean的属性名称(如果有name属性)，或是定义了一个ActionForm bean，这个bean将返回一个集合来写入选项的值
我们看一下这个标记的一些例子：
<html:option collection=”optionCollection” property=”optionValue”
labelProperty=”optionLabel”/>
标记假设在某个作用域中有一个名为optionCollection的集合，它包含了一些具有optionValue属性的独立的bean，每个属性将作为一个选项的值。每个选项的标志由bean的optionLabel属性属性进行定义。
<html:option name=”optionValues” labelName=”optionLabels”/>
标记中optionValues代表一个存储在某个作用域中的bean，它是一个字符串集合，能够用来写入选项的值，而optionLabels代表一个存储在某个作用域中的bean，它也是一个字符串集合，能够用来写入选项的标志。
2.3.2.显示错误信息的标记
<html:errors>标记能够与ActionErrors结合在一起来显示错误信息。这个标记首先要从当前区域的资源文件中读取消息关键字errors.header，然后显示消息的文本。接下去它会在ActionErrors对象(通常作为请求参数而存储在Action.ERROR_KEY关键字下)中循环，读取单个ActionError对象的消息关键字，从当前区域的资源文件中读取并格式化相应的消息，并且显示它们。然后它读取与errors.footer关键字相对应的消息并且显示出来。
通过定义property属性能够过滤要显示的消息，这个属性的值应该与ActionErrors对象中存储ActionError对象的关键字对应。属性如下：
属性描述Bundle 表示应用程序作用域属性的名称，它包含着消息资源，其默认值Acion.MESSAGE_KEY Locale 表示会话作用域属性的名称，它存储着用户当前登录的区域信息。其默认值是Action.ERROR_KEY
25
Name 表示请求属性的名称，它存储着ActionErrors对象。其默认值是Action.ERROR_KEY property 这个属性指定了ActionErrors对象中存储每个独立ActionError对象的关键字，它可以过滤消息
例子：
<html:errors/>
显示集合中所有的错误。
<html:errors property=”missing.name”/>
显示存储在missing.name关键字的错误。
2.3.3.其他HTML标记
struts HTML标记还定义了下列标记来显示其他HTML元素：
<html:html> : 显示HTML元素
<html:img> : 显示图象标记
<html:link> : 显示HTML链接或锚点
<html:rewrite> : 创建没有锚点标记的URI
这些标记的详细内容请参照struts文档。
2.4. 模板标记
动态模板是模块化WEB页布局设计的强大手段。Struts模板标记库定义了自定义标记来实现动态模板。
2.4.1.插入标记
<template:insert>标记能够在应用程序的JSP页中插入动态模板。这个标记只有一个template属性，用来定义模板JSP页。要插入到模板的页是有多个<template:put>标记来指定的，而这些标记被定义为<template:insert>标记的主体内容。
2.4.2.放置标记
<template:put>标记是<template:insert>标记内部使用的，用来指定插入到模板的资源。属性如下：
属性描述content 定义要插入的内容，比如一个JSP文件或一个HTML文件direct 如果这个设置为true，由content属性指定的内容将直接显示在JSP上而不是作为包含文件Name 要插入的内容的名称Role 如果设置了这个属性，只有在当前合法用户具有特定角色时才能进行内容的插入。
26
2.4.3.获得标记
在模板JSP页中使用<template:get>标记能够检索由<template:put>标记插入到JSP页的资源。属性如下：
属性描述Name 由<template:put>标记插入的内容的名称Role 如果设置了这个属性，只有在当前合法用户具有特定角色时才能进行内容的检索
2.4.4.使用模板标记
首先编写一个模板JSP页，它将被所有的web页使用：
<html>
<%@ taglib uri=”/template” prefix=”template” %>
<head>
<title></title>
</head>
<body>
<table width=”100%” height=”100%” >
<tr height=”10%”>
<td>
<template:get name=”header”/>
</td>
</tr>
<tr height=”80%”>
<td>
<template:get name=”content”/>
</td>
</tr>
<tr height=”10%”>
<td>
<template:get name=”footer”/>
</td>
</tr>
</table>
</body>
</html>
我们将这个文件命名为template.jsp。这个文件使用<template:get>标记来获得由JSP页使用<template:put>标记提供的内容，并且将内容在一个HTML表格中显示出来。这三个内容是标题，内容和页脚。典型的内容JSP会是这样：
<%@ taglib uri=”/template” prefix=”/template” %>
<template:insert template=”template.jsp”>
<template:put name=”header” content=”header.html”/>
27
<template:put name=”content” content=”employeeList.jsp”/>
<template:put name=”footer” content=”footer.html”/>
</template:insert>
这个应用程序JSP页使用<template:insert标记来定义模板，然后使用<template:put>标记将特定内容名称指定的资源放到模板JSP页中。如果我们有上百个布局相同的页，但突然想改变这个模板，我们只需要改变template.jsp文件。
Struts是Apache Jakarta的一个著名的开源项目，目标是为构建基于Java的web应用程序提供一个框架。
Struts提供了非常多的标签，依据功能和使用习惯的不同被分到了五个标签库中:
Bean Tags:该标签库包含的标签可以用来创建bean、访问bean和访问bean的属性。同时提供了依据cookies、headers和parameters的值创建相关bean的能力。
HTML Tags:该标签库包含的标签可以用来创建Struts输入表单。
Logic Tags:该标签库包含的标签可以用来进行逻辑判断、集合迭代和流程控制。
Nested Tags:该标签库建立在前三个标签库的基础上，具有前三个标签库的所有功能，只是允许标签间的嵌套。
Tiles Tags:该标签库包含的标签可以用来创建tiles样式的页面。
这篇指南主要介绍前三个标签库中的标签。如果您对后两类标签也感兴趣可以查阅参考资料中的Struts的用户指南。
cookie最早是由Netscape公司提出来的，用来存储客户的少量状态信息。如果您对cookie的具体细节感兴趣可以查阅参考资料中的cookie spec。
bean:cookie标签取回请求中名称为name的cookie的值。如果没有指定multiple属性则依据刚取回的值创建一个Cookie类型的bean。如果指定了multiple属性则依据刚取回的值创建一个Cookie[]类型的数组。然后用id属性值将Cookie或Cookie[]绑定到page作用域中(这种绑定是为了其它标签能够使用该值)，并创建对应的scripting变量(这种变量是为了JSP脚本能够使用该值)。
下面的代码片段示例了如何使用bean:cookie标签读取名为JSESSIONID的cookie的值，并且使用了两种方式进行了输出：
<logic:present cookie="JSESSIONID"> <bean:cookie /><!-- 其它标签通过绑定到page作用域中的属性使用该值 --> 这个cookie的名称是<bean:write property="name"/>，值为<bean:write property="value"/>。<br/> <!-- JSP脚本通过scripting变量使用该值 --><%String String value = jSession.getValue(); out.println("这个cookie的名称是"+name+"，值为"+value+"。<br/>");%> </logic:present>
bean:define标签在toScope(如果没有指定值就使用page作用域)指定的作用域中创建一个新属性，同时创建一个scripting变量。我们可以通过id值使用它们。新创建的属性可以由其它标签使用，而新创建的scripting变量可以由JSP脚本使用。
我们可以使用三种方式为新创建的属性和scripting变量赋值：
通过该标签的name、property和scope取回值，并且保持类型的一致性，除非取回的值为Java的原始类型，这时会使用适合的包装器类对这些值进行包装。
通过该标签的value指定值，这时新创建的属性和scripting变量的类型为java.lang.String。
通过在该标签的体中嵌入值，这时新创建的属性和scripting变量的类型为java.lang.String。
下面的代码片段示例了如何使用bean:define标签创建新属性values和新scripting变量values，它将listForm中persons的值取出来赋给values:
<bean:define property = "persons"type="java.util.List"/>
下面给出ListForm的代码片段以帮助您更好的理解，其中Person是一个只有id和name两个属性的简单bean：
public class ListForm extends ActionForm {
private List<Person> persons = null;
public List<Person> getPersons() {
return persons;
}
public void setPersons(List<Person> persons) {
this.persons = persons;
}
public void reset(ActionMapping mapping,HttpServletRequest request) {
persons = null;
}
}
下面的代码片段示例了logic:iterate标签如何使用bean:define标签创建的新属性values:
<logic:iterate ><bean:write property="id"/><br/> </logic:iterate>
下面的代码片段示例了JSP脚本如何使用bean:define标签创建的新scripting变量values:
<%Person p = new Person();for(int i=0;i<values.size();i++){ p = (Person)values.get(i);out.println(p.getId());out.println("<br/>");} %>
回页首
bean:header标签取回请求中名称为name的header的值。如果没有指定multiple属性则依据刚取回的值创建一个String类型的bean。如果指定了multiple属性则依据刚取回的值创建一个String[]类型的数组。然后用id属性值将String或String[]绑定到page作用域中(这种绑定是为了其它标签能够使用该值)，并创建对应的scripting变量(这种变量是为了JSP脚本能够使用该值)。
下面是我的浏览器发送的header的内容，这些内容和浏览器有关，因此您的浏览器发送的内容可能和下面列出的不同。不过这没有关系，因为要理解bean:header标签您只要对这些内容有一个大概的认识就足够了。
accept: */* accept-language: zh-cnaccept-encoding: gzip, deflate user-agent: Mozilla/4.0 (compatible; MSIE 6.0; //应该在同一行 Windows NT 5.1; SV1; .NET CLR 1.1.4322)host: localhost:8080 connection: Keep-Alive
下面的代码片段示例了如何使用bean:header标签读取名为User-Agent的header的值，并且使用了两种方式进行了输出：
<logic:present header="User-Agent"> <!-- 其它标签通过绑定到page作用域中的属性使用该值 -->您的浏览器是<bean:header /> <bean:write />。<br/><!-- JSP脚本通过scripting变量使用该值 --><% out.println("您的浏览器是"+userAgent+"。<br/>");%></logic:present>
回页首
bean:include标签对指定url(由forward、href或page确定)处的资源做一个请求，将响应数据作为一个String类型的bean绑定到page作用域，同时创建一个scripting变量。我们可以通过id值访问它们。
下面的代码片段示例了bean:include标签的用法，其中include.txt文件包含要include的内容，然后将这些内容输出:
<bean:include page="/include.txt"/> <!-- 其它标签通过绑定到page作用域中的属性使用该值 --><bean:write /><br/> <!-- JSP脚本通过scripting变量使用该值 --><%out.println(value);%>
bean:message标签用来从指定的locale中取回国际化的消息并输出，在这个过程中我们还可以传递五个以内的参数。message key可以通过key直接指定，也可以通过name和property间接的指定。
bean:message标签有两种指定message key的方式，一是通过key属性直接指定；二是通过name和property属性间接的指定，其中message key是在message resources文件中定义的。
我们可以在struts-config.xml文件中使用<message-resources>来设置message resources文件。
为了介绍该标签我使用了三个message resources文件，三个文件的名字分别为Resources.properties、Resources_en.properties和Resources_zh.properties。在struts-config.xml文件中的设置(这里不用设置三个，struts会依据locale自动找到对应的文件)如下：
<message-resources parameter="Resources" />
三个message resources文件中定义的message key为：
<!-- Resources.properties --> resource=Resources.properties.from=Resources.properties. <!-- Resources_en.properties -->from=Resources_en.properties. <!-- Resources_zh.properties因为文件的编码被限制为ISO8859所以要有汉字必须用jdk的native2ascii提前转换 -->from=Resources_zh.properties.
下面的代码片段示例了bean:message标签的用法:
<bean:message key="from"/><br/> <bean:message key="resource"/><br/> <html:link action="/locale?language=en">English</html:link> <html:link action="/locale?language=zh">Chinese</html:link>
上面的代码中含有改变locale的两个html:link标签，要使它们工作您的struts-config.xml文件中必须含有下面定义的form和action:
<form-bean type="org.apache.struts.action.DynaActionForm"> <form-property type="java.lang.String" /> <form-property type="java.lang.String" /><!--action成功后要跳到那里--> <form-property type="java.lang.String"initial="/message.jsp"/> </form-bean> <action path="/locale" type="org.apache.struts.actions.LocaleAction" scope="request"></action>
在不同的locale下我们得到了如下的两个结果：
在locale为zh时的结果： Resources_zh.properties.Resources.properties.在locale为en时的结果： Resources_en.properties.Resources.properties.
让我们来看一下在locale为zh时如何得到的是上面的结果。因为locale为zh所以<bean:message key="from"/><br/>先找Resources_zh.properties这个文件从中得到form键的值。而<bean:message key="resource"/><br/>也会先找Resources_zh.properties这个文件但这次没有找到resource键，这时Struts会到Resources.properties这个文件中找，很幸运这里找到了。如果还没有找到，或message resource文件不存在就会抛出异常。当locale为en时类似，您可以自己试试。
回页首
bean:page标签将页上下文中的application、config、request、response 或 session取出，然后用id属性值将它们绑定到page作用域中(这种绑定是为了其它标签能够使用该值)，并创建对应的scripting变量(这种变量是为了JSP脚本能够使用该值)。
下面的代码片段示例了bean:page标签取出response，然后使用bean:write标签将response的characterEncoding和contentType属性输出：
<bean:page property="response"/> <!-- 其它标签通过绑定到page作用域中的属性使用该值 --> <bean:write property="characterEncoding"/><br/> <bean:write property="contentType"/><br/> <!-- JSP脚本通过scripting变量使用该值 --><% String characterEncoding = res.getCharacterEncoding(); String contentType = res.getContentType(); out.println(characterEncoding+"<br/>"); out.println(contentType+"<br/>");%>
您可以用和上面类似的代码访问application、config、request 或 session中的任何一个对象。
回页首
bean:parameter标签取回请求中的参数值。如果没有指定multiple属性则依据刚取回的值创建一个String类型的bean。如果指定了multiple属性则依据刚取回的值创建一个String[]类型的数组。然后用id属性值将String或String[]绑定到page作用域中(这种绑定是为了其它标签能够使用该值)，并创建对应的scripting变量(这种变量是为了JSP脚本能够使用该值)。
下面的两个代码片段使用相同的url传递参数，url的形式为http://127.0.0.1:8080/struts-demo/parameter.jsp?param=1¶m=2¶m=3。前面的代码片段中没有指定multiple属性，因此p是String类型而且仅仅读取了参数的第一个值。后面的代码片段中指定了multiple属性的值，因此ps是String[]类型的包含所有参数的值。
<bean:parameter /> <bean:write />
<bean:parameter multiple="true" /> <logic:iterate ><bean:write /><br/></logic:iterate>
回页首
bean:resource标签取回指定的web应用程序的资源，以InputStream或String的形式保存到page作用域中并且创建scripting变量。采用什么形式取决于标签的input属性，如果指定input则以InputStream的形式保存，如果没有指定input则以String的形式保存。
下面的两个代码片段示例了bean:resource标签，其中resource.txt是要使用的资源文件。前面的代码片段中没有指定input属性，因此以String的形式处理资源文件，bean:write标签输出资源文件的内容。后面的代码片段中指定了input属性的值，因此以InputStream的形式使用资源文件，两个bean:write标签分别输出InputStream对象的实例名(如java.io.ByteArrayInputStream@16dadf9)和类名(如class java.io.ByteArrayInputStream)。
<bean:resource /> <!-- 其它标签通过绑定到page作用域中的属性使用该值 --><bean:write /><br/> <!-- JSP脚本通过scripting变量使用该值 --><%out.println(str+"<br/>");%>
<bean:resource input="true" /> <!-- 其它标签通过绑定到page作用域中的属性使用该值 --><bean:write /><br/> <bean:write property="class"/><!-- JSP脚本通过scripting变量使用该值 --><% out.println(is+"<br/>");out.println(is.getClass()+"<br/>");%>
回页首
bean:size标签创建一个java.lang.Integer类型的bean，这个bean的值为该标签指定的Collection或Map中所含元素的个数。 这可以和logic:iterate标签配合使用，因为logic:iterate标签不能得到所叠代的集合的元素的个数，这有时候很不方便。
下面的代码片段示例了bean:size标签取出persons中还有元素的个数，其中listForm和persons的定义参见bean:define标签部分：
<logic:notEmpty property = "persons"> <bean:size property = "persons"/><bean:write /> </logic:notEmpty>
回页首
bean:struts标签取回Struts的内部对象formBean、forward或mapping的值，然后用id绑定到page作用域中(这种绑定是为了其它标签能够使用该值)，并创建对应的scripting变量(这种变量是为了JSP脚本能够使用该值)。
下面的代码片段示例了bean:struts标签取出listForm对象，让我们先来看一下listForm的定义在读代码：
<!-- listForm的定义<form-bean type="org.solo.struts.form.ListForm" /> --> <bean:struts formBean="listForm"/> name:<bean:write property="name"/><br/> type:<bean:write property="type"/><br/> dynamic:<bean:write property="dynamic"/><br/>
上面代码运行的结果为：
name:listForm type:org.solo.struts.form.ListFormdynamic:false
回页首
bean:write标签将指定的bean的属性值写到当前的JspWriter中，并且可以对输出进行格式化。
下面的代码片段示例了bean:write标签输出User-Agent：
<logic:present header="User-Agent"> <bean:header /><bean:write /></logic:present>
下面的代码片段示例了bean:write标签格式化输出当前日期，其中now是在DataForm中定义的一个java.util.Date类型的域(值为new Date())，format.date.standard是在资源文件中的一个键(format.date.standard=yyyy-MM-dd)：
<bean:define property="now"/> <br/><bean:write /> <br/><bean:write format="MM/dd/yyyy"/> <br/><bean:write formatKey="format.date.standard"/>
上面代码运行的结果为：
Sun Jun 04 17:04:05 CST 2006 06/04/20062006-06-04
回页首
虽然这里的标题是html:base标签，但是这里也是这篇指南要介绍的第一个Struts html标签。因此我想在这里从整体上简单的介绍一下，最后给出一个对照表。其中的绝大多数标签就不一一介绍了，要介绍的也不会在这里介绍，而是将其独立出来以显重要性。
从用户处收集数据是动态web应用非常重要的一个方面，因此构建输入表单也就自然而然的成为struts框架的一个重要内容。Struts html标签库含有创建Struts输入表单的标签，和其它标签库(bean、logic、nested和tiles)中的标签一起协作就可以产生基于html的用户界面。
下面的对照表会使您对Struts html标签库有一个整体的印象：
图示 1. Struts HTML标签和HTML元素对照表
回页首
html:cancel标签生成一个取消按钮。当点击该按钮后action servlet会绕过相应的form bean的validate()方法，同时将控制权交给相应的action。在该action中可以使用Action.isCancelled(HttpServletRequest)方法判断是否被取消了。如果返回true表示这个action被取消了，否则表示这个action没有被取消。
请注意，如果您修改了html:cancel标签的property属性值，那么struts提供的cancel探测机制就失效了，您自己必须提供类似的机制。
下面是可取消的action的配置文件，注意<set-property property="cancellable" value="true"/>这一行，如果不添加Struts会抛出org.apache.struts.action.InvalidCancelException异常。这是我在完成本指南的过程中发现的唯一向下不兼容的地方。
<action path="/cancel" type="org.solo.struts.action.CancelAction"scope="request"> <set-property property="cancellable" value="true"/> <forward path="/cancel.jsp" /></action>
下面是html:cancel标签的代码：
<html:cancel>取消</html:cancel>
下面是对应的action中的代码：
if(isCancelled(request)){ //action被取消时要做的事情写在这里return mapping.findForward("cancel");}else{ //action没有被取消时要做的事情写在这里return mapping.findForward("success");}
回页首
html:select标签生成一个select元素。是单选还是多选取决于该标签的multiple属性。如果指定了multiple="true"则为多选，此时对应的属性应该是一个数组。如果没有指定multiple="true"则为单选，此时对应的属性应该是标量。
注意：为了正确的处理没有做任何的选择的情况，在ActionForm中的reset()方法中必须将标量属性设置为默认值而将数组的长度置为0。
另外的一个重要问题就是struts如何生成option元素了，这个任务struts交给了html:option、html:options和html:optionsCollection三个标签。
html:option标签
html:option标签生成一个HTML的option元素。该标签必须嵌在html:select标签中。它的显示文本来自其标签体，也可以来自于资源文件。它的value属性用来指定什么值将要被提交。
<html:option value="one">one</html:option> <html:option value="two">two</html:option>
html:options标签
html:options标签生成多个HTML的option元素。该标签必须嵌在html:select标签中。而且工作方式有些特殊，它的name与property属性和其它标签的name与property属性意义不一致，让我们具体看一下它的工作方式。
指定collection属性
没有指定collection属性
指定collection属性
让我通过示例来介绍在指定collection属性时该标签的工作方式，首先要说明selectForm中的persons和listForm中的persons完全一致。请参见bean:define标签。
下面的代码先利用bean:define标签将selectForm中的persons取到page作用域中，然后html:options标签再依据collection="personCollection"选中这个persons并将其中的每一个对象(Person类型)生成一个option元素。该标签的property="id"表示persons中的对象(Person类型)的id属性将作为option元素的value值。该标签的labelProperty="name"表示persons中的对象(Person类型)的name属性将作为option元素的label值。
当这个select提交时所选择的值将被提交到selectForm(name="selectForm")中的person对象(这是在SelectForm中声明的一个Person类型的域专门用来接收提交的值)的id属性中(property="person.id")。
<bean:defineproperty="persons"/> <html:select property="person.id" size="1"> <html:options collection="personCollection" property="id" labelProperty="name"/></html:select>
没有指定collection属性
让我通过示例来介绍没有指定collection属性时该标签的工作方式，先来看看ids和names的定义：
private List<String> ids = null; private List<String> names = null;
上面的代码来自SelectForm，其中ids是一个String的列表，names也是一个String的列表。我们暂时假定这两个列表含有相同数目的元素。有了这些让我们开始介绍下面的代码。html:options标签用ids中的第i个值作为option元素的value值同时使用names中相同位置的值(第i个值)作为option元素的label值。如果ids比names长那么多出的ids中的值将即作为option的value又作为option的label。如果ids比names短那么多出的names的值会被丢掉。
当这个select提交时所选择的值将被提交到selectForm(name="selectForm")中的person对象(这是在SelectForm中声明的一个Person类型的域专门用来接收提交的值)的id属性中(property="person.id")。
<html:select property="person.id" size="1"> <html:options property="ids" labelProperty="names"/></html:select>
html:optionsCollection标签
html:optionsCollection标签生成多个HTML的option元素。该标签必须嵌在html:select标签中。它的功能和html:options标签的相同，但是它的name与property属性和其它标签的name与property属性意义一致，理解起来比较自然。
让我通过示例来介绍html:optionsCollection标签的用法。首先依据name="selectForm"和property="persons"取到selectForm中的persons列表，然后将列表中的对象(Person类型)的id属性作为option元素的value值(value="id")，将列表中的对象(Person类型)的name属性作为option元素的label值(label="name")。
<html:select property="person.id" size="1"> <html:optionsCollection property="persons"label="name" value="id"/> </html:select>
下面是一个多选的示例，虽然示例中使用了html:options标签，但是html:option和html:optionsCollection也能够用来多选。而且您还必须意识到html:option、html:options和html:optionsCollection这三个标签可以同时使用。代码中的personIds是SelectForm中声明的一个String[]类型的数组用来接收提交的多个值。
<html:select property="personIds"multiple="true" size="2"> <html:options property="ids" labelProperty="names"/></html:select>
回页首
html:check标签生成一个checkbox。这里的value值可以是true，yes或on。如果您要提交其它的值(如某种形式的标识)应该考虑使用html:multibox标签。
注意:为了正确的处理没有选中的checkbox您必须在reset()中设置对应的属性为false。
下面的代码示例了html:checkbox标签的用法，其中CheckboxForm中声明了三个boolean类型的域，如下：
private boolean one = false;private boolean two = false; private boolean three = false;
<html:checkbox property="one"> One</html:checkbox><html:checkbox property="two">Two </html:checkbox><html:checkbox property="three">Three </html:checkbox>
如果选中后被提交则相应的属性的值为true。
html:radio标签生成一个radio。主要的用法有两种，下面我们通过代码来示例。
下面的代码示例了html:radio标签的一般用法，如果被提交则选中的radio的value值将被提交到radioForm中的id中。
<html:radio property="id" value="00001"> One</html:radio><html:radio property="id" value="00002">Two </html:radio>
下面的代码示例了html:radio标签的典型用法，其中的persons和bean:define标签中的一致，您可以参考bean:define标签。我只介绍这个<html:radio idName="person" property="id" value="id">，idName指定html:radio要使用的bean(这里为person)，value="id"表示person的id属性将作为radio元素的value值而property="id"表示提交时选中的radio的值将被提交给radioForm中的id属性。
<logic:notEmpty property="persons"> <logic:iterate property="persons"> <html:radio idName="person" property="id" value="id"> <bean:write property="name"/></html:radio></logic:iterate> </logic:notEmpty>
回页首
html:multibox标签生成多个checkbox。当您要使用大量的checkbox时使用这个标签非常方便，可以使您避免在ActionForm中声明大量的boolean类型的变量，带之以一个数组就行了。
注意:为了正确的处理没有选中的checkbox您必须在reset()中设置数组的长度为0。
下面的代码示例了html:multibox标签的一般用法，如果被提交则选中的所有checkbox的value值将被提交到multiboxForm中的selectedItems中，这是一个String[]数组。
<html:multibox property="selectedItems" value="00001"/><html:multibox property="selectedItems"value="00002"/>
下面的代码示例了html:multibox标签的典型用法：
<logic:iterate property="persons"> <html:multibox property="selectedItems"><bean:write property="id"/> </html:multibox><bean:write property="name"/></logic:iterate>
回页首
html:link标签生成一个锚点(<a>)元素。我从html:link标签如何构造基本url和如何构造query参数两个方面来介绍这个标签。
构造基本url是依据该标签的如下四个属性进行的，这四个属性一次只能出现一个。让我们看看它们：
forward，指定一个全局ActionForward的名称。另外如果forward是module相关的则该forward必须指向一个action而不能是一个页面。
action，指定一个Action的名称。
href，struts会直接使用这个值而不会对其进行任何处理。
page，指定一个页面的路径，必须以/开始。
构造query参数，下面列举了可能的形式，其中baseurl只是一个占位符：
baseurl?p=00001(单参单值)
baseurl?p1=00001&p2=00002&p3=00003(多参单值)
baseurl?p=00001&p=00002&p=00003(单参多值)
baseurl?p1=00001&p2=00002&p=00001&p=00002&p=00003(混合)
下面我们以代码示例来说明每一种html:link的用法，首先让我们花点时间看看相关action中的代码：
<!-- 下面所有代码的数据都是在这里构造的 --> public ActionForward execute(ActionMapping mapping,ActionForm form, HttpServletRequest request,HttpServletResponse response) { DataForm dataForm = (DataForm) form;dataForm.setParam("00001"); HashMap paramSingleMap = new HashMap();paramSingleMap.put("p1","00001"); paramSingleMap.put("p2","00002");paramSingleMap.put("p3","00003"); dataForm.setParamSingleMap(paramSingleMap); HashMap paramMultiMap = new HashMap(); paramMultiMap.put("p",new String[]{"00001","00002","00003"}); dataForm.setParamMultiMap(paramMultiMap);HashMap paramSMMap = new HashMap(); paramSMMap.put("p1","00001");paramSMMap.put("p2","00002"); paramSMMap.put("p",new String[]{"00001","00002","00003"}); dataForm.setParamSMMap(paramSMMap); List<Person> persons = new ArrayList<Person>(); Person person1 = new Person();person1.setId("00001");person1.setName("赵辰"); Person person2 = new Person();person2.setId("00002");person2.setName("李为芳"); Person person3 = new Person();person3.setId("00003");person3.setName("王微"); persons.add(person1);persons.add(person2);persons.add(person3); dataForm.setPersons(persons);return mapping.findForward("success");}
<!-- 这用来设置一个位置 --><html:link linkName="top"/> <!-- 这用来定位到上面的那个位置 --> <html:link page="/link.do" anchor="top">Go Top</html:link>
<html:link page="/link.do" paramId="p" paramName="dataForm" paramProperty="param">单参单值</html:link><br/> <html:link page="/link.do" property="paramSingleMap">多参单值 </html:link><br/> <html:link page="/link.do" property="paramMultiMap">单参多值 </html:link><br/> <html:link page="/link.do" property="paramSMMap">混合</html:link>
下面的代码示例了html:link标签的indexed属性和indexId属性的用法，这两个属性只有html:link标签嵌套在logic:iterate标签中时才可用。
<logic:iterate property="persons"> <html:link action="/link.do" paramId="person" paramName="person" paramProperty="id" indexed="true" indexId="number">person</html:link> <br/></logic:iterate><!-- 下面是上面代码的运行结果(产生的html) <a href="/struts-demo/link.do?person=00001&number=0">赵辰</a><br/> <a href="/struts-demo/link.do?person=00002&number=1">李为芳</a><br/> <a href="/struts-demo/link.do?person=00003&number=2">王微</a><br/> 其中的number是由indexId="number"确定的，而该参数的值为元素在集合中的位置。-->
html:rewrite标签和html:link标签类似只是不生成锚点(<a>)，而是简单的输出字符串。
回页首
html:errors标签和html:messages标签的功能相似，所以我们放到一起来介绍。
html:errors标签将由name属性指定的ActionMessages、ActionErrors、String和String[]直接输出到页面中。
html:messages标签将用由name属性(注意message属性值对它的影响)指定的ActionMessages、ActionErrors、String和String[]创建一个新的属性和scripting变量，使用id属性值作为名称。
html:errors标签和html:messages标签的property属性是用来为errors和messages分类的。我们可以给这两个标签指定property属性，以便只显示某一类的错误或消息。
在资源文件增加了如下的内容：
# -- standard errors -- errors.header=<ul>errors.prefix=<li>errors.suffix=</li> errors.footer=</ul>error=error with none value . error1=error1 with one value is {0} . error2=error2 with two values are {0} , {1} . error3=error3 with three values are {0} , {1} , {2} . error4=error4 with four values are {0} , {1} , {2} ,{3} .
下面的代码示例了actionErrors的构造：
public ActionErrors validate(ActionMapping mapping, HttpServletRequest request) {ActionErrors actionErrors = new ActionErrors(); actionErrors.add("property1",new ActionMessage("error")); actionErrors.add("property2",new ActionMessage("error1","value0")); actionErrors.add("property2",new ActionMessage("error2","value0","value1")); actionErrors.add("property3", new ActionMessage("error3","value0","value1","value2")); actionErrors.add("property3", new ActionMessage("error4","value0","value1","value2","value3")); actionErrors.add("property4", new ActionMessage("error1",new Object[]{"value0"})); actionErrors.add("property4", new ActionMessage("error2",new Object[]{"value0","value1"})); actionErrors.add("property4", new ActionMessage("error3",new Object[]{"value0","value1","value2"})); actionErrors.add("property5", new ActionMessage("error4",new Object[]{"value0","value1","value2","value3"})); actionErrors.add("notBundle",new ActionMessage("not a bundle key",false)); return actionErrors;}
errors标签代码示例：
<html:errors/><br/> <html:errors property="property4"/>
messages标签代码示例：
<logic:messagesPresent> <ul><html:messages ><li><bean:write /></li> </html:messages></ul></logic:messagesPresent><br/> <logic:messagesPresent><ul> <html:messages property="property4"> <li><bean:write /></li></html:messages></ul> </logic:messagesPresent>
图示 2. 上面的两段代码示例运行结果相同，如下所示：
回页首
html:javascript标签生成用于校验的javascript脚本代码。
下面的代码片段示例了html:javascript标签的基本用法，其中formName属性的值是在validation.xml文件的<formset>中定义的form的名称。有一点值得注意的是在确定<formset>时要使用合适的language属性值。
<html:javascript formName="dataForm"/>
回页首
html:xhtml标签在页面中一出现就是告诉该页的所有其它的Struts html标签以XHTML1.0兼容的形式输出。这和将html:html标签的xhtml属性值指定为true有些类似。如果上述情况都没有出现，Struts html标签将以html4.01兼容的形式输出。
回页首
logic:iterate标签用来迭代集合，您可以使用如下方式来为这个标签指定其要叠代的集合：
使用一个运行时表达式，这个表达式的值是一个集合。
用name属性引用一个JSP Bean，这个JSP Bean本身就是一个集合。
用name属性引用一个JSP Bean，这个JSP Bean的一个属性是一个集合，这时可以联合使用property来指定这个集合。
上面所提到的集合可以是：
对象类型或原子类型的数组(Array)。
java.util.Collection的实现，包括ArrayList，Vector。
java.util.Enumeration的实现。
java.util.Iterator的实现。
java.util.Map的实现，包括HashMap，Hashtable和TreeMap。
如果您叠代的集合中含有null的值，这时需要采取一定的措施，因为这时logic:iterate不会在page作用域中创建对象。一般是使用<logic:present>标签或<logic:notPresent>标签来判断一下。
下面是logic:iterate叠代ArrayList的示例的对象引用关系和部分代码：
图示 3. logic:iterate中对象的引用关系
图中的persons列表是在ListAction中填充的，在这里只是简单的加入了三个Person对象，在实际的应用中这些数据应该取自数据库。具体的代码如下：
public ActionForward execute(ActionMapping mapping,ActionForm form, HttpServletRequest request, HttpServletResponse response) { ListForm listForm = (ListForm) form; List<Person> persons = new ArrayList<Person>(); Person person1 = new Person();person1.setId("00001");person1.setName("赵辰"); Person person2 = new Person();person2.setId("00002");person2.setName("李为芳"); Person person3 = new Person();person3.setId("00003");person3.setName("王微"); persons.add(person1);persons.add(person2);persons.add(person3); listForm.setPersons(persons);return mapping.findForward("success");}
标签输出的结果为：
00001-->赵辰00002-->李为芳00003-->王微
回页首
如果指定的值出现该标签就会创建其标签体内的内容。该标签用于以下情况：
检查具有指定名称的cookie是否出现。
检查具有指定名称的header是否出现。
检查具有指定名称的JSP Bean是否出现 或 检查具有指定名称的JSP Bean中的property属性是否出现。
检查request中指定名称的参数是否出现。
检查当前的认证用户是否与指定的安全角色相关联。
检查当前认证的主体是否具有指定的名字。
下面的代码示例了logic:present标签检查具有指定名称User-Agent的header是否出现：
<logic:present header="User-Agent">您的浏览器是<bean:header /> <bean:write />。<br/></logic:present>
logic:notPresent标签的应用正好和logic:present标签相反。
回页首
logic:messagesPresent标签用于以下情况：
在request作用域中存在一个ActionMessages对象，标签的property属性和ActionMessages中的property对应。
在request作用域中存在一个ActionErrors对象，标签的property属性和ActionErrors中的property对应。
存在一个String对象，将其转换(构造)成ActionMessage然后在添加到ActionMessages中。
存在一个String Array对象，将数组中的每一个String转换成一个ActionMessage，在将其添加到ActionMessages中。
标签的message属性
分享到：
发表评论
相关推荐
struts1标签struts1标签struts1标签struts1标签struts1标签struts1标签struts1标签struts1标签struts1标签struts1标签struts1标签struts1标签struts1标签struts1标签struts1标签struts1标签struts1标签
struts标签库struts标签库struts标签库struts标签库struts标签库struts标签库struts标签库struts标签库
struts1标签及实例：对struts1标签详细讲解和用实例进行实践
对struts1的标签库进行总结，可以熟悉对struts1标签库的运用，更好的熟悉struts1编程
Struts1标签库内容详细， 1现在用的很少了， 在这里备份一下
struts1 标签
struts1标签判断奇偶数实例
struts1标签.docstruts1标签.docstruts1标签.docstruts1标签.docstruts1标签.docstruts1标签.docstruts1标签.docstruts1标签.doc
struts1 标签手册
Struts1 标签手册，5类标签库，html,nested,logic,bean,titles
struts1标签.pdf
struts1标签
struts1标签中文文档,对开发来说有不小的帮助
struts1标签库知识 初步大概了解struts标签的功能 ！
里面包含了Struts1各种常用标签和使用方法，对初学者很实用。
Struts1标签的详细说明，及使用举例，总结了常用的到一些情况的处理。
jsp struts1 标签实例详解第1 2页.docx
struts2标签库struts2标签库struts2标签库struts2标签库
struts 部分标签的详细用法，logic bean html