Displaytag

<?xml version="1.0" encoding="GBK"?> 
<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN" 
"http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd"> 
<taglib> 
<tlib-version>1.1</tlib-version> 
<jsp-version>1.2</jsp-version> 
<short-name>display</short-name> 
<uri>http://displaytag.sf.net</uri> 
<display-name>Display *: Tag Library</display-name> 
<description> 
The display tag library is an open source suite of custom tags that provide high level web presentation patterns 
which will work in a MVC model, and provide a significant amount of functionality while still being simple and 
straight-forward to use. The primary tag in the library is the Table tag. 
</description> 
<tag> 
<name>table</name> 
<tag-class>org.displaytag.tags.TableTag</tag-class> 
<tei-class>org.displaytag.tags.TableTagExtraInfo</tei-class> 
<body-content>JSP</body-content> 
<display-name>table</display-name> 
<description> 
在jsp中显示出一个表格，此表格可以通过定义属性来获得数据库中的表，可以分页排序的显示出来，还可以将表中的数据以 
CSV，Excel，和XML的格式生成。 
</description> 
<attribute> 
<name>list</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<description> 
参考表格中使用的源对象，可以表示一个请求对象范围的特性，你必须定义一个name属性或list属性，使用Name来暗示。 
</description> 
</attribute> 
<attribute> 
<name>name</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<description> 
指定范围属性的名称，在标准标签库中必须有一个name标签来指向源对象 
(request.setAttribute("test", (java.util.List) sqldb.getData()) //@*name="test"), 
sqldb.getData()是在数据库中取出的所有记录 
</description> 
</attribute> 
<attribute> 
<name>length</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>int</type> 
<description> 
设置显示在表格中的记录数(//@*length="5") 
</description> 
</attribute> 
<attribute> 
<name>offset</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>int</type> 
<description> 
设置从用户输入的索引值，显示索引值后的所有记录(//@*offset="3") 
</description> 
</attribute> 
<attribute> 
<name>pagesize</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>int</type> 
<description> 
用户输入表格每页显示的记录数，使表中的纪录分页显示((//@*pagesize="6") 
</description> 
</attribute> 
<attribute> 
<name>decorator</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description> 
使用装饰模式转换数据显示，用户可以自己写decorator。 
</description> 
</attribute> 
<attribute> 
<name>requestURI</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description> 
在struts中，当设置了排序后，点击表头，它会指向你转向的jsp，如果想跳转到servlet，action，或者其他页面， 
可以通过requestURI设置跳转地址。 
</description> 
</attribute> 
<attribute> 
<name>style</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description>HTML通用属性。</description> 
</attribute> 
<attribute> 
<name>class</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description> 
为表格定义样式.这里有五种样式：isis,its,mars,simple,report,mark,但要引入screen.css样式表. 
</description> 
</attribute> 
<attribute> 
<name>cellspacing</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description>HTML通用属性,表格中单元格的边距</description> 
</attribute> 
<attribute> 
<name>cellpadding</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description>HTML通用属性,设置单元格沿四边的大小宽度,比在style或class中使用"padding"更好.</description> 
</attribute> 
<attribute> 
<name>frame</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description>HTML通用属性.</description> 
</attribute> 
<attribute> 
<name>rules</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description>HTML通用属性.</description> 
</attribute> 
<attribute> 
<name>summary</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description>HTML通用属性</description> 
</attribute> 
<attribute> 
<name>htmlId</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description>html中"id"通用属性 </description> 
</attribute> 
<attribute> 
<name>export</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>boolean</type> 
<description> 
设置能否导出:Excel,XML,CSV文件,为true时可以导出. (//@*export="true") 
</description> 
</attribute> 
<attribute> 
<name>id</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description> 
添加id属性，同时就在pageContext里创建了一个隐含对象，指向list里的当前对象可以通过 
(ListObject)pageContext.getAttribute("id")来捕获这个对象。同时还创建了一个id_rowNum对象，同样，可 
通过pageContext.getAttribute("testit_rowNum")来捕获，它仅仅代表当前行的行数。 
</description> 
</attribute> 
<attribute> 
<name>sort</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description> 
输入'list'并在列属性中sortable为true的情况下,则按照表中所有记录进行排序(//@*sort="list"). 
</description> 
</attribute> 
<attribute> 
<name>defaultsort</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>int</type> 
<description> 
按照索引列的序号进行排序(//@*defaultsort="1"表示第一列). 
</description> 
</attribute> 
<attribute> 
<name>defaultorder</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description> 
对指定索引列的序号(defaultsort属性)进行"升序(ascending)"(默认)或"降序(descending)",(//@*defaultorder="descending")。 
</description> 
</attribute> 
<attribute> 
<name>partialList</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>boolean</type> 
<description>能否显示集合的一部分，有效的值是true或false(//@*partialList="true")</description> 
</attribute> 
<attribute> 
<name>size</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<description> 
当partialList为true时才能使用，是写入一个整型对象，它是包含总数据集大小的，要用方法给整数赋予属性 
(request.setAttribute("sum",new Integer(count)))，count是数据库中所有记录总数,sum是属性名，在size属性中 
这样写：//@*size="sum". 
</description> 
</attribute> 
<example> 
<![CDATA[ 
<display:table name="someList" export="true" id="row" requestURI="MyAction.do"> 
<display:column sortable="true" title="ID"> <c:out value="${row.id}"/> </display:column> 
<display:column property="email" autolink="true"/> 
<display:column property="description" title="Comments"/> 
</display:table> 
]]> 
</example> 
</tag> 
<tag> 
<name>column</name> 
<tag-class>org.displaytag.tags.ColumnTag</tag-class> 
<body-content>JSP</body-content> 
<display-name>column</display-name> 
<description> 
在表格内显示一个烈的属性，必须在table标签内；其属性名决定决定显示列的内容， 
如果属性为空，则在jsp页面中没有显示。 
</description> 
<attribute> 
<name>property</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description> 
此属性名是用来显示列中记录的，属性名是pojo类(bean类)中的属性。 
(//@*property="job_id" job_id是pojo类中的一个属性) 
</description> 
</attribute> 
<attribute> 
<name>title</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description>列中的标题，列头(//@*title="名称")</description> 
</attribute> 
<attribute> 
<name>comparator</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<description> 
The classname of comparator to use when sorting this column, or the comparator itself. Defaults to the 
DefaultComparator. 
</description> 
</attribute> 
<attribute> 
<name>total</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>boolean</type> 
<description> 
在table标签中添加 decorator="org.displaytag.decorator.TotalTableDecorator"， 
然后在想要进行合计的数据列的 column标签中添加 //@*total="true"，该列就可以被计算总数了。 
</description> 
</attribute> 
<attribute> 
<name>sortable</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>boolean</type> 
<description>此属性如果设置为真那么此列可以排序默认为假(//@*sortable="true").</description> 
</attribute> 
<attribute> 
<name>defaultorder</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description> 
默认为此列排序，有效值为升序(默认)和降序(//@*defaultorder="ascending" 或 //@*defaultorder="descending") 
</description> 
</attribute> 
<attribute> 
<name>autolink</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>boolean</type> 
<description> 
如果要显示的对象里包含email和url地址，则可以在display:column里直接设定autolink="true"来直接连接,默认为false. 
</description> 
</attribute> 
<attribute> 
<name>format</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description> 
可以使用标签的方式格式化时间、数字、字符串。比如日期，在需要格式化的column标签中添加 
//@*format="{0,date,yyyy-MM-dd}"，第一个参数为格式化的数据序号， 
第二个参数是数据类型，数字为number，第三个参数为数据格式。 
</description> 
</attribute> 
<attribute> 
<name>href</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description> 
创建动态连接，基本的URL地址，等价于HTML中的href但不能传参。 
</description> 
</attribute> 
<attribute> 
<name>url</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description> 
基于url的动态链接,等同于HTML中的href(//@*url="index.jsp"). 
</description> 
</attribute> 
<attribute> 
<name>paramId</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description> 
加在href属性的URL地址后的参数名称(//@*paramId="id" 等同于HTML中的 a href="index.jsp?id"的id参数)。 
</description> 
</attribute> 
<attribute> 
<name>paramName</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description> 
加在href属性的URL地址后的参数值(//@*paramName="name" 等同于HTML中的 a href="index.jsp?id=name" id对应的name值)。 
</description> 
</attribute> 
<attribute> 
<name>paramProperty</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description> 
数据bean的属性名称，用来填充href属性的URL地址后的参数值(//@*paramProperty="job_id" job_id是pojo类中的属性) 
display:column href="baseurl" paramId="paramid" paramProperty="propertyname" 
http://baseurl/paramid=名字为propertyname的属性值。 
</description> 
</attribute> 
<attribute> 
<name>paramScope</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description> 
设置paramid后边的的名称，此名称为范围内的名字为paramName的值， 
(display:column href="baseurl" paramId="paramid" paramName="name" paramScope="scope" 
写成HTML是：http://baseurl/paramid=scope) 
</description> 
</attribute> 
<attribute> 
<name>maxLength</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>int</type> 
<description> 
如果此属性存在，那么列的字符仅被显示用户定义的字符数， 
然后加上。。。(//@*maxLength="10" 如果在备注这列加上其属性，那么备注的字段只显示10个字符和。。。) 
当鼠标划过的时候显示其全部内容 
</description> 
</attribute> 
<attribute> 
<name>maxWords</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>int</type> 
<description> 
如果此属性存在，那么列仅被显示用户定义的单词数，然后加上。。。 
(//@*maxWords="2" 如果在备注这列加上其属性，那么备注的字段只显示2个单词加。。。) 
当鼠标划过的时候显示其全部内容 
</description> 
</attribute> 
<attribute> 
<name>class</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description> 
HTML通用属性，设置列的样式。 
</description> 
</attribute> 
<attribute> 
<name>headerClass</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description>"class"html中的属性仅能加在头单元格内</description> 
</attribute> 
<attribute> 
<name>style</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>java.lang.String</type> 
<description>HTML通用属性，设置列的样式。</description> 
</attribute> 
<attribute> 
<name>group</name> 
<required>false</required> 
<rtexprvalue>true</rtexprvalue> 
<type>int</type> 
<description> 
display:column property="city" title="CITY" group="1" 
display:column property="project" title="PROJECT" group="2" 
这样不仅仅结果可以分组，而且还可以省略掉重复的数据，例如city列，project列都有 
A ，B ，A，B 两行那么第二行这两列就不显示了。 
同样只能对当前页进行分组。 
注意：第一列一定要1，第二列一定是2，否则出NUllPoint 错误。 
</description> 
</attribute> 
</tag> 
</taglib>