display Tag

 關於display:tag的使用 (2011-09-05 14:03:26)
轉載
▼
標籤： it     分類： J2EE

關於display:tag的使用
自定義描述：
display:tag用來處理jsp網頁上的Table，功能很是強，能夠對的Table進行分頁、數據導出、分組、對列排序等等，反正我在作項目時須要的功能它都給我提供了，並且使用起來很是的方便。可以大大減小代碼量。
一.display：tag使用步驟：
 1.首先要下載display:tag的jar包了。將jar包放到WEB-INF的lib文件夾下。另外還須要其餘輔助包：apache的commons-lang，commons-collections和standard包.
 其它包能夠訪問：Display Tag的官方網站http://displaytag.sourceforge.net。
 2.在web.xml添加   
 <taglib>
  <taglib-uri>http://displaytag.sf.net</taglib-uri>
  <taglib-location>/WEB-INF/displaytag.tld</taglib-location>
 </taglib>

 3.在jsp頁面添加display：tag標籤說明
 <%@ taglib uri="http://displaytag.sf.net" prefix="display" %>
2、經常使用功能：
 1.分頁
 分頁，只需在display:table標籤中添加一項pagesize="每頁顯示行數"，
 例如：<display:table name="test" pagesize="10"/>
 2.排序
  display tag可對列進行排序，就是點擊列名，對該列的數據進行排序。只需對想要排序的列添加 sort="true"就能夠了，在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" 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"DisplayTag，默認會提供三種數據導出方式：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.分組
  分組只是須要在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>
 
三.標籤取得數據的數據源
 1.範圍：有四種
 pageScope
 requestScope (默認)　<display:table name="test2" >
 sessionScope　<display:table name="sessionScope.holder.list" > 注意，這裏要指定範圍，非默認
 applicationScope
 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進行轉換。
 4、經過增長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裏建立了一個隱含對象，指向List裏的當前對象，
能夠經過(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" />
  <display:column property="url" />
 </display:table>

若是要顯示的對象裏包含email和url地址，則能夠在display:column裏直接設定來直接鏈接
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，而後‘油漆’
建立動態鏈接
有兩種方法建立動態鏈接：
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?&action=view\">View</a> | "
+ "<a href=\"details.jsp?&action=edit\">Edit</a> | "
+ "<a href=\"details.jsp?&action=delete\">Delete</a>";
}
導出數據到其餘格式（頁面溢出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>
         配置屬性，覆蓋默認
兩種方法：
A、在程序classpath下新建displaytag.properties文件
B、對於單個表格，應用<display:setProperty>標籤
具體可配置的屬性：http://displaytag.sourceforge.net/configuration.html
具體示例：
<display:table name="test" export="true" sort="list" pagesize="8">
<display:column property="city" title="CITY" group="1" sortable="true" headerClass="sortable"/>
<display:column property="project" title="PROJECT" group="2" sortable="true" headerClass="sortable"/>
<display:column property="amount" title="HOURS"/>
<display:column property="task" title="TASK"/>
</display:table>
sort="list" 對整個list進行排序
導出數據到其餘格式時，group無效
在這裏我要提出一點,當display tag顯示的數據與後臺所給的數據不一致,能夠用JSTL:
<display:table name=".." id="listTable" pagesize=".." class=".."
                   export="true" requestURI="">
<display:column sortable="true" headerClass="sortable" title="TYPE">
            <c:if test="${listTable.type==0}"><!--listTable必須與上面的display:table的id屬性值相同-->
                類型0
      </c:if>
            <c:if test="${listTable.type==1}">
                類型1
     </c:if>
            <c:if test="${listTable.type==2}">
                類型2
    </c:if>
            <c:if test="${listTable.type==3}">
                類型3
    </c:if>
        </display:column>