struts2标签说明.doc

COLD 的 struts2标签详解要在jsp中使用Struts2的标志，先要指明标志的引入。通过jsp的代码的顶部加入以下的代码：If elseif else描述：执行基本的条件流转。参数： 名称必需默认类型描述备注test是boolean决定标志里的内容是否显示的表达式else标志没有这个参数id否Object/String用来标识元素的id。在UI和表单中为HTML的id属性例子： 60 老年人 35中年人 15 id=wawa青年人少年s:set name=name value=/zhaosoft herezxl hereother is here Iterator（迭代）描述：用于遍历集合（java.util.Collection）或枚举值(java.util.iterator)参数 名称必需默认类型描述status否String 如果设置此参数，一个IteratorStatus的实例将会压入每一个遍历的堆栈value否Object/String要遍历的可枚举的(iteratable)数据源，或者将放入的新列表(List)的对想id否Object/String用来标识元素的id。在ui和表单中为HTML的id属性I18n（国际化操作）描述：加载资源包到值堆栈。它可以允许text标志访问任何资源包的信息。而不只当前的action相关联的资源包。 名称必需默认类型描述name是Object/String 资源包的类路径(如com.xxxx.resources.AppMsg)id否Object/String用来标识元素的id。在ui和表单中为HTML的id属性Include描述：包含一个servlet的输出(servlet或jsp的页面) 名称必需默认类型描述value时String 要包含的jsp页面或servletid否Object/String用来标识元素的id。在ui和表单中为HTML的id属性param描述：属性是可选的，如果提供，会调用Component的方法，addParameter(String,Object),如果不提供，则外层嵌套标签必须实现UnnamedParametric接口。Value的提供有两种方式，通过value属性或者标签中间的text，不同之处：zhaosoft参数会以String的格式放入statck该值会以java.lang.Object的格式放入statck 名称必需默认类型描述name否String参数名value时Stringvalue表达式id否Object/String用来标识元素的id。在ui和表单中为HTML的id属性set描述：set标签赋予变量一个特定范围内的值。当希望给一个变量赋一个复杂的表达式，每次访问该变量而不是复杂的表达式时用到。其在两种情况下非常有用：复杂的表达式很耗时（性能提升）或者很难理解（代码的可读性提高）参数： 名称必需默认类型描述name是String变量名字scope否String 变量作用域，可以为application,session,request,page,actionvalue否Object/String将会赋给变量的值id否Object/String用来标识元素的id。在ui和表单中为HTML的id属性Text描述：支持国际化信息的标签。国际化信息必须放在一个和当前action同名的resource bundle中，如果没有找到相应message,tag body将被当作默认的message，如果没有tag body，message的name会被作为默认message. 名称必需默认类型描述name是String资源属性的名字id否Object/String用来标识元素的id。在ui和表单中为HTML的id属性url描述：该标签用于创建url，可以通过”param”标签提供request参数。当includeParams的值是all或get，param标签中定义的参数将有优先权，也就是说其会覆盖其他同名参数的值。UI标志单行文本框Textfield标签输出一个HTML单行文本输入控件，等价于HTML代码 名称必需默认类型描述maxlength否无Integer文本输入控件可以输入字符的最大长度readonly否falseBoolean当该属性为true时，不能输入size否无Integer指定可视尺寸id否Object/String用来标识元素的id。在ui和表单中为HTML的id属性例子： 文本框区Textarea标签输出一个HTML多行文本输入控件，等价于HTML代码： 名称必需默认类型描述cols否无Integer列数rows否无Integer行数readonly否falseBoolean当该属性为true时，不能输入wrap否falseBoolean指定多行文本输入控件是否应该换行id否Object/String用来标识元素的id。在ui和表单中为HTML的id属性例子：下拉列表s:select 标签输出一个下拉列表框，相当于HTML代码中的 名称必需默认类型描述list是无Cellection Map Enumeration Iterator array要迭代的集合，使用集合中的元素来设置各个选项，如果list的属性为Map则Map的key成为选项的value，Map的value会成为选项的内容listKey否无String指定集合对象中的哪个属性作为选项的valuelistValue否无String指定集合对象中的哪个属性作为选项的内容headerKey否无String设置当用户选择了header选项时，提交的的value，如果使用该属性，不能为该属性设置空值headerValue否无String显示在页面中header选项内容emptyOption否falseBoolean是否在header选项后面添加一个空选项multiple否falseBoolean是否多选size否无Integer显示的选项个数例子：使用name和list属性，list属性的值是一个列表 使用name和list属性，list属性的值是一个Map 使用headerKey和headerValue属性设置header选项 使用emptyOption属性在header选项后添加一个空的选项 使用multiple属性设置多选 使用size属性设置下拉框可显示的选项个数 使用listKey和listValue属性，利用Action实例的属性（property）来设置选项的值和选项的内容 doubleselect标签doubleselect标签输出关联的两个HTML列表框，产生联动效果。 名称必需默认类型描述list是无Cellection Map Enumeration Iterator array要迭代的集合，使用集合中的元素来设置各个选项，如果list的属性为Map则Map的key成为选项的value，Map的value会成为选项的内容listKey否无String指定集合对象中的哪个属性作为选项的value，该选项只对第一个列表框起作用listValue否无String指定集合对象中的哪个属性作为选项的内容，该选项只对第一个列表框起作用headerKey否无String设置当用户选择了header选项时，提交的的value，如果使用该属性，不能为该属性设置空值headerValue否无String显示在页面中header选项内容emptyOption否falseBooleanmultiple否falseBoolean是否多选size否无Integer显示的选项个数，该选项只对第一个列表框起作用doubleId否无String指定第二个列表框的IDdoubleList是无Cellection Map Enumeration Iterator array要迭代的集合doubleListKey否无String指定集合对象中的哪个属性作为选项的value，该选项只对第二个列表框起作用doubleListValue否无String指定集合对象中的哪个属性作为选项的内容，该选项只对第二个列表框起作用doubleSize否无Integer选项个数doubleName否无String指定第二个列表框的name映射doubleValue否无Object第二个列表框的初始选种项实例：复选框 名称必需默认类型描述fieldValue是trueString指定在复选框选中时，实际提交的值复选框组，对应Action中的集合 名称必需默认类型描述list是无Cellection Map Enumeration Iterator array要迭代的集合，使用集合中的元素来设置各个选项，如果list的属性为Map则Map的key成为选项的value，Map的value会成为选项的内容listKey否无String指定集合对象中的哪个属性作为选项的valuelistValue否无String指定集合对象中的哪个属性作为选项的内容例子：checkboxlistTag.jsp 文件选择组建file标签输出一个HTML文件选择框。 名称必需默认类型描述accept否inputStringHTML accept属性，指出接受文件的MIME类型按钮Submit标签输出一个按钮，submit标签和form标签使用可以提供异步表单提交功能。Submit标签可以输出以下三种类型的提交按钮：Input： 等价于 HTML代码Image： 等价于 HTML代码 Button： 名称必需默认类型描述type否inputString要使用的提交按钮的类型，有效值：input button imagesrc否无String为image类型的提交按钮设置图片地址。该属性对input和button类型的提交按钮无效action否无String指定处理提交请求的actionmethod否无String指定处理提交请求的action的方法实例实例1.页面输出： 实例2.页面输出：登陆 Struts2预定义的前缀：1。method method:login使用method前缀，来取代action默认的execute()方法的执行。 注意：1。input类型的按钮，不能用label设置按钮上的文本，只能用value2、action前缀使用action前缀，取代form标签指定的action，导向到另一个action进行处理。 2、redirect前缀使用redirect前缀请求重定向到其他的url，甚至可以是web英语程序外部的url。 2、redirect-action前缀使用redirect-action前缀请求重定向到其他的action. reset标签reset标签输出一个重置按钮 名称必需默认类型描述type否inputString要使用的重置按钮的内容，input、buttonupdownselect标签updownselect标签创建一个带有上下移动的按钮的列表框，可以通过上下移动按钮来调整列表框的选项的位置。 名称必需默认类型描述list是无Cellection Map Enumeration Iterator array要迭代的集合，使用集合中的元素来设置各个选项，如果list的属性为Map则Map的key成为选项的value，Map的value会成为选项的内容listKey否无String指定集合对象中的哪个属性作为选项的valuelistValue否无String指定集合对象中的哪个属性作为选项的内容headerKey否无String设置当用户选择了header选项时，提交的的value，如果使用该属性，不能为该属性设置空值headerValue否无String显示在页面中header选项内容emptyOption否falseBoolean是否在header选项后面添加一个空选项multiple否falseBoolean是否多选size否无Integer显示的选项个数moveUplabel否String设置向上移动按钮上的文本moveDownLabel否String设置向下移动按钮上的文本selectAllLabel否String设置向全部选择按钮上的文本allowMoveUp否无Boolean设置是否使用向上移动按钮allowMoveDown否无Boolean设置是否使用向下移动按钮allowSelectAll否无Boolean设置是否使用全部选择按钮实例： package com.zhaosoft.ui.formtag;public class BookService public Book getBooks() return new Book new Book(Spring2.0宝典,zhaosoft), new Book(轻量级J2EE企业应用实战,zhaosoft), new Book(基于J2EE的Ajax宝典,zhaosoft) ; optiontransferselect标签optiontransferselect标签创建一个选项转移列表组建，它由两个标签以及它们之间的用于将选项在两个之间相互移动的按钮组成。表单提交时，将提交两个列表框中选中的选项。 名称必需默认类型描述list是无Cellection Map Enumeration Iterator array要迭代的集合，使用集合中的元素来设置各个选项，如果list的属性为Map则Map的key成为选项的value，Map的value会成为选项的内容，该选项只对第一个列表框起作用listKey否无String指定集合对象中的哪个属性作为选项的value，该选项只对第一个列表框起作用listValue否无String指定集合对象中的哪个属性作为选项的内容，该选项只对第一个列表框起作用headerKey否无String设置当用户选择了header选项时，提交的的value，如果使用该属性，不能为该属性设置空值headerValue否无String显示在页面中header选项内容multiple否falseBoolean是否多选size否无Integer显示的选项个数，该选项只对第一个列表框起作用doubleId否无String指定第二个列表框的IDdoubleList是无Cellection Map Enumeration Iterator array要迭代的集合，使用集合中的元素来设置各个选项，如果doubleList的属性为Map则Map的key成为选项的value，Map的value会成为选项的内容，该选项只对第二个列表框起作用doubleListKey否无String指定集合对象中的哪个属性作为选项的value，该选项只对第二个列表框起作用doubleListValue否无String指定集合对象中的哪个属性作为选项的内容，该选项只对第二个列表框起作用doubleHeaderKey否无String设置当用户选择了header选项时，提交的的value，如果使用该属性，不能为该属性设置空值doubleHeaderVale否无String显示在页面中header选项内容doubleEmptyOption否无String是否在第二列表框的header后面添加一个空选项doubleMultiple否trueBoolean是否多选doubleSize否无Integer选项个数doubleName否无String指定第二个列表框的name映射doubleValue否无Object第二个列表框的初始选种项leftTitle否无String左边列表框的标题rightTitle否-String右边列表框的标题addToLeftLable否StringaddToRightLableaddAllToLeftLableaddAllToRightLableleftUpLabelleftDownLabelrightUpLabelrightDownLabelallowAddToLeftallowAddTorightallowAddAllToLeftallowAddAllToRightallowSelectAll否无Boolean设置是否使用全部选择按钮allowUpdownOnLeftallowUpDownOnRight例子： - 引用注水豆芽 的 struts2标签库(1)原作: /struts2/archive/2007/08/03/1724395.aspxStruts2 Taglib抽象了不同表示技术，现在Struts2主要支持三种表示技术：JSP,FreeMarker和Velocity。但部分的Tag在三种表示技术下都可以使用，但是也有部分只能在某一种情况下使用。Tab可以分为两类：通用标签和UI标签。4.1节 通用标签通用标签用来在页面表示的时候控制代码执行的过程，这些标签也允许从Action或者值堆栈中取得数据。例如地域，JavaBeans，URLs，和action。控制标签控制程序执行，例如：if，else,iterator数据标签管理数据的取得和创建，例如：bean，push,i18n控制标签if标签 描述 If标签用来控制基本的条件处理流程，通常和else标签或者elseif标签连用。参数名字是否必须默认值可否使用表达式类型描述id否是String用来表示该元素，对于UI和Form标签来说直接转变为HTML id属性test是是Boolean用来决定是否显示标签内部内容的表达式例子 Will Not Be Executed Will Be Executed Will Not Be ExecutedelseIf 标签参考if标签else 标签参考if标签append标签 描述用来做iterator标签的辅助，将不同iterator中的内容合在一个iterator中。参数名字是否必须默认值可否使用表达式类型描述id否是String用来保存结果iterator的对象在value context中的名字。例子Action类public class AppendIteratorTagAction extends ActionSupport private List myList1; private List myList2; private List myList3; public String execute() throws Exception myList1 = new ArrayList(); myList1.add(1); myList1.add(2); myList1.add(3); myList2 = new ArrayList(); myList2.add(a); myList2.add(b); myList2.add(c); myList3 = new ArrayList(); myList3.add(A); myList3.add(B); myList3.add(C); return done; public List getMyList1() return myList1; public List getMyList2() return myList2; public Li