Chapter 1. 配置

Chapter 1. 配置

Chapter 1. 配置

1.1. 先决条件

• 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

1.2. 安装

从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"/>">

1.3. 导出过滤器(可选)

为了使导出功能有效，你需要设置导出过滤器。这是一个仅用于导出功能的可选配置。

如下所示在/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>

1.4. 安装测试

使用发行包的test.jsp来测试安装。将test.jsp拷贝到web应用的最顶层， 默认的图片文件在 /images/table/子目录下。为了测试，创建相应的目录并将拷贝所有需要的图片。所有工作都完成后，你可以在浏览 器里运行test.jsp了。

提示: 我不提倡在JSP里使用脚本（scriplets），但为了不用使用框架而能进行快速测试，在test.jsp 使用脚本是唯一的办法。