WebWork标签手册.doc

WebWork标签库一、数据标签数据标签可以从值栈中获取数据之余，还可以将变量和对象存储于值栈中。1、property标签功能：输出OGNL表达式的值属性：l valueObject进行求值的表达式，如果未指定该属性，则将被设定为topl defaultString如果依据value无法得到值，则使用default指定的默认值l escapeBoolean确定是否将输出的内容进行HTML转义2、set标签功能：用于对值栈中的表达式进行求值，并将结果赋给特定作用域中的某个变量名。属性：l name String在一个指定的作用域内被赋值的变量名l valueObject希望用于赋值的表达式l scopeString可选的值为：application、session、request、page或default。默认（default）即action context，set标签将对象放置于action context中。其他4种作用域直接对应于servlet应用程序的4个作用域。范例：使用property标签访问存储在session中的User对象的多个字段：但每次都重复使用#sessionuser，更好的做法是定义一个临时变量：3、push标签功能：将对象的引用压入值栈，当需要围绕单个对象做大量操作的时候，可以将对象压入值栈之后直接对其进行操作。属性：l valueObject需要压入值栈的值所对应的表达式范例：上例也可以进行如下操作：再如：用同一个页面输出不同实例的属性Test_push_include1.jspName PageTest_push_include2.jspName PagePush_include.jspReg pageLogin Info4、bean标签功能：创建简单的JavaBean，并将其压入值栈中，在bean标签的起始与结束标记之间，除了可以将JavaBean压入值栈之外，还可以任意地把JavaBean赋值给某个变量，以便让其在action context中能够访问，实现类似set标签的功能。属性：l nameString被创建的bean对应的包和类名l idString如果需要在bean标签的范围之外引用bean对象，那么就应当通过id属性设置引用名称参数：bean标签可以包含param标签，可以通过提供的参数定制标签，设定bean的属性。范例：InnerMongolia HuhehotInner:Username:E-mail:Address:Out:Username:E-Mail:Address:5、action标签功能：在JSP页面中执行action并访问相应的数据。默认情况下，action标签并不执行action的result，这样可以让那些可能呈现另外一个不同页面的action能够正常工作。属性：l nameStringaction名l namespaceStringaction的namespace，默认值为当前页面所在的namespacel idString引用action bean所需的名称，以便在页面后面的部分引用l executeResultBoolean当设置为true时，会执行action对应的result，默认为false。范例：List PageUser Registor:二、控制标签1、iterator标签功能：循环遍历任何集合对象，包括Collection、Map、Enumeration、Iterator及array（数组），同时也可以在action context中定义一个变量，用于确定与当前循环状态相关的基本信息。属性：l valueCollection、Map、Enumeration、Iterator或array被循环遍历的对象l statusString如果设置了该属性，IteratorStatus对象就会被放置在action context中。IteratorStatus源代码：package com.opensymphony.webwork.views.jsp;public class IteratorStatus protected StatusState state; public IteratorStatus(StatusState aState) state = aState; public int getCount() return state.index + 1; public boolean isEven() return (state.index + 1) % 2) = 0; public boolean isFirst() return state.index = 0; public int getIndex() return state.index; public boolean isLast() return state.last; public boolean isOdd() return (state.index + 1) % 2) = 1; public int modulus(int operand) return (state.index + 1) % operand; public static class StatusState boolean last = false; int index = 0; public void setLast(boolean isLast) last = isLast; public void next() index+; 范例：使用IteratorStatus。List Page2、if标签和else标签功能：控制输出呈现，可以单独使用if标签，也可以结合elseif标签和else标签一起使用，else标签没有任何属性，而if和elseif只有一个属性test。属性：l testBoolean用于求值并返回true或false的布尔表达式。范例：List Page三、杂项标签1、include标签功能：可参数化的include标签，与WebWork集成在一起提供更多的高级特性。属性：l valueString页面名称、action、servlet或任何可引用的URL。优点： 提供对值栈的访问能力 提供更具扩展性的参数模型如：包含一个页面，同时利用值栈对该页面中使用了%符号的内容进行求值。也可以使用标签对include标签增加参数，而param标签同样以来于值栈，比标签更易于使用。2、URL标签功能：生成使用相对路径或者绝对路径的URL，处理参数，以及对URL进行编码，以便让没有启用cookie的浏览器使用。属性：l valueString基本的URL，用来生成URL的基本信息，默认值为生成当前页面的URL。l includeParamsString从all、get或none中选择参数，默认为get。在默认情况下，WebWork包含当前页面的所有查询字符串；如果不希望包含任何参数，那么将该属性设置为none；可以通过设置为all，使得所有参数都可用于URL的生成，包括通过post提交的参数。l idString如果指定了该属性，那么URL将不会输出，而是会保存于action context，以作后用。l includeContextBoolean如果为true，那么生成的URL前面会加上应用程序所在的上下文（context）路径，默认为true。l encodeBoolean如果访问者并没有启用cookie，那么将会在URL中增加session ID。l schemeString可以指定协议，默认为当前的设置（HTTP或者HTTPS）。WebWork使用默认的80端口监听HTTP请求，而使用443端口监听HTTPS端口，如果要更改，可以在perties文件中重新定义。webwork.url.http.port = 8080webwork.url.https.port = 8081范例：URL标签结果/7_tag_url/ /7_tag_url//search?q=javajavaa href=search java in sinasearch java in sinaa href=Test1Test1a href=Test1Test13、i18n和text标签国际化支持 text标签功能：显示特定语言的文本，是基于键查询的标签属性：l nameString用于在ResourceBundle中进行查找的键。l idString如果设置了该属性，则文本内容将会存储于action context中，可以通过属性值的名称进行引用。l value0Object参数1l value1Objec