Struts标签总结.doc

HTML标记
Struts HTML标记可以大致地分为以下几个功能：
l 显示表单元素和输入控件
l 显示错误信息
l 显示其他HTML元素
显示表单元素和输入控件
struts将HTML表单与为表单操作而定义的ActionForm bean紧密联系在一起。表单输入字段的名称与ActionForm bean里定义的属性名称是对应的。当第一次显示表单时，表单的输入字段是从ActionForm bean中移植过来的，当表单被提交时，请求参数将移植到ActionForm bean实例。
所有可以在ript事件处理器。
属性
描述
Onblur
字段失去了焦点
Onchange
字段失去了焦点并且数值被更改了
Onclick
字段被鼠标点击
Ondblclick
字段被鼠标双击
Onfocus
字段接收到输入焦点
Onkeydown
字段拥有焦点并且有键按下
onkeypress
字段拥有焦点并且有键按下并释放
Onkeyup
字段拥有焦点并且有键被释放
onmousedown
鼠标指针指向字段并且点击
onmousemove
鼠标指针指向字段并且在字段内移动
onmouseout
鼠标指针指向控件，但是指针在元素外围移动
onmouseover
鼠标指针没有指向字段，但是指针在元素内部移动
Onmouseup
鼠标指针指向字段，并且释放了鼠标按键
元素中能够被定义的其他一般属性有：
属性
描述
Accesskey
定义访问输入字段的快捷键
Style
定义输入字段的样式
styleClass
定义输入字段的样式表类
Tabindex
输入字段的tab顺序
表单标记
标记用来显示HTML标记，可以指定AcitonForm bean的名称和它的类名。如果没有设置这些属性，就需要有配置文件来指定ActionMapping以表明当前输入的是哪个JSP页，以及从映射中检索的bean名和类。如果在ActionMapping指定的作用域中没有找到指定的名称，就会创建并存储一个新的bean，否则将使用找到的bean。
标记能够包含与各种HTML输入字段相对应的子标记。
标记属性如下：
属性
描述
Action
与表单相关的操作。在配置中，这个操作也用来标识与表单相关的ActionForm bean
Enctype
表单HTTP方法的编码类型
Focus
表单中需要初始化焦点的字段
Method
表单使用的HTTP方法
Name
与表单相关的ActionForm bean的名称。如果没有设置这个属性，bean的名称将会从配置信息中获得
Onreset
表单复位时的JavaScript事件句柄
Onsubmit
表单提交时的JavaScript事件句柄
Scope
搜索ActionForm bean的范围。如果没有设置，将从配置文件中获取
Style
使用的格式
styleClass
这个元素的格式表类
Type
ActionForm bean的完整名称。如果没有设置，将从配置文件获得
例如：

与表单相关的操作路径是validateEmployee,而表单数据是通过POST传递的。对于这个表单来说，ActionForm bean的其他信息，如bean名称类型，作用域，都是从表单指定操作的ActionMapping中检索得到的：

me=”empForm”
scope=”request”
input=”/employeeInput.jsp”>

如果配置文件中包含上述信息，并且请求URI的*.do被映射到ActionServlet，与表单相关的ActionForm bean的名称，类型和作用域分别是empForm,com.example.EmployeeForm和request.这些属性也可以使用标记属性进行显示的定义。
以下标记必须嵌套在标记里
按钮和取消标记
标记显示一个按钮控件；标记显示一个取消按钮。属性如下：
属性
描述
Property
定义在表单被提交时返回到服务器的请求参数的名称
Value
按钮上的标记
复位和提交标记
和标记分别能够显示HTML复位按钮和提交按钮。
文本和文本区标记
和标记分别HTML文本框和文本区，属性如下：
属性
描述
Property
定义当表单被提交时送回到服务器的请求参数的名称，或用来确定文本元素当前值的bean的属性名称
Name
属性被查询的bean的名称，它决定了文本框和文本区的值。如果没有设置，将使用与这个内嵌表单相关的ActionForm的名称
标记还有以下属性：
属性
描述
Maxlength
能够输入的最大字符数
Size
文本框的大小（字符数）
标记特有的属性如下：
属性
描述
Rows
文本区的行数
Cols
文本区的列数
检查框和复选框标记
标记能够显示检查框控件。标记能够显示HTML复选框控件，请求对象在传递检查框名称时使用的getParameterValues()调用将返回一个字符串数组。属性如下：
属性
描述
Name
Bean的名称，其属性会被用来确定检查是否以选中的状态显示。如果没有设置，将使用与这个内嵌表单相关的ActionFrom bean的名称。
Property
检查框的名称，也是决定检查框是否以选中的状态显示的bean属性名称。在复选框的情况下，这个属性必须是一个数组。
Value
当检查框被选中时返回到服务器的请求参数的值
例如：

