DisplayTag Tutorial by XXX

   写点儿东西真不容易，暂时写了这么些，先贴于此。
[b]DisplayTag Tutorial by DarrenWang[/b]
                   CopyRight June，2004:em510:
                   By DarrenWang，All Rights Reserved！

[b]【简介Introduction】[/b]
DisplayTag是一个开源的自定义标签库（Custom Tag lib），他提供了直接而有效的格式化web视图层数据的有效手段。你能够在如今流行的web应用的MVC模式中集成DisplayTag到View层，其提供的强大表格格式化功能必定会令你爱不释手。或许上面说的有些夸张了，可是DisplayTag在表格的格式化方面表现确实出色，固然，他也只能显示表格，视图层的大部分工做不就是使用表格来格式化数据嘛？！
 好了，让咱们经过图片来看看他是一个什么样子吧!^_^
[img]http://displaytag.sourceforge.net/p_w_picpaths/sample_snapshot.png[/img]
怎么样？是否是感受不错那？若是答案是确定的，那么你必定急着想本身试一试咯？！不要急，下面就让咱们开始咱们的DisplayTag之旅。

[b]【Hello DisplayTag】[/b]
既然是一个tutorial，因此，咱们不想对像自定义标签的实现原理等进行解释，也就是说在此以前，咱们假定你已经对自定义标签有必定的认识，固然，没有也无所谓，等这篇tutorial完成后，你估计就会了解的差很少了。
 呐，让咱们从最简单的displaytag的使用开始，就跟你的第一个程序每每是从HelloWorld程序开始同样。
 先忽略其余的配置问题，咱们的JSP文件的源代码以下：
[img]/user11/darrenwang/upload/2004639261011063.gif[/img]
实际上，除去初始化和数据准备等操做，生成表格的代码只有一行，那就是：
<display:table name="InfoList">
</display:table>
 而他生成的表格就是这样的：
[img]/user11/darrenwang/upload/200463927041199.gif[/img]
怎么样？是否是很简单那？简单的代码就能够生成如此漂亮的表格，你有理由不用嘛？（由于使用了Struts的LabelValueBean，因此表格上显示了原始的title，不用着急，后面咱们将会说道如何修改为你所期待的样子）

