幸せのちから

最小的Jars要求：

PDF導出需要的Jars：

XLS導出需要的Jars：

從sourceforge 下載發行包。(http://sourceforge.net/projects/extremecomp/)

在壓縮文件里你能找到開始使用需要的所有東西：

將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 使用腳本是唯一的辦法。