一个名为married的检查框，在表单提交时会返回一个”Y”.
文件标记
标记可以显示HTML文件控件。属性如下：
属性
描述
Name
Bean的名称，它的属性将确定文件控件中显示的内容。如果没设置，将使用与内嵌表单相关的ActionForm bean的名称
property
这个属性定义了当表单被提交时送回到服务器的请求参数的名称，以及用来确定文件控件中显示内容的bean属性名称
Accept
服务器能够处理的内容类型集。它也将对客户浏览器对话框中的可选文件类型进行过滤
Value
按钮上的标记，这个按钮能够在本地文件系统中浏览文件
单选钮标记
标记用来显示HTML单选钮控件，属性如下：
属性
描述
Name
Bean的名称，其属性会被用来确定单选钮是否以选中的状态显示。如果没有设置，将使用与这个内嵌表单相关的ActionFrom bean的名称。
property
当表单被提交时送回到服务器的请求参数的名称，以及用来确定单选钮是否以被选中状态进行显示的bean属性的名称
Value
当单选钮被选中时返回到服务器的值
隐藏标记
标记能够显示HTML隐藏输入元素，属性如下：
属性
描述
Name
Bean的名称，其属性会被用来确定隐藏元素的当前值。如果没有设置，将使用与这个内嵌表单相关的ActionFrom bean的名称。
property
定义了当表单被提交时送回到服务器的请求参数的名称，以及用来确定隐藏元素当前值的bean属性的名称
Value
用来初始化隐藏输入元素的值
密码标记
标记能够显示HTML密码控件，属性如下：
属性
描述
maxlength
能够输入的最大字符数
Name
Bean的名称，它的属性将用来确定密码元素的当前值。如果没有设置，将使用与这个内嵌表单相关的ActionFrom bean的名称。
property
定义了当表单被提交时送回到服务器的请求参数的名称，以及用来确定密码元素当前值的bean属性的名称
redisplay
在显示这个字段时，如果相应的bean属性已经被设置了数据，这个属性决定了是否显示密码的内容
Size
字段的大小
选择标记
标记能够显示HTML选择控件，属性如下：
属性
描述
multiple
表明这个选择控件是否允许进行多选
Name
Bean的名称，它的属性确定了哪个。如果没有设置，将使用与这个内嵌表单相关的ActionFrom bean的名称。
property
定义了当表单被提交时送回到服务器的请求参数的名称，以及用来确定哪个选项需要被选中的bean属性的名称
Size
能够同时显示的选项数目
Value
用来表明需要被选中的选项
选项标记(这个元素需要嵌套在标记里)
标记用来显示HTML选项元素集合，属性如下：
属性
描述
collection
Bean集合的名称，这个集合存储在某个作用域的属性中。选项的数目与集合中元素的数目相同。Property属性能够定义选项值所使用的bean属性，而labelProperty属性定义选项标记所使用的bean的属性
labelName
用来指定存储于某个作用域的bean，这个bean是一个字符串的集合，能够定义>元素的标记(如果标志与值不相同)
labelProperty
与collection属性共同使用时，用来定义了存储于某个作用域的bean，这个bean将返回一个字符串集合，能够用来写入元素的value属性
Name
如果这是唯一被指定的属性，它就定义了存储于某个作用域的bean，这个bean将返回一个字符串集合，能够用来写入元素的value属性
property
这个属性在与collection属性共同使用时，定义了每个要显示选项值的独立bean的name属性。如果不是与collection属性共同使用，这个属性定义了由name属性指定的bean的属性名称(如果有name属性)，或是定义了一个ActionForm bean，这个bean将返回一个集合来写入选项的值
我们看一下这个标记的一些例子：