[b]【配置configuration】[/b]
Ok，在咱们运用DisplayTag以前，咱们须要对他的使用环境进行一些配置，或许有些复杂，可是，若是你是一个WebApp老手的话，其实并不难。
 固然，在此以前，咱们须要下载DisplayTag，当前的最新版本是displaytag-1.0-b3。你能够去SourceForge下载它，下载网址是： [url]http://displaytag.sourceforge.net/download.html[/url] 。  2．1 DisplayTag的类库，依赖库和TLD文件的添加  解压下载下来的displaytag的压缩包，以后依次拷贝displaytag-1.0-b3.jar和lib目录下面的全部jar文件到你本身的WEBAPP_HOME/WEB-INF/lib目录下面，拷贝displaytag-11.tld，displaytag-12.tld和displaytag-el-12.tld到WEBAPP_HOME/WEB-INF目录下面。  他的依赖库包括：commons-beanutils，commons-collections，commons-lang以及commons-logging。  这里须要注意的问题就是，若是你连同Struts一块儿使用的话，DisplayTag的依赖库实际上都包括在Struts1.1的发布包中，你只须要将displaytag-1.0-b3.jar文件拷贝到你本身的WEBAPP_HOME/WEB-INF/lib目录下面就能够了。  另一个重要的问题就是，若是你的Struts1.1发布包中的commons lang包不是2.0版本或者更高版本的话，须要去Apache的Jakarta commons项目主页上下载2.0版本的commons-lang类库，并替换掉原来的commons-lang类库，不然，运行的时候将报错误并不能运行。  2．2 web.xml的配置  要使用DisplayTag提供的自定义标签，跟其余自定义标签的使用没有什么两样，一样，须要在web.xml文件中注册taglib，下面是笔者的web.xml文件中taglib注册的片段： <taglib>     <taglib-uri>[url]http://displaytag.sf.net</taglib-uri>[/url]     <taglib-location>/WEB-INF/displaytag-11.tld</taglib-location>   </taglib>   <taglib>     <taglib-uri>[url]http://displaytag.sf.net</taglib-uri>[/url]     <taglib-location>/WEB-INF/displaytag-12.tld</taglib-location>   </taglib>   <taglib>     <taglib-uri>[url]http://displaytag.sf.net/el</taglib-uri>[/url]     <taglib-location>/WEB-INF/displaytag-el-12.tld</taglib-location>   </taglib>  在这里有必要说明一下这三个tld之间的区别，这其实在DisplayTag的官方网站上有提到，这里只是重复一下：displaytag-11.tld 只是提供对JSP1.1规范的的支持，而displaytag-12.tld则提供了对JSP1.2规范的支持，最后的displaytag-el-12.tld除了提供跟displaytag-12.tld提供的特性以外，他提供对Expression Lanuage的支持。因此，为了在web应用移植于不一样的app server的时候能够更少的修改文件，这里将全部的tld都添加在这里以便使用。  配置完成taglib后，下面是可选择的配置项，若是你不须要的话，能够不进行配置，但建议仍是配置他们为好。  第一幅图中能够看到diaplaytag提供了数据的导出功能，若是说你的Table存在的页面被include在另外一个页面中，好比若是你使用Struts的话，那么Tiles的使用就是这种状况，那么你须要为web.xml中添加filter，以便数据处处功能可以工做正常。  首先，在web.xml中添加如下filter配置项（按照web.xml文件中各个elements的顺序规定，须要将<filter>元素添加在<servlet>前面，如下相似的状况请参考web.xml规范）：  <filter> <filter-name>ResponseOverrideFilter</filter-name> <filter-class>org.displaytag.filter.ResponseOverrideFilter</filter-class> </filter>  其次，添加filter的映射：  <filter-mapping> <filter-name>ResponseOverrideFilter</filter-name> <url-pattern>*.do</url-pattern> </filter-mapping> <filter-mapping> <filter-name>ResponseOverrideFilter</filter-name> <url-pattern>*.jsp</url-pattern> </filter-mapping>  这样，对于web.xml的配置基本就完成了。对于I18N在web.xml文件中进行配置的手段，将在后面提到，不纳入此类。  2．3属性文件的配置（displaytag.properties）  DisplayTag提供了一个属性文件（displaytag.properties）来定义表格显示的时候提供的信息，好比分页显示或者导出数据等的提示信息等，可是由于这个属性文件默认的文件随jar文件一块儿发布并且是英文的，因此，咱们须要对其进行定制以知足中文或者其余平台下的使用。  要对这个属性文件进行定制，有三种途径：  【1】使用<display:setProperty>标签，这个标签能够对单个的属性进行设置，也就是说若是要对整个的应用页面都进行定制的话，须要每一个页面都使用这个标签并对每个要定制的属性都使用它，这很明显不是太行得通，因此，displaytag还提供了下面得途径；  【2】使用DisplayPropertiesLoaderServlet来初始化环境，这种方式方式能够对整个应用的属性进行定制，可是，笔者使用这种方式的时候报错，不过，仍是将其在web.xml文件中的配置项列于此： <servlet id="DisplayPropertiesLoaderServlet">     <servlet-name>DisplayPropertiesLoaderServlet</servlet-name>     <display-name>DisplayPropertiesLoaderServlet</display-name>     <description>displaytag initialization servlet</description> <servlet-class>org.displaytag.properties.DisplayPropertiesLoaderServlet</servlet-class>     <init-param>       <param-name>properties.filename</param-name>       <param-value>/WEB-INF/displaytag.properties</param-value>     </init-param>     <load-on-startup>1</load-on-startup>   </servlet>  这种方法也是读取diaplaytag.properties中的属性配置对整个应该环境进行定制。  最后，也就是就第三中方式，也是笔者最经常使用的方式，那就是：  【3】新建一个diaplaytag.properties属性文件，向该文件中添加须要覆盖的或者须要另外定制的属性（具体有那些属性，DisplayTag网站提供了一个PDF格式的manual，上面有全部可使用的属性的列表，由于太长，因此这里不做罗列）。这个文件的一个样本笔者将在后面的实例部分进行罗列。在准备好属性文件后，将其放到WEBAPP_HOME/WEB-INF/classes目录下面就能够了。我想这也比其余方式方便的多，另外，这种方式也是针对整个的WEB应用进行定制。  以上就是配置文件的三种配置方式，第一种只能对单个属性单个页面进行，然后面两种方式能够针对整个的web应用，尤为是第三种方式，笔者尤为倡导。  2．4 CSS和img的移植  若是说你试着将页面中的这一句去掉的话： <link rel="stylesheet" href="<%=request.getContextPath()%>/css/screen.css" type="text/css" media="screen, print" />，或许你会看到不想看到的景象，或者说你看到的表格将与你所期待的截然不同： [img]/user11/darrenwang/upload/2004639444276758.gif[/img] 怎么样？与上面的简单实例相比，是否是淡色很多？！因此，要使得Displaytag提供最好的显示效果，或者说要显示正常，咱们不但要保证服务器端的配置，一样的也要保证视图层的配置，好比说CSS和Images。  故此，建议将下载的压缩包中的diaplaytag.war文件包中的css目录和img目录拷贝到你当前工做的WEBApp的根目录下面，这样，就能够避免以上的事情发生。固然，这只是能够正常显示的必要条件，像上面那样，若是页面中不引入css的话，一样会显示不正常。  至此，你的Displaytag的配置就算完成了。怎么样？是否是有些繁琐那？！不过不用担忧，与它所带给你的便捷和强大的功能