BlogJava-seasun-随笔分类-1.9 displaytaghttp://www.blogjava.net/shiwenfeng/category/42493.html在不断模仿、思考、总结中一步一步进步！zh-cnFri, 30 Oct 2009 04:26:58 GMTFri, 30 Oct 2009 04:26:58 GMT60DisplayTag应用指南http://www.blogjava.net/shiwenfeng/archive/2009/10/30/300317.htmlshiwfshiwfFri, 30 Oct 2009 03:38:00 GMThttp://www.blogjava.net/shiwenfeng/archive/2009/10/30/300317.htmlhttp://www.blogjava.net/shiwenfeng/comments/300317.htmlhttp://www.blogjava.net/shiwenfeng/archive/2009/10/30/300317.html#Feedback0http://www.blogjava.net/shiwenfeng/comments/commentRss/300317.htmlhttp://www.blogjava.net/shiwenfeng/services/trackbacks/300317.html转载：http://www.javaeye.com/topic/24869
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>
  注意的是，当同时存在分页时如果不指定sort=list,则排序仅仅针对的是当前页面，而不是整个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无效




shiwf 2009-10-30 11:38 发表评论
]]>DisplayTag导出Excel的处理过程http://www.blogjava.net/shiwenfeng/archive/2009/10/30/300315.htmlshiwfshiwfFri, 30 Oct 2009 03:29:00 GMThttp://www.blogjava.net/shiwenfeng/archive/2009/10/30/300315.htmlhttp://www.blogjava.net/shiwenfeng/comments/300315.htmlhttp://www.blogjava.net/shiwenfeng/archive/2009/10/30/300315.html#Feedback0http://www.blogjava.net/shiwenfeng/comments/commentRss/300315.htmlhttp://www.blogjava.net/shiwenfeng/services/trackbacks/300315.html 使用实在是太Easy了，只需要在display:table标签上设置一下参数，export="true"，就可以在表格下边看到导出Excel的链接了，其他什么都不用做！

    对他的实现方式有点好奇，遂查看一下这个导出功能的链接，乖乖，那是相当简洁啊，就是把我这个页面的全部参数添加到URL里，然后附加上了几个奇怪数字组成的参数，估计就是DisplayTag用来识别我要做导出操作的了。从这个链接来看，做导出操作时还是要到我这个Action去进行逻辑处理，但我这个Action输出的内容可是一个完整的HTML，而不是Excel啊，他是怎么实现的呢？带着个大大的问号，开始去挖源代码。顺便提一下，m2eclipse确实方便，不但帮我管理了项目的依赖，还能帮我把源代码拽下来关联到相应的jar，所以我直接在项目依赖里面找到displaytag.jar，就可以查看源代码了。

    代码其实很简单，其实是利用了ServletRsponse的缓存机制，当我们调用response.getWriter().print()方法时，打印的内容是不会立即发送到客户端的，在发送到客户端之前，还可以对其进行操作，哈哈，有点明白了吧？DisplayTag就是利用了这个原理，在TableTag这个类中，导出Excel时，趁ServletResponse还没有提交到客户端，先执行了一下response.reset()和pageContext.getOut().clearBuffer()，这样就把前面jsp里面输出的所有内容都清除掉了~然后再使用response.setContentType()重新设置文件类型，输出表格内容，完事了再返回Tag.SKIP_PAGE，这样JSP里面剩下的内容也不会再输出了，客户端得到的就完全是在DisplayTag控制下的内容了，牛吧！

    其实这个response.reset以前也见过，读servlet API文档时也看过方法的解释，但如果不是今天看这个Display的源代码，还真不会想到这样子来应用，看来这就是理论和实践的差距呀！！！

    PS:上面这种方法，只适用于输出文本内容。DisplayTag自带的Excel导出工具其实就是输出了一个csv文件，把扩展名改成xls了而已。如果要输出真正的xls文件获者PDF这样的二进制文件，使用上面的方法在某些中间件上就会有问题了。因为原则上response.getOutputStream方法是只能被调用一次的，这在进入jsp处理时就被调用了，而输出PDF文件这样二进制流时又必须使用这个方法，那就出错了。DisplayTag很巧妙的提供了一个Filter，对标准的ServletRepsonse做了一个包装(Wrap)，在执行Export导出时，如果是jsp等其他请求执行的response.getOutputStream，就返回自己的一个缓存的OutputStream，而不是真正去调用容器的这个方法。直到执行Export时，才去调用容器的方法，保证这个response.getOutputStream只执行一次。

    DisplayTag的地址：http://displaytag.sourceforge.net/1.2/index.html，很简单，很强大，强烈推荐，可以少写N多表格和分页标签





