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>