摘自:http://blog.csdn.net/clearwater21cn/archive/2005/02/21/296316.aspx


Display Tag Lib是一個標籤庫，用來處理jsp網頁上的Table，功能非常強，可以對的Table進行分頁、資料匯出、分組、對列排序等等，反正我在做專案時需要的功能它都給我提供了，而且使用起來非常的方便。能夠大大減少程式碼量。
介個是Display Tag的官方網站http://displaytag.sourceforge.net。

首先當然是要下載它的jar包了，這裡可以下載到最新的版本。將jar包放到WEB-INF的lib資料夾下。另外還需要兩個輔助包：apache的commons-lang和standard包，更多的輔助包可以在這裡下載。

在web.xml下新增一個filter
<filter>
<filter-name>exportFilter</filter-name>
<filter-class>org.displaytag.filter.ResponseOverrideFilter</filter-class>
</filter>

在jsp頁面做一個引用：
<%@ taglib uri="http://displaytag.sf.net/el" prefix="display" %>

首先我們定義一個list
<%
List test = new ArrayList( 6 );
test.add( "Test String 1" );
test.add( "Test String 2" );
test.add( "Test String 3" );
test.add( "Test String 4" );
test.add( "Test String 5" );
test.add( "Test String 6" );
request.setAttribute( "test", test );
%>

當我們想在jsp頁面上顯示這個list時，我們只需要寫一句話
<display:table name="test" />
display tag會自動生成一個table

如果list是從控制層丟擲來的，name可使用EL表示式表示
<display:table name="${test}" />

這是最簡單的display tag的使用，我們可以給它加上樣式等，也可以定義顯示的列，下面的table顯示覆雜一些
<display:table name="test" styleClass="list" cellspacing="0" cellpadding="0">
<display:column property="id" title="ID" class="idcol"/>
<display:column property="name" />
<display:column property="email" />
<display:column property="description" title="Comments"/>
</display:table>

如果想要給它加個連結也很簡單,下面的程式碼給name加了連線，並附帶id引數，email也自動連線到mailto:XXX
<display:table name="test" styleClass="list" cellspacing="0" cellpadding="0">
<display:column property="id" title="ID" class="idcol"/>
<display:column property="name" url="detail.jsp" paramId="id" paramProperty="id"/>
<display:column property="email" autolink="true"/>
<display:column property="description" title="Comments"/>
</display:table>

下面介紹幾個Display最常用的功能，更多功能請參考http://displaytag.homeip.net/displaytag-examples-1.1/。
1. 分頁
如果想對程式碼分頁，只需在display:table標籤中新增一項pagesize="每頁顯示行數"，如
<display:table name="test" pagesize="10"/>

2. 對列排序
display tag可對列進行排序，就是點選列名，對該列的資料進行排序。你只需對想要排序的列新增 sort="true" 就OK，如下面的程式碼可對前三列進行排序。在display:table中新增defaultsort="列數"，可預設對指定的列排序。
<display:table name="test" styleClass="list" cellspacing="0" cellpadding="0" defaultsort="1">
<display:column property="id" title="ID" class="idcol" sort="true"/>
<display:column property="name" url="detail.jsp" paramId="id" paramProperty="id" sort="true"/>
<display:column property="email" autolink="true" sort="true"/>
<display:column property="description" title="Comments"/>
</display:table>
如果table有分頁，Display Tag預設只對當前頁進行排序，如果想對整個list排序，可以在display:table之間新增一段程式碼：
<display:setProperty name="sort.amount" value="list"/>

3. 匯出資料
在display:table中新增export="true"，看看會出現什麼！Display Tag預設會提供三種資料匯出方式：CSV、Excel、XML 。
另外Display Tag還可以匯出為PDF格式，在http://prdownloads.sourceforge.net/itext/下載一個輔助包iText.jar，copy到lib目錄下，然後在display:table之間新增一段程式碼：
<display:setProperty name="export.pdf" value="true"/>，大功告成。

4. Display Tag的屬性設定
前面所說的display:setProperty 是一種改變Display Tag屬性的方法，但是在每個jsp中都要寫太麻煩了。
Display Tag中設定了很多預設的屬性，它有一個專門的屬性檔案，是在它的jar包中的displaytag/properties/TableTag.properties
想要改變它的預設屬性，我們可以在WEB-INF\classes下新建一個檔案displaytag.properties，仿照TableTag.properties中屬性的格式設定需要修改的屬性。
TableTag.properties中的# messages中設定的是顯示在頁面上的提示資訊。預設是英文的，我們可以把它改為中文的。不過這裡只能使用unicode，就是說中文字元必須轉換為unicode碼，這個可以使用jdk自帶的native2ascii.exe進行轉換。

5. 其它功能
DisplayTag還有一些很實用的小功能，這裡提兩個。一個是對資料的Format，這是1.1版本新增的新功能，可以使用標籤的方式格式化時間、數字、字串。比如日期，在需要格式化的column標籤中新增format="{0,date,yyyy-MM-dd}"，第一個引數為格式化的資料序號，第二個引數是資料型別，數字為number，第三個引數為資料格式。
另外一個功能是對table資料的合計功能。在table標籤中新增 decorator="org.displaytag.decorator.TotalTableDecorator"，然後在想要進行合計的資料列的column標籤中新增 total="true"，該列就可以被計算總數了。但這個功能有個缺點，不能用在有分頁的時候，它只能合計第一頁的資料。

DisplayTag的不足
初次使用DisplayTag的人可能會覺得驚喜，但是用久了會發現很多問題，最大的問題是對中文的支援不好，比如如果查詢條件中有中文，就無法翻頁，無法對中文排序，將中文匯出為指定檔案時出現亂碼等等。這些問題有時候會讓人很鬱悶，有時候逼得你要去修改它的原始碼。下面是對以上幾個問題的解決方法：
1. 對於中文無法翻頁、排序，最簡單的辦法是修改Tomcat下的server.xml檔案。找到HTTP的Connector標籤，在裡面新增一項URIEncoding="..."，引號裡面的內容取決於你的頁面編碼，比如可以是GBK，UTF8等。這樣上面兩個問題就可以解決了。
2. 匯出為檔案：其實這個功能除了中文支援外還有很多其它問題，比如它會將Html標籤一起匯出、只匯出顯示的內容，但如果對table進行了decorator，decorator後的內容無法匯出。如果想要將中文正確匯出，需要修改DisplayTag原始碼。
下載相同版本的原始碼，在org.displaytag.export.ExcelView.java檔案中找到getMimeType()方法，將此方法修改為 return "application/vnd.ms-excel;charset=GB2312";，修改後匯出資料的速度會慢很多，不過將就吧。
3. 新版的DisplayTag1.1添加了對一次取部分資料的支援，相關的標籤包括partialList和size，需要設定partialList="true"和size的大小。具體怎麼用偶還沒研究。