shiwf 2009-10-30 11:29 发表评论
]]>displaytag.properties 文件的详细说明http://www.blogjava.net/shiwenfeng/archive/2009/10/30/300314.htmlshiwfshiwfFri, 30 Oct 2009 03:28:00 GMThttp://www.blogjava.net/shiwenfeng/archive/2009/10/30/300314.htmlhttp://www.blogjava.net/shiwenfeng/comments/300314.htmlhttp://www.blogjava.net/shiwenfeng/archive/2009/10/30/300314.html#Feedback0http://www.blogjava.net/shiwenfeng/comments/commentRss/300314.htmlhttp://www.blogjava.net/shiwenfeng/services/trackbacks/300314.htmldisplaytag.properties文件位于displaytag-1.x.jar中的org.displaytag.properties下

打开这个文件，复制一份并作相应修改保存到classes目录下，就可以对View中的表格显示形式做相应的设置
Java代码
basic.empty.showtable=false #设置当数据为空时，是不是显示表格 true表示显示表格  
basic.show.header=true        #设置当数据为空时，显示的表格是否有表头 true表示显示  
 
 
# page | list 设置排序的数据量 相当于jsp页面中display标签中的page属性  
sort.amount=page  
 
export.amount=list  #导出的数据量  
export.decorated=true 
 
paging.banner.group_size=8  #前台显示的最多页数 8 表示最多显示8页  
paging.banner.placement=top  #前台显示中"上一页/下一页"文字的位置 top表示上面 bottom表示下面  
 
css.tr.even=even #偶数行的css标识 就是偶数行的css类 下面几个也是设置相应的css  class 
css.tr.odd=odd  
css.th.sorted=sorted  
css.th.ascending=order1  
css.th.descending=order2  
css.table=  
css.th.sortable=sortable  
 
# factory classes for extensions  
factory.requestHelper=org.displaytag.util.DefaultRequestHelperFactory  
 
# factory class for decorators  
factory.decorator=org.displaytag.decorator.DefaultDecoratorFactory  
 
# locale provider (Jstl provider by default)  
locale.provider=org.displaytag.localization.I18nJstlAdapter  
 
# locale.resolver (nothing by default, simply use locale from request)  
#locale.resolver=  
 
export.types=csv excel xml pdf  
 
export.csv.class=org.displaytag.export.CsvView  
export.excel.class=org.displaytag.export.ExcelView  
export.xml.class=org.displaytag.export.XmlView  
export.pdf.class=org.displaytag.export.PdfView  
#export.***设置为true表示显示这种导出方式 false为不采用  
export.csv=true 
export.csv.label=<span class="export csv">CSV </span>  
export.csv.include_header=false 
export.csv.filename=  
 
export.excel=true 
export.excel.label=<span class="export excel">Excel </span>  
export.excel.include_header=true 
export.excel.filename=  
 
export.xml=true 
export.xml.label=<span class="export xml">XML </span>  
export.xml.filename=  
 
export.pdf=false 
export.pdf.label=<span class="export pdf">PDF </span>  
export.pdf.include_header=true 
export.pdf.filename=  
 
export.rtf=false 
export.rtf.label=<span class="export rtf">RTF </span>  
export.rtf.include_header=true 
export.rtf.filename=  
 
