-
Servlet 2.3或更高版本
-
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
从sourceforge
下载发行包。(http://sourceforge.net/projects/extremecomp/)
在压缩文件里你能找到开始使用需要的所有东西:
-
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="http://www.extremecomponents.org" 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"/>">
为了使导出功能有效,你需要设置导出过滤器。这是一个仅用于导出功能的可选配置。
如下所示在/WEB-INF/web.xml里配置过滤器:
<filter>
<filter-name>eXtremeExport</filter-name>
<filter-class>org.extremecomponents.table.filter.ExportFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>eXtremeExport</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
过滤器还有一个可选的初始化参数,用于决定什么时候生成报头(headers)。我发现大多数的servlet容器
倾向于在调用过滤器的doFilter()方法后才设置响应报头(response headers)。然而,一些servlet容器只有在
调用过滤器的doFilter()方法前设置响应报头,过滤器才能正常工作。默认的方法是调用过滤器的doFilter()方法后
设置响应报头,你可以通过使用responseHeadersSetBeforeDoFilter这个初始化参数调整它。
<filter>
<filter-name>eXtremeExport</filter-name>
<filter-class>org.extremecomponents.table.filter.ExportFilter</filter-class>
<init-param>
<param-name>responseHeadersSetBeforeDoFilter</param-name>
<param-value>true</param-value>
</init-param>
</filter>
如果你使用了Sitemesh,你将需要包含SitemeshPageFilter。SitemeshPageFilter扩展了正常的
sitemesh的PageFilter,它使得正在进行导出的JSP页面不被修饰。
如下所示在/WEB-INF/web.xml里配置过滤器:
<filter>
<filter-name>Sitemesh</filter-name>
<filter-class>org.extremecomponents.table.filter.SitemeshPageFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>Sitemesh</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
使用发行包的test.jsp来测试安装。将test.jsp拷贝到web应用的最顶层, 默认的图片文件在
/images/table/子目录下。为了测试,创建相应的目录并将拷贝所有需要的图片。所有工作都完成后,你可以在浏览 器里运行test.jsp了。
提示: 我不提倡在JSP里使用脚本(scriplets),但为了不用使用框架而能进行快速测试,在test.jsp
使用脚本是唯一的办法。