Web開發(fā)設(shè)計:DisplayTag應(yīng)用指南
2024-07-21 02:15:01
供稿：網(wǎng)友
displaytag是一個非常好用的表格顯示標(biāo)簽，適合mvc模式，其主頁在http://displaytag.sourceforge.net
一、最簡單的情況，未使用<display:column/>標(biāo)簽
<%request.setattribute( "test", new reportlist(6) );%>
<display:table name="test" />
標(biāo)簽遍歷list里的每一個對象，并將對象里的所有屬性顯示出來。一般用于開發(fā)的時候檢查對象數(shù)據(jù)的完整性。
二、使用<display:column/>標(biāo)簽的情況
<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對應(yīng)list里對象的屬性（用getxxx()方法取得），title則對應(yīng)表格表頭里的列名。定義列有兩種方式：
a、<display:column property="email" />
使用<display:column/>標(biāo)簽里的property屬性來定義
b、<display:column title="email">[email protected]</display:column>
在<display:column/>標(biāo)簽體里增加內(nèi)容，可以是常量，也可以用其他標(biāo)簽等等
兩種方式比較，用property屬性來定義更加快速和利于排序。
三、表格顯示樣式的定義
a、在<display:table/>和<display:column/>標(biāo)簽里指定標(biāo)準(zhǔn)的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屬性來指定所要應(yīng)用的樣式?？梢栽谄淠J(rèn)樣式表里（./css/screen.css）直接修改
四、標(biāo)簽取得數(shù)據(jù)的數(shù)據(jù)源
有四種范圍
pagescope
requestscope (默認(rèn)) <display:table name="test2" >
sessionscope <display:table name="sessionscope.holder.list" > 注意，這里要指定范圍，非默認(rèn)
applicationscope
五、通過增加id屬性創(chuàng)建隱含的對象
<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里創(chuàng)建了一個隱含對象，指向list里的當(dāng)前對象，
可以通過(listobject)pagecontext.getattribute("id")來捕獲這個對象。同時還創(chuàng)建了一個id_rownum對象，同樣，可
通過pagecontext.getattribute("testit_rownum")來捕獲，它僅僅代表當(dāng)前行的行數(shù)。
有了這兩個隱含對象，就可以通過其他標(biāo)簽來訪問，例如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>
六、顯示部分?jǐn)?shù)據(jù)
顯示開始五條數(shù)據(jù)：通過設(shè)定length屬性
<display:table name="test" length="5">
<display:column property="id" title="id" />
<display:column property="email" />
<display:column property="status" />
</display:table>
顯示第三到第八條數(shù)據(jù)：通過設(shè)定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里直接設(shè)定autolink="true"來直接連接
八、使用裝飾模式轉(zhuǎn)換數(shù)據(jù)顯示（寫自己的 decorator ）
a、對整個表格應(yīng)用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()方法獲得當(dāng)前對象，然后對其getmoney()方法進(jìn)行‘油漆’
b、對單獨(dú)的column應(yīng)用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要實現(xiàn)columndecorator接口，它的方法：
public final string decorate(object columnvalue)
{
date date = (date) columnvalue;
return this.dateformat.format(date);
}
顯然，它獲得不了當(dāng)前對象（因為它實現(xiàn)的是接口），僅僅是獲得該對象的columnvalue，然后‘油漆’
九、創(chuàng)建動態(tài)連接
有兩種方法創(chuàng)建動態(tài)連接：
a、在<display:column/>里通過增加href、paramid、paramname、paramscope、paramproperty屬性
href 基本的url 地址
paramid 加在url 地址后的參數(shù)名稱
paramname 數(shù)據(jù)bean的名稱，一般為null（即使用當(dāng)前l(fā)ist里的對象）
paramscope 數(shù)據(jù)bean的范圍，一般為null
paramproperty 數(shù)據(jù)bean的屬性名稱，用來填充url 地址后的參數(shù)值
<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>
這種方法簡便直接，但缺點是無法產(chǎn)生類似details.jsp?id=xx&action=xx的復(fù)合url
b、應(yīng)用decorator 創(chuàng)建動態(tài)連接：
<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>";
}
十、分頁
實現(xiàn)分頁非常的簡單，增加一個pagesize屬性指定一次想顯示的行數(shù)即可
<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>
十一、排序
排序?qū)崿F(xiàn)也是很簡單，在需要排序的column里增加sortable="true"屬性，headerclass="sortable"僅僅是
指定顯示的樣式。column里的屬性對象要實現(xiàn)comparable接口，如果沒有的話可以應(yīng)用decorator
defaultsort="1" 默認(rèn)第一個column排序
defaultorder="descending" 默認(rèn)遞減排序
<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>
注意的是，當(dāng)同時存在分頁時排序僅僅針對的是當(dāng)前頁面，而不是整個list都進(jìn)行排序
十二、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>
十三、導(dǎo)出數(shù)據(jù)到其他格式（頁面溢出filter??）
在<display:table/>里設(shè)定export="true"
在<display:column/>里設(shè)定media="csv excel xml pdf" 決定該字段在導(dǎo)出到其他格式時被包不包含，不設(shè)定則都包含
<display:setproperty name="export.csv" value="false" />
決定該種格式能不能在頁面中導(dǎo)出
<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>
十四、配置屬性，覆蓋默認(rèn)
兩種方法：
a、在程序classpath下新建displaytag.properties文件
b、對于單個表格，應(yīng)用<display:setproperty>標(biāo)簽
具體可配置的屬性：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進(jìn)行排序
導(dǎo)出數(shù)據(jù)到其他格式時，group無效