# messages  
#相应的显示信息 包括空数据时候显示的 下两个显示的位置不一样 一个是在table中  一个是在下面  
basic.msg.empty_list=Nothing found to display.    
basic.msg.empty_list_row=<tr class="empty"><td colspan="{0}">Nothing found to display.</td></tr>  
error.msg.invalid_page=invalid page  
 
export.banner=<div class="exportlinks">Export options: {0}</div>#导出处的提示文字  
export.banner.sepchar= | #导出处的提示文字分隔符  
 
paging.banner.item_name=item   
paging.banner.items_name=items  
 
paging.banner.no_items_found=<span class="pagebanner">No {0} found.</span>  
paging.banner.one_item_found=<span class="pagebanner">One {0} found.</span>  
paging.banner.all_items_found=<span class="pagebanner">{0} {1} found, displaying all {2}.</span>  
paging.banner.some_items_found=<span class="pagebanner">{0} {1} found, displaying {2} to {3}.</span>  
 
paging.banner.full=<span class="pagelinks">[<a href="{1}">First</a>/<a href="{2}">Prev</a>] {0} [<a href="{3}">Next</a>/<a href="{4}">Last</a>]</span>  
paging.banner.first=<span class="pagelinks">[First/Prev] {0} [<a href="{3}">Next</a>/<a href="{4}">Last</a>]</span>  
paging.banner.last=<span class="pagelinks">[<a href="{1}">First</a>/<a href="{2}">Prev</a>] {0} [Next/Last]</span>  
paging.banner.onepage=<span class="pagelinks">{0}</span>  
 
paging.banner.page.selected=<strong>{0}</strong>  
paging.banner.page.link=<a href="{1}" title="Go to page {0}">{0}</a>  
paging.banner.page.separator=, \  
 
# external sort and pagination  
pagination.sort.param=sort  
pagination.sortdirection.param=dir  
pagination.pagenumber.param=page  
pagination.searchid.param=searchid  
pagination.sort.asc.value=asc  
pagination.sort.desc.value=desc  
pagination.sort.skippagenumber=true 
 
# unused  
save.excel.banner=<a href="{0}" rel="external">save ({1} bytes)</a>  
save.excel.filename=export.xls 
basic.empty.showtable=false #设置当数据为空时，是不是显示表格 true表示显示表格
basic.show.header=true        #设置当数据为空时，显示的表格是否有表头 true表示显示