标记假设在某个作用域中有一个名为optionCollection的集合，它包含了一些具有optionValue属性的独立的bean，每个属性将作为一个选项的值。每个选项的标志由bean的optionLabel属性属性进行定义。

标记中optionValues代表一个存储在某个作用域中的bean，它是一个字符串集合，能够用来写入选项的值，而optionLabels代表一个存储在某个作用域中的bean，它也是一个字符串集合，能够用来写入选项的标志。
显示错误信息的标记
标记能够与ActionErrors结合在一起来显示错误信息。这个标记首先要从当前区域的资源文件中读取消息关键字errors.header，然后显示消息的文本。接下去它会在ActionErrors对象(通常作为请求参数而存储在Action.ERROR_KEY关键字下)中循环，读取单个ActionError对象的消息关键字，从当前区域的资源文件中读取并格式化相应的消息，并且显示它们。然后它读取与errors.footer关键字相对应的消息并且显示出来。
通过定义property属性能够过滤要显示的消息，这个属性的值应该与ActionErrors对象中存储ActionError对象的关键字对应。属性如下：
属性
描述
Bundle
表示应用程序作用域属性的名称，它包含着消息资源，其默认值Acion.MESSAGE_KEY
Locale
表示会话作用域属性的名称，它存储着用户当前登录的区域信息。其默认值是Action.ERROR_KEY
Name
表示请求属性的名称，它存储着ActionErrors对象。其默认值是Action.ERROR_KEY
property
这个属性指定了ActionErrors对象中存储每个独立ActionError对象的关键字，它可以过滤消息
例子：

显示集合中所有的错误。

显示存储在missing.name关键字的错误。
其他HTML标记
struts HTML标记还定义了下列标记来显示其他HTML元素：
l ml:html> : 显示HTML元素
l : 显示图象标记
l : 显示HTML链接或锚点
l : 创建没有锚点标记的URI
这些标记的详细内容请参照struts文档。

Bean标记

Bean定义标记：
可定义新bean，可复制现有bean，还可从现有bean复制属性。
标记用来：
l 定义新字符串常数
l 将现有的bean复制到新定义的bean对象
l 复制现有bean的属性来创建新的bean
标记属性：

属性
描述
Id
新定义的bean脚本变量名称，必须设置
Type
定义引入脚本变量的类
Value
为id属性定义的脚本变量分配一个新的对象
Name
目标bean的名称。若value属性没有设置，这个属性就必须设置
property
Name属性定义的bean的属性名称，用来定义新的bean
Scope
源bean的作用域。若没有设置，搜索范围是从页作用域到应用程序作用域
toScope
目标bean的作用域。若没有设置，默认值是页作用域
例如：定义一个bean:

源bean在页作用域中被拷贝大哦请求作用域中的另一个bean:

定义脚本变量的标记
从多种资源中定义和生成作用域为当前页得变量，这些资源包括cookie,请求参数，HTTP标头等等。属性如下：
属性
描述
Id
脚本变量和要定义的页作用域属性的名称
Name
cookie/标头/参数的名称
multiple
如果这个属性设置了任意一个数值，所有匹配的cookie都会被积累并存储到一个Cookie[](一个数组)类型的bean里。若无设置，指定cookie的第一个值将作为Cookie类型的值
Value
如果没有匹配的cookie或数值，就返回这个属性指定的默认值
例如：

脚本变量名称是myCookie，用来创建这个属性的cookie的名称是userName。

脚本变量名称是myHeader,请求标头的名称是Accept-Language.
er” name=”myParameter”>
脚本变量名称是myPatameter,它保存的请求参数的名称也是myParameter.
标记将对一个资源的响应进行检索，并引入一个脚本变量和字符串类型的页作用域属性。这个资源可以是一个页，一个ActionForward或一个外部URL。与的不同是资源的响应被存储到一个页作用域的bean中，而不是写入到输出流。属性如下：
属性
描述
Id
脚本变量和要定义的页作用域属性的名称
Page
一个内部资源
forward
一个ActionForward
Href
要包含的资源的完整URL
例如：

