本文介紹DisplayTag的一些使用方法。摘自[http://hongyu0809.spaces.msn.com/PersonalSpace.aspx]
DisplayTag 基本介紹
DisplayTag是一個很是好用的表格顯示標籤，適合MVC模式，
其主頁在 http://displaytag.sourceforge.net。
在這裏能夠下載displaytag-1.0.jar
同時須要一下包文件：
jstl.jar
standard.jar
commons-lang-2.0.jar
commons-collections.jar
commons-beanutils.jar
crimson.jar
gnujaxp.jar
nekohtml.jar(org.cyberneko.html.parsers.DOMFragmentParser等)
xerces-2.4.0.jar(org.apache.html.dom.HTMLDocumentImpl等)
poi-2.5.1-final-20040804.jar
而後把對應的jar文件copy到WEB-INF/lib中.
其主頁在 http://displaytag.sourceforge.net。
在這裏能夠下載displaytag-1.0.jar
同時須要一下包文件：
jstl.jar
standard.jar
commons-lang-2.0.jar
commons-collections.jar
commons-beanutils.jar
crimson.jar
gnujaxp.jar
nekohtml.jar(org.cyberneko.html.parsers.DOMFragmentParser等)
xerces-2.4.0.jar(org.apache.html.dom.HTMLDocumentImpl等)
poi-2.5.1-final-20040804.jar
而後把對應的jar文件copy到WEB-INF/lib中.
DisplayTag的使用：
＜display:table id="pres" name="${pagedData.data}" sort="list"
styleClass="list" export="true"
requestURI="${request.contextPath}" pagesize="10" defaultsort="3"＞
styleClass="list" export="true"
requestURI="${request.contextPath}" pagesize="10" defaultsort="3"＞
name是要展示的集合數據.
id:在<display:table/>裏增長了id屬性，就在page context裏建立了一個隱含對象，指向List裏的當前對象，
因此能夠經過(ListObject)pageContext.getAttribute("id")來捕獲這個對象。
同時還建立了一個id_rowNum對象，
可經過pageContext.getAttribute("testit_rowNum")來捕獲，它僅僅表明當前行的行數。
sort 表示整個list被排序.
pagesize 表示每頁所要展現的數.
defaultsort 表示默認是按第幾列排序的，注意這裏是以1開始計數的,默認從第一列開始排序.
defaultorder 指定排序方式，defaultorder="descending" 指定默認爲降序
styleClass 指定所要應用的樣式.
requestURI
id:在<display:table/>裏增長了id屬性，就在page context裏建立了一個隱含對象，指向List裏的當前對象，
因此能夠經過(ListObject)pageContext.getAttribute("id")來捕獲這個對象。
同時還建立了一個id_rowNum對象，
可經過pageContext.getAttribute("testit_rowNum")來捕獲，它僅僅表明當前行的行數。
sort 表示整個list被排序.
pagesize 表示每頁所要展現的數.
defaultsort 表示默認是按第幾列排序的，注意這裏是以1開始計數的,默認從第一列開始排序.
defaultorder 指定排序方式，defaultorder="descending" 指定默認爲降序
styleClass 指定所要應用的樣式.
requestURI
＜display:caption＞使用displayTag示例＜/display:caption＞
display:caption標記中間的字符串是用來放到表格上面的標題.
display:caption標記中間的字符串是用來放到表格上面的標題.
＜display:column property="firstName" title="First Name" sortable="true" export="true"/＞
display:column標記指定了每列的屬性.
property 對應List裏對象的屬性（它是用getXXX()方法獲取）
title 對應表格表頭裏的列名
export="true" 導出文件時導出該列
sortable="true" 設定該列可進行排序
display:column標記指定了每列的屬性.
property 對應List裏對象的屬性（它是用getXXX()方法獲取）
title 對應表格表頭裏的列名
export="true" 導出文件時導出該列
sortable="true" 設定該列可進行排序
分類樣板說明以下：
1、最簡單的狀況，未使用<display:column/>標籤
<%request.setAttribute( "test", new ReportList(6) );%>
<display:table name="test" />
標籤遍歷List裏的每個對象，並將對象裏的全部屬性顯示出來。通常用於開發的時候檢查對象數據的完整性。
2、使用<display:column/>標籤的狀況
<display:table name="test">
<display:column property="id" title="ID" />
<display:column property="name" />
<display:column property="email" />
<display:column property="status" />
<display:column property="description" title="Comments"/>
</display:table>
property對應List裏對象的屬性（用getXXX()方法取得），title則對應表格表頭裏的列名。定義列有兩種方式：
A、<display:column property="email" />
使用<display:column/>標籤裏的property屬性來定義
B、<display:column title="email">email@it.com</display:column>
在<display:column/>標籤體裏增長內容，能夠是常量，也能夠用其餘標籤等等
兩種方式比較，用property屬性來定義更加快速和利於排序。
3、表格顯示樣式的定義
A、在<display:table/>和<display:column/>標籤裏指定標準的html屬性，煩瑣
B、修改樣式表
<display:table name="test" class="mars">
<display:column property="id" title="ID" class="idcol"/>
<display:column property="name" />
<display:column property="email" />
<display:column property="status" class="tableCellError" />
<display:column property="description" title="Comments"/>
</display:table>
經過class屬性來指定所要應用的樣式。
4、標籤取得數據的數據源
有四種範圍
pageScope
requestScope (默認) <display:table name="test2" > 至關於request.getAttribute( "test2"））
sessionScope <display:table name="sessionScope.holder.list" > 注意，這裏要指定範圍，非默認
applicationScope
5、經過增長id屬性建立隱含的對象
<display:table name="test" id="testit">
<display:column property="id" title="ID" />
<display:column property="name" />
<display:column title="static value">static</display:column>
<display:column title="row number (testit_rowNum)">
<%=pageContext.getAttribute("testit_rowNum")%>
</display:column>
<display:column title="((ListObject)testit).getMoney()">
<%=((ListObject)pageContext.getAttribute("testit")).getMoney()%>
</display:column>
</display:table>
在<display:table/>裏增長了id屬性，就在page context裏建立了一個隱含對象，
能夠經過(ListObject)pageContext.getAttribute("id")來捕獲這個對象。
同時還建立了一個id_rowNum對象，一樣，
可經過pageContext.getAttribute("testit_rowNum")來捕獲，它僅僅表明當前行的行數。
有了這兩個隱含對象，就能夠經過其餘標籤來訪問，例如Jstl:
<display:table id="row" name="mylist">
<display:column title="row number" >
<c:out value="${row_rowNum}"/>
</display:column>
<display:column title="name" >
<c:out value="${row.first_name}"/>
<c:out value="${row.last_name}"/>
</display:column>
</display:table>
6、顯示部分數據
顯示開始五條數據：經過設定length屬性
<display:table name="test" length="5">
<display:column property="id" title="ID" />
<display:column property="email" />
<display:column property="status" />
</display:table>
顯示第三到第八條數據：經過設定offset和length屬性
<display:table name="test" offset="3" length="5">
<display:column property="id" title="ID" />
<display:column property="email" />
<display:column property="status" />
</display:table>
7、對email和url地址的直接鏈接
<display:table name="test" >
<display:column property="id" title="ID" />
<display:column property="email" autolink="true" />
<display:column property="url" autolink="true" />
</display:table>
若是要顯示的對象裏包含email和url地址，則能夠在display:column裏直接設定autolink="true"來直接鏈接
8、使用裝飾模式轉換數據顯示（寫本身的 decorator ）
A、對整個表格應用decorator
<display:table name="test" decorator="org.displaytag.sample.Wrapper" >
<display:column property="id" title="ID" />
<display:column property="email" />
<display:column property="status" />
<display:column property="date" />
<display:column property="money" />
</display:table>
org.displaytag.sample.Wrapper即本身寫的decorator，它要繼承TableDecorator類，看看它的一個方法：
public String getMoney()
{
return this.moneyFormat.format(((ListObject) this.getCurrentRowObject()).getMoney());
}
很明顯，它經過父類的getCurrentRowObject()方法得到當前對象，而後對其getMoney()方法進行'油漆'
B、對單獨的column應用decorator
<display:table name="test">
<display:column property="id" title="ID" />
<display:column property="email" />
<display:column property="status" />
<display:column property="date" decorator="org.displaytag.sample.LongDateWrapper" />
</display:table>
org.displaytag.sample.LongDateWrapper要實現ColumnDecorator接口，它的方法：
public final String decorate(Object columnValue)
{
Date date = (Date) columnValue;
return this.dateFormat.format(date);
}
顯然，它得到不了當前對象（由於它實現的是接口），僅僅是得到該對象的columnValue，而後'油漆'
9、建立動態鏈接
有兩種方法建立動態鏈接：
A、在<display:column/>裏經過增長href、paramId、paramName、paramScope、paramProperty屬性
href 基本的URL 地址
paramId 加在URL 地址後的參數名稱
paramName 數據bean的名稱，通常爲null（即便用當前List裏的對象）
paramScope 數據bean的範圍，通常爲null
paramProperty 數據bean的屬性名稱，用來填充URL 地址後的參數值
<display:table name="sessionScope.details">
<display:column property="id" title="ID" href="details.jsp" paramId="id" />
<display:column property="email" href="details.jsp" paramId="action" paramName="testparam" paramScope="request" />
<display:column property="status" href="details.jsp" paramId="id" paramProperty="id" />
</display:table>
這種方法簡便直接，但缺點是沒法產生相似details.jsp?id=xx&action=xx的複合URL
B、應用decorator 建立動態鏈接：
<display:table name="sessionScope.details" decorator="org.displaytag.sample.Wrapper" >
<display:column property="link1" title="ID" />
<display:column property="email" />
<display:column property="link2" title="Actions" />
</display:table>
org.displaytag.sample.Wrapper裏的方法：
public String getLink1()
{
ListObject lObject= (ListObject)getCurrentRowObject();
int lIndex= getListIndex();
return "<a href=\"details.jsp?index=" + lIndex + "\">" + lObject.getId() + "</a>";
}
public String getLink2()
{
ListObject lObject= (ListObject)getCurrentRowObject();
int lId= lObject.getId();
return "<a href=\"details.jsp?id=" + lId
+ "&action=view\">View</a> | "
+ "<a href=\"details.jsp?id=" + lId
+ "&action=edit\">Edit</a> | "
+ "<a href=\"details.jsp?id=" + lId
+ "&action=delete\">Delete</a>";
}
10、分頁
實現分頁很是的簡單，增長一個pagesize屬性指定一次想顯示的行數便可
<display:table name="sessionScope.test" pagesize="10">
<display:column property="id" title="ID" />
<display:column property="name" />
<display:column property="email" />
<display:column property="status" />
</display:table>
11、排序
排序實現也是很簡單，在須要排序的column裏增長sortable="true"屬性，headerClass="sortable"僅僅是
指定顯示的樣式。column裏的屬性對象要實現Comparable接口，若是沒有的話能夠應用decorator
defaultsort="1" 默認第一個column排序
defaultorder="descending" 默認遞減排序
<display:table name="sessionScope.stest" defaultsort="1" defaultorder="descending">
<display:column property="id" title="ID" sortable="true" headerClass="sortable" />
<display:column property="name" sortable="true" headerClass="sortable"/>
<display:column property="email" />
<display:column property="status" sortable="true" headerClass="sortable"/>
</display:table>
注意的是，當同時存在分頁時排序僅僅針對的是當前頁面，而不是整個List都進行排序
12、column 分組
分組只是須要在column裏增長group屬性
<display:table name="test" class="simple">
<display:column property="city" title="CITY" group="1"/>
<display:column property="project" title="PROJECT" group="2"/>
<display:column property="amount" title="HOURS"/>
<display:column property="task" title="TASK"/>
</display:table>
十3、導出數據到其餘格式（頁面溢出filter??）
在<display:table/>裏設定export="true"
在<display:column/>裏設定media="csv excel xml pdf" 決定該字段在導出到其餘格式時被包不包含，不設定則都包含
<display:setProperty name="export.csv" value="false" />
決定該種格式能不能在頁面中導出
<display:table name="test" export="true" id="currentRowObject">
<display:column property="id" title="ID"/>
<display:column property="email" />
<display:column property="status" />
<display:column property="longDescription" media="csv excel xml pdf" title="Not On HTML"/>
<display:column media="csv excel" title="URL" property="url"/>
<display:setProperty name="export.pdf" value="true" />
<display:setProperty name="export.csv" value="false" />
</display:table>
十4、配置屬性，覆蓋默認
兩種方法：
A、在程序classpath下新建displaytag.properties文件全部時區共用，
建中文編碼則建立displaytag_zh_CN.properties，放到類路徑下,
jar包內共有兩個默認的屬性文件TableTag.properties，message.properties
1、最簡單的狀況，未使用<display:column/>標籤
<%request.setAttribute( "test", new ReportList(6) );%>
<display:table name="test" />
標籤遍歷List裏的每個對象，並將對象裏的全部屬性顯示出來。通常用於開發的時候檢查對象數據的完整性。
2、使用<display:column/>標籤的狀況
<display:table name="test">
<display:column property="id" title="ID" />
<display:column property="name" />
<display:column property="email" />
<display:column property="status" />
<display:column property="description" title="Comments"/>
</display:table>
property對應List裏對象的屬性（用getXXX()方法取得），title則對應表格表頭裏的列名。定義列有兩種方式：
A、<display:column property="email" />
使用<display:column/>標籤裏的property屬性來定義
B、<display:column title="email">email@it.com</display:column>
在<display:column/>標籤體裏增長內容，能夠是常量，也能夠用其餘標籤等等
兩種方式比較，用property屬性來定義更加快速和利於排序。
3、表格顯示樣式的定義
A、在<display:table/>和<display:column/>標籤裏指定標準的html屬性，煩瑣
B、修改樣式表
<display:table name="test" class="mars">
<display:column property="id" title="ID" class="idcol"/>
<display:column property="name" />
<display:column property="email" />
<display:column property="status" class="tableCellError" />
<display:column property="description" title="Comments"/>
</display:table>
經過class屬性來指定所要應用的樣式。
4、標籤取得數據的數據源
有四種範圍
pageScope
requestScope (默認) <display:table name="test2" > 至關於request.getAttribute( "test2"））
sessionScope <display:table name="sessionScope.holder.list" > 注意，這裏要指定範圍，非默認
applicationScope
5、經過增長id屬性建立隱含的對象
<display:table name="test" id="testit">
<display:column property="id" title="ID" />
<display:column property="name" />
<display:column title="static value">static</display:column>
<display:column title="row number (testit_rowNum)">
<%=pageContext.getAttribute("testit_rowNum")%>
</display:column>
<display:column title="((ListObject)testit).getMoney()">
<%=((ListObject)pageContext.getAttribute("testit")).getMoney()%>
</display:column>
</display:table>
在<display:table/>裏增長了id屬性，就在page context裏建立了一個隱含對象，
能夠經過(ListObject)pageContext.getAttribute("id")來捕獲這個對象。
同時還建立了一個id_rowNum對象，一樣，
可經過pageContext.getAttribute("testit_rowNum")來捕獲，它僅僅表明當前行的行數。
有了這兩個隱含對象，就能夠經過其餘標籤來訪問，例如Jstl:
<display:table id="row" name="mylist">
<display:column title="row number" >
<c:out value="${row_rowNum}"/>
</display:column>
<display:column title="name" >
<c:out value="${row.first_name}"/>
<c:out value="${row.last_name}"/>
</display:column>
</display:table>
6、顯示部分數據
顯示開始五條數據：經過設定length屬性
<display:table name="test" length="5">
<display:column property="id" title="ID" />
<display:column property="email" />
<display:column property="status" />
</display:table>
顯示第三到第八條數據：經過設定offset和length屬性
<display:table name="test" offset="3" length="5">
<display:column property="id" title="ID" />
<display:column property="email" />
<display:column property="status" />
</display:table>
7、對email和url地址的直接鏈接
<display:table name="test" >
<display:column property="id" title="ID" />
<display:column property="email" autolink="true" />
<display:column property="url" autolink="true" />
</display:table>
若是要顯示的對象裏包含email和url地址，則能夠在display:column裏直接設定autolink="true"來直接鏈接
8、使用裝飾模式轉換數據顯示（寫本身的 decorator ）
A、對整個表格應用decorator
<display:table name="test" decorator="org.displaytag.sample.Wrapper" >
<display:column property="id" title="ID" />
<display:column property="email" />
<display:column property="status" />
<display:column property="date" />
<display:column property="money" />
</display:table>
org.displaytag.sample.Wrapper即本身寫的decorator，它要繼承TableDecorator類，看看它的一個方法：
public String getMoney()
{
return this.moneyFormat.format(((ListObject) this.getCurrentRowObject()).getMoney());
}
很明顯，它經過父類的getCurrentRowObject()方法得到當前對象，而後對其getMoney()方法進行'油漆'
B、對單獨的column應用decorator
<display:table name="test">
<display:column property="id" title="ID" />
<display:column property="email" />
<display:column property="status" />
<display:column property="date" decorator="org.displaytag.sample.LongDateWrapper" />
</display:table>
org.displaytag.sample.LongDateWrapper要實現ColumnDecorator接口，它的方法：
public final String decorate(Object columnValue)
{
Date date = (Date) columnValue;
return this.dateFormat.format(date);
}
顯然，它得到不了當前對象（由於它實現的是接口），僅僅是得到該對象的columnValue，而後'油漆'
9、建立動態鏈接
有兩種方法建立動態鏈接：
A、在<display:column/>裏經過增長href、paramId、paramName、paramScope、paramProperty屬性
href 基本的URL 地址
paramId 加在URL 地址後的參數名稱
paramName 數據bean的名稱，通常爲null（即便用當前List裏的對象）
paramScope 數據bean的範圍，通常爲null
paramProperty 數據bean的屬性名稱，用來填充URL 地址後的參數值
<display:table name="sessionScope.details">
<display:column property="id" title="ID" href="details.jsp" paramId="id" />
<display:column property="email" href="details.jsp" paramId="action" paramName="testparam" paramScope="request" />
<display:column property="status" href="details.jsp" paramId="id" paramProperty="id" />
</display:table>
這種方法簡便直接，但缺點是沒法產生相似details.jsp?id=xx&action=xx的複合URL
B、應用decorator 建立動態鏈接：
<display:table name="sessionScope.details" decorator="org.displaytag.sample.Wrapper" >
<display:column property="link1" title="ID" />
<display:column property="email" />
<display:column property="link2" title="Actions" />
</display:table>
org.displaytag.sample.Wrapper裏的方法：
public String getLink1()
{
ListObject lObject= (ListObject)getCurrentRowObject();
int lIndex= getListIndex();
return "<a href=\"details.jsp?index=" + lIndex + "\">" + lObject.getId() + "</a>";
}
public String getLink2()
{
ListObject lObject= (ListObject)getCurrentRowObject();
int lId= lObject.getId();
return "<a href=\"details.jsp?id=" + lId
+ "&action=view\">View</a> | "
+ "<a href=\"details.jsp?id=" + lId
+ "&action=edit\">Edit</a> | "
+ "<a href=\"details.jsp?id=" + lId
+ "&action=delete\">Delete</a>";
}
10、分頁
實現分頁很是的簡單，增長一個pagesize屬性指定一次想顯示的行數便可
<display:table name="sessionScope.test" pagesize="10">
<display:column property="id" title="ID" />
<display:column property="name" />
<display:column property="email" />
<display:column property="status" />
</display:table>
11、排序
排序實現也是很簡單，在須要排序的column裏增長sortable="true"屬性，headerClass="sortable"僅僅是
指定顯示的樣式。column裏的屬性對象要實現Comparable接口，若是沒有的話能夠應用decorator
defaultsort="1" 默認第一個column排序
defaultorder="descending" 默認遞減排序
<display:table name="sessionScope.stest" defaultsort="1" defaultorder="descending">
<display:column property="id" title="ID" sortable="true" headerClass="sortable" />
<display:column property="name" sortable="true" headerClass="sortable"/>
<display:column property="email" />
<display:column property="status" sortable="true" headerClass="sortable"/>
</display:table>
注意的是，當同時存在分頁時排序僅僅針對的是當前頁面，而不是整個List都進行排序
12、column 分組
分組只是須要在column裏增長group屬性
<display:table name="test" class="simple">
<display:column property="city" title="CITY" group="1"/>
<display:column property="project" title="PROJECT" group="2"/>
<display:column property="amount" title="HOURS"/>
<display:column property="task" title="TASK"/>
</display:table>
十3、導出數據到其餘格式（頁面溢出filter??）
在<display:table/>裏設定export="true"
在<display:column/>裏設定media="csv excel xml pdf" 決定該字段在導出到其餘格式時被包不包含，不設定則都包含
<display:setProperty name="export.csv" value="false" />
決定該種格式能不能在頁面中導出
<display:table name="test" export="true" id="currentRowObject">
<display:column property="id" title="ID"/>
<display:column property="email" />
<display:column property="status" />
<display:column property="longDescription" media="csv excel xml pdf" title="Not On HTML"/>
<display:column media="csv excel" title="URL" property="url"/>
<display:setProperty name="export.pdf" value="true" />
<display:setProperty name="export.csv" value="false" />
</display:table>
十4、配置屬性，覆蓋默認
兩種方法：
A、在程序classpath下新建displaytag.properties文件全部時區共用，
建中文編碼則建立displaytag_zh_CN.properties，放到類路徑下,
jar包內共有兩個默認的屬性文件TableTag.properties，message.properties
B、對於單個表格，應用<display:setProperty>標籤(<display:setProperty name=... value=...>)
十5、一個完整的例子
<display:table id="test" name="${test}" export="true" sort="list" pagesize="10">
<display:column property="city" title="城市" group="1" sortable="true" headerClass="sortable"/>
<display:column property="name" title="名字" group="2" sortable="true" headerClass="sortable"/>
<display:column property="age" title="年齡"/>
</display:table>
sort="list" 對整個list進行排序
<display:table id="test" name="${test}" export="true" sort="list" pagesize="10">
<display:column property="city" title="城市" group="1" sortable="true" headerClass="sortable"/>
<display:column property="name" title="名字" group="2" sortable="true" headerClass="sortable"/>
<display:column property="age" title="年齡"/>
</display:table>
sort="list" 對整個list進行排序
十六 其它 1)當多個表在一頁顯示時，每一個表都想要有分頁、排序、導出等功能時，只需爲每一個table指定一個不一樣的ID便可。 2)增長表頭<display:caption>角色管理</display:caption> 3)增長表尾 <display:footer><tr><td colspan="6" align="center" >HY示例</td></tr></display:footer> 4)http和email自動連接功能，指定autolink="true" 5)指定一列顯示的最大長度，避免太長把表格變形 maxLength="10" style="whitespace: nowrap;" 6)當列的值爲null，使用nulls="false"屬性把null轉爲空白 7)<display:setProperty name="export.excel.filename" value="test.xls"/>設置導出excel的文件名 8)<display:setProperty name="basic.show.header" value="false"/> 設置不顯示錶頭 9)在displaytag.properties裏修改paging.banner.item_name=記錄後，出現中文顯示亂碼問題， 解決辦法： org.displaytag.properties.TableProperties 修改 private String getProperty(String key) { return this.properties.getProperty(key); } 爲 private String getProperty(String key) { String s = null; try { s = new String(this.properties.getProperty(key).getBytes("8859_1"), "GBK"); }catch(Exception e) { s = null; } return s; } 10)displaytag導出excel文件中文亂碼的解決辦法 修改org.displaytag.export.ExcelView.java public String getMimeType() { return "application/vnd.ms-excel;charset=GB2312"; } 十七 總結 我本身使用過程當中，遇到顯示當前頁數，頁總數等文字信息爲英文的問題， 須要把displaytag_zh_CN.properties，放到類路徑下就能夠了。