# page | list 设置排序的数据量 相当于jsp页面中display标签中的page属性
sort.amount=page
export.amount=list  #导出的数据量
export.decorated=true
paging.banner.group_size=8  #前台显示的最多页数 8 表示最多显示8页
paging.banner.placement=top  #前台显示中"上一页/下一页"文字的位置 top表示上面 bottom表示下面
css.tr.even=even #偶数行的css标识 就是偶数行的css类 下面几个也是设置相应的css  class
css.tr.odd=odd
css.th.sorted=sorted
css.th.ascending=order1
css.th.descending=order2
css.table=
css.th.sortable=sortable
# factory classes for extensions
factory.requestHelper=org.displaytag.util.DefaultRequestHelperFactory
# factory class for decorators
factory.decorator=org.displaytag.decorator.DefaultDecoratorFactory
# locale provider (Jstl provider by default)
locale.provider=org.displaytag.localization.I18nJstlAdapter
# locale.resolver (nothing by default, simply use locale from request)
#locale.resolver=
export.types=csv excel xml pdf
export.csv.class=org.displaytag.export.CsvView
export.excel.class=org.displaytag.export.ExcelView
export.xml.class=org.displaytag.export.XmlView
export.pdf.class=org.displaytag.export.PdfView
#export.***设置为true表示显示这种导出方式 false为不采用
export.csv=true
export.csv.label=<span csv">CSV </span>
export.csv.include_header=false
export.csv.filename=
export.excel=true
export.excel.label=<span excel">Excel </span>
export.excel.include_header=true
export.excel.filename=
export.xml=true
export.xml.label=<span xml">XML </span>
export.xml.filename=
export.pdf=false
export.pdf.label=<span pdf">PDF </span>
export.pdf.include_header=true
export.pdf.filename=
export.rtf=false
export.rtf.label=<span rtf">RTF </span>
export.rtf.include_header=true
export.rtf.filename=
# messages
#相应的显示信息 包括空数据时候显示的 下两个显示的位置不一样 一个是在table中  一个是在下面
basic.msg.empty_list=Nothing found to display. 
basic.msg.empty_list_row=<tr ><td colspan="{0}">Nothing found to display.</td></tr>
error.msg.invalid_page=invalid page
export.banner=<div >Export options: {0}</div>#导出处的提示文字
export.banner.sepchar= | #导出处的提示文字分隔符
paging.banner.item_name=item
paging.banner.items_name=items
paging.banner.no_items_found=<span >No {0} found.</span>
paging.banner.one_item_found=<span >One {0} found.</span>
paging.banner.all_items_found=<span >{0} {1} found, displaying all {2}.</span>
paging.banner.some_items_found=<span >{0} {1} found, displaying {2} to {3}.</span>
paging.banner.full=<span >[<a href="{1}">First</a>/<a href="{2}">Prev</a>] {0} [<a href="{3}">Next</a>/<a href="{4}">Last</a>]</span>
paging.banner.first=<span >[First/Prev] {0} [<a href="{3}">Next</a>/<a href="{4}">Last</a>]</span>
paging.banner.last=<span >[<a href="{1}">First</a>/<a href="{2}">Prev</a>] {0} [Next/Last]</span>
paging.banner.onepage=<span >{0}</span>
paging.banner.page.selected=<strong>{0}</strong>
paging.banner.page.link=<a href="{1}" title="Go to page {0}">{0}</a>
paging.banner.page.separator=, \
# external sort and pagination
pagination.sort.param=sort
pagination.sortdirection.param=dir
pagination.pagenumber.param=page
pagination.searchid.param=searchid
pagination.sort.asc.value=asc
pagination.sort.desc.value=desc
pagination.sort.skippagenumber=true
# unused
save.excel.banner=<a href="{0}" rel="external">save ({1} bytes)</a>
save.excel.filename=export.xls


本文来自CSDN博客，转载请标明出处：http://blog.csdn.net/ZHOUJIAOSHOU/archive/2009/06/17/4277400.aspx



shiwf 2009-10-30 11:28 发表评论
]]>Display Tag使用http://www.blogjava.net/shiwenfeng/archive/2009/10/30/300313.htmlshiwfshiwfFri, 30 Oct 2009 03:25:00 GMThttp://www.blogjava.net/shiwenfeng/archive/2009/10/30/300313.htmlhttp://www.blogjava.net/shiwenfeng/comments/300313.htmlhttp://www.blogjava.net/shiwenfeng/archive/2009/10/30/300313.html#Feedback0http://www.blogjava.net/shiwenfeng/comments/commentRss/300313.htmlhttp://www.blogjava.net/shiwenfeng/services/trackbacks/300313.html     介个是Display Tag的官方网站

    首先当然是要下载它的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="$" />

    这是最简单的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-INFclasses下新建一个文件displaytag.properties，仿照TableTag.properties中属性的格式设置需要修改的属性。
    TableTag.properties中的# messages中设置的是显示在页面上的提示信息。默认是英文的，我们可以把它改为中文的。不过这里只能使用unicode，就是说中文字符必须转换为unicode码，这个可以使用jdk自带的native2ascii.exe进行转换。

5. 其它功能
    DisplayTag还有一些很实用的小功能，这里提两个。一个是对数据的Format，这是1.1版本添加的新功能，可以使用标签的方式格式化时间、数字、字符串。比如日期，在需要格式化的column标签中添加format=""，第一个参数为格式化的数据序号，第二个参数是数据类型，数字为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的大小。具体怎么用偶还没研究。



shiwf 2009-10-30 11:25 发表评论
]]>