脚本变量的名称是myInclude，要检索的响应来自资源MyJsp?x=1。

标记将检索web应用中的资源，并引入一个脚本变量和InputStream或字符串类型的页作用域属性。如果在检索资源时发生问题，就会产生一个请求时间异常。属性如下：
属性
描述
Id
脚本变量和要定义的页作用域属性的名称
Name
资源的相对路径
Input
如果这个属性不存在，资源的类型就是字符串
例如：
myResource” name=”/WEB-INF/images/myResource.xml”/>
脚本变量的名称是myResource，要检索的资源的名称是myResource.xml。

显示Bean属性
标记库中定义了标记，用来将bean的属性输送到封装的JSP页写入器。这个标记与类似，属性如下：
属性
描述
Name
要进行属性显示的bean的名称
property
要显示的属性的名称。如果这个属性类有java.beans.PropertyEditor,getAsText()或toString 方法会被调用
Scope
Bean的作用域，若没有设置，搜索范围是从页到应用程序作用域
Filter
如果设置true,属性中的所有特殊HTML字符都将被转化为相应的实体引用
Ignore
如果设置false，当发现属性时会产生一个请求时间异常，否则返回null
例如：

myBean的属性myProperty将会被显示，作用域为请求，如果发现任何HTML特殊字符都将被转化为相应的实体引用。

消息标记和国际化

逻辑标记
逻辑库的标记能够用来处理外观逻辑而不需要使用scriptlet。Struts逻辑标签库包含的标记能够有条件地产生输出文本，在对象集合中循环从而重复地产生输出文本，以及应用程序流程控制。它也提供了一组在JSP页中处理流程控制的标记。这些标记封装在文件名为struts-logic.tld的标记包中。逻辑标记库定义的标记能够执行下列三个功能：
l 条件逻辑
l 重复
l 转发/重定向响应
条件逻辑
struts有三类条件逻辑。第一类可以比较下列实体与一个常数的大小：
l 数值大小比较
l 判断数据项目是否存在
l 匹配性检查

第一类条件逻辑标记：
以下列出了这一类标记：
标记
功能

如果常数与被定义的实体相等，返回true

如果常数与被定义的实体不相等，返回true

如果常数大于等于被定义的实体，返回true

如果常数小于等于被定义的实体，返回true

如果常数小于被定义的实体，返回true

如果常数大于被定义的实体，返回true

这一类的所有标记有相同的属性
属性
描述
Value
要进行比较的常数值
Cookie
要进行比较的HTTP cookie的名称
Header
要进行比较的HTTP请求标头的名称
parameter
要进行比较的HTTP请求参数的名称
Name
如果要进行比较的是bean或bean的属性，则这个属性代表bean的名称
property
要进行比较的bean属性的名称
Scope
Bean的作用域，如果没有指定作用域，则它的搜索范围是从页到应用程序
例如：

The entered name is SomeName

判断名为”name”的请求参数的值是否是”SomeName”。

The value of bean.Prop is greater than 7

判断在页的作用域中是否有一个名为”bean”的bean，它有一个prop属性，这个属性的值是否大于7。如果这个属性能够转化为数值，就进行数值比较，否则就进行字符串比较。

第二类条件标记定义了两个标记：
l
l
它们的功能是在计算标记体之前判断特定的项目是否存在。标记的属性和属性值决定了要进行检查的项目。
属性
描述
Cookie
由这个属性指定的cookie将被检查是否存在
Header
由这个属性指定的请求标头将被检查是否存在
parameter
由这个属性指定的请求参数将被检查是否存在
Name
如果没有设置property属性，那么有这个属性指定的bean将被检查是否存在。如果设置了，那么bean和bean属性都将被检查是否存在。
property
检查有name属性指定的bean中是否存在指定的属性
Scope
如果指定了bean的名称，这就是bean的作用域。如果没有指定作用域，搜索的范围从页到应用程序作用域。

