eXtremeComponents开发指南.docVIP

前言 eXtremeComponents是一系列提供高级显示的开源JSP定制标签。当前的包含 的组件为eXtremeTable，用于以表的形式显示数据。 本文档处于更新中。大部分章节我将仅仅描述如何使用eXtremeTable。当然， 为了使程序高效并具有更高的灵活性，源代码被再三重构。随后, 我认为阐述一下如 何做设计决定是值得的。我希望大家能知道使用extremeTable是多么容易，并且所 有的东西都是可配置。如果你有任何的要求和建议, 请及时通过论坛或者 extremecomponents@和我联系。 我想感谢Chris Bauer(Hibernate开发小组)和Rod Johnson(Spring开发小组)。 Chris提供并修改了DocBook-XSL使它能生成Hibernate参考指南。Rod对于使用从Hibernate 得到的这个软件来生成Spring文档提供了支持。我现在用它来生成eXtremeComponents的文档。 译者注:如果大家有什么疑问和建议，可以通过xplucky@和我联系。 Chapter 1. 配置 [edit] 1.1. 先决条件 * JDK 1.3.1或更高版本 最小的Jars要求： * commons-beanutils 1.6 * commons-collections 3.0 * commons-lang 2.0 * commons-logging 1.0.4 * standard 1.0.2 PDF导出需要的Jars： * minimum jars (above) * avalon-framework 4.0 * batik 1.5-fop-0.20-5 * fop 0.20.5 * xalan 2.5.1 * xercesImpl 2.6.1 * xml-apis 2.0.2 XLS导出需要的Jars： * minimum jars (above) * poi-2.5.1.jar [edit] 1.2. 安装 从sourceforge 下载发行包。 在压缩文件里你能找到开始使用需要的所有东西： * extremecomponents.jar * extremecomponents.tld * extremecomponents.css * 默认的一组图片 * 源代码 * test.jsp (用于确认安装是否正确) 将extremecomponents.jar文件拷贝到你的工程的/WEB-INF/lib目录下。 处理TLD文件有两种方式。 你可以把extremecomponents.tld文件放到WEB-INF目录下的任何地方。 不过，为了便于管理，我喜欢把我的TLD文件都放到/WEB-INF/tld目录下。你需要根据你的extremecomponents.tld 文件的位置来修改/WEB-INF/web.xml文件的标签映射。 taglib taglib-uri/tld/extremecomponents/taglib-uri taglib-location/WEB-INF/tld/extremecomponents.tld/taglib-location /taglib 随后，你需要向下面一样在你的JSP里把eXtremeTable包含进来： %@ taglib uri=/tld/extremecomponents prefix=ec % 如果你的servlet容器支持JSP 1.2 (或更高版本)，它将能够自动发现TLD文件，那么你什么也不需要做。 当extremecomponents.jar被容器加载的时候，在它的META-INF目录下的extremecomponents.tld文件将被找到。 这时，你需要向下面一样在你的JSP里把eXtremeTable包含进来： %@ taglib uri= prefix=ec % 为了使用eXtremeTable样式，从styles目录拷贝extremecomponents.css到你存放.css脚本的地方。 当然在JSP页面里，你需要提供一个到CSS的链接。就像我将我的样式表放在/styles目录下。 %@ taglib uri=/tld/c prefix=c % link rel=stylesheet type=text/css href=c:url value=/styles/extremecomponents.css/ 1.3. 导出过滤器(可选) 为了使导出功能有效，你需要设置导出过滤器。这是一个仅