Web開發設計:DisplayTag應用指南

來源:互聯網
上載者:User
web|設計   DisplayTag是一個非常好用的表格顯示標籤,適合MVC模式,其首頁在http://displaytag.sourceforge.net
  
   一、最簡單的情況,未使用<display:column/>標籤
  
  <%request.setAttribute( "test", new ReportList(6) );%>
  <display:table name="test" />
  
  標籤遍曆List裡的每一個對象,並將對象裡的所有屬性顯示出來。一般用於開發的時候檢查對象資料的完整性。
  
   二、使用<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屬性來定義更加快速和利於排序。
  
   三、表格顯示樣式的定義
  
  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屬性來指定所要應用的樣式。可以在其預設樣式表裡(./css/screen.css)直接修改
  
   四、標籤取得資料的資料來源
  
  有四種範圍
  
  pageScope
  requestScope (預設) <display:table name="test2" >
  sessionScope <display:table name="sessionScope.holder.list" > 注意,這裡要指定範圍,非預設
  applicationScope
  
   五、通過增加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>
  
   六、顯示部分資料
  
  顯示開始五條資料:通過設定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>
  
   七、對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"來直接連接
  
   八、使用裝飾模式轉換資料顯示(寫自己的 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?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>";
  }
  
   十、分頁
  
  實現分頁非常的簡單,增加一個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>
  
   十一、排序
  
  排序實現也是很簡單,在需要排序的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都進行排序
  
   十二、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>
  
   十三、匯出資料到其他格式(頁面溢出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無效

相關文章

Beyond APAC's No.1 Cloud

19.6% IaaS Market Share in Asia Pacific - Gartner IT Service report, 2018

Learn more >

Apsara Conference 2019

The Rise of Data Intelligence, September 25th - 27th, Hangzhou, China

Learn more >

Alibaba Cloud Free Trial

Learn and experience the power of Alibaba Cloud with a free trial worth $300-1200 USD

Learn more >

聯繫我們

該頁面正文內容均來源於網絡整理,並不代表阿里雲官方的觀點,該頁面所提到的產品和服務也與阿里云無關,如果該頁面內容對您造成了困擾,歡迎寫郵件給我們,收到郵件我們將在5個工作日內處理。

如果您發現本社區中有涉嫌抄襲的內容,歡迎發送郵件至: info-contact@alibabacloud.com 進行舉報並提供相關證據,工作人員會在 5 個工作天內聯絡您,一經查實,本站將立刻刪除涉嫌侵權內容。