例如：

The bean property bean.prop is present

标记判断在页作用域中是否存在一个名为”bean”的bean，这个bean有一个prop属性。

第三类条件标记比较复杂，这些标记根据模板匹配的结果检查标记体的内容。换句话说，这些标记判断一个指定项目的值是否是一个特定常数的子字符串：
l
l
这些标记允许JSP引擎在发现了匹配或是没有发现时计算标记主体。属性如下：
属性
描述
Cookie
要进行比较的HTTP cookie的名称
Header
要进行比较的的HTTP标头 的名称
parameter
要进行比较的的HTTP请求参数的名称
Name
若要对bean或bean的属性进行比较，这个属性是用户指定bean的名称
location
如果设置了这个属性的值，将会在这个指定的位置(索引值)进行匹配
scope
如果对bean进行比较，这个属性指定了bean的作用域。如果没有设置这个参数，搜索范围是从页到应用程序作用域
property
要进行比较的bean的属性名称
value
要进行比较的常数值
例如：

The parameter name is a sub-string of the string xyz from index 1

标记检查名为”name”的请求参数是否是”xyz”的子字符串，但是子字符串必须从”xyz”的索引位置1开始（也就是说子字符串必须是”y”或”yz”）。

重复标记
在逻辑标记库中定义了iterate>标记，它能够根据特定集合中元素的数目对标记体的内容进行重复的检查。集合的类型可以是java.util.Iterator,java.util.Collection
,java.util.Map或是一个数组。有三种方法可以定义这个集合：
l 使用运行时间表达式来返回一个属性集合的集合
l 将集合定义为bean，并且使用name属性指定存储属性的名称。
l 使用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的类型
例如：
”
type=”java.lang.Integer”
offset=”1”
length=”2”>
<% =currentint %>

代码将从列表中的第一个元素开始重复两个元素并且能够让当前元素作为页作用域和java.lang.Integer类型的脚本变量来使用。也就是说，如果myList包含元素1，2，3，4等，代码将会打印1和2。
转发和重定向标记
转发标记
forward>标记能够将响应转发给重定向到特定的全局ActionForward上。ActionForward的类型决定了是使用PageContext转发响应，还是使用sendRedirect将响应进行重定向。此标记只有一个”name”属性，用来指定全局ActionForward的名称，例如：

重定向标记
标记是一个能够执行HTTP重定向的强大工具。根据指定的不同属性，它能够通过不同的方式实现重定向。它还允许开发人员指定重定向URL的查询参数。属性如下：
属性
描述
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中的一个属性，以便标明将响应重定向到哪个资源。
模板标记
动态模板是模块化WEB页布局设计的强大手段。Struts模板标记库定义了自定义标记来实现动态模板
插入标记
标记能够在应用程序的JSP页中插入动态模板。这个标记只有一个template属性，用来定义模板JSP页。要插入到模板的页是有多个标记来指定的，而这些标记被定义为标记的主体内容。
放置标记
标记是标记内部使用的，用来指定插入到模板的资源。属性如下：
属性
描述
content
定义要插入的内容，比如一个JSP文件或一个HTML文件
direct
如果这个设置为true，由content属性指定的内容将直接显示在JSP上而不是作为包含文件
Name
要插入的内容的名称
Role
如果设置了这个属性，只有在当前合法用户具有特定角色时才能进行内容的插入。
获得标记
在模板JSP页中使用标记能够检索由标记插入到JSP页的资源。属性如下：
属性
描述
Name
由标记插入的内容的名称
Role
如果设置了这个属性，只有在当前合法用户具有特定角色时才能进行内容的检索
使用模板标记
首先编写一个模板JSP页，它将被所有的web页使用：

<%@ taglib uri=”/template” prefix=”template” %>

ht=”10%”>
t template=”template.jsp”>

这个应用程序JSP页使用标记将特定内容名称指定的资源放到模板JSP页中。如果我们有上百个布局相同的页，但突然想改变这个模板，我们只需要改变template.jsp文件。