幸せのちから

最小的Jars要求：

PDF導(dǎo)出需要的Jars：

XLS導(dǎo)出需要的Jars：

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

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

將extremecomponents.jar文件拷貝到你的工程的/WEB-INF/lib目錄下。

處理TLD文件有兩種方式。 你可以把extremecomponents.tld文件放到WEB-INF目錄下的任何地方。 不過(guò)，為了便于管理，我喜歡把我的TLD文件都放到/WEB-INF/tld目錄下。你需要根據(jù)你的extremecomponents.tld 文件的位置來(lái)修改/WEB-INF/web.xml文件的標(biāo)簽映射。

<taglib>
    <taglib-uri>/tld/extremecomponents</taglib-uri>
    <taglib-location>/WEB-INF/tld/extremecomponents.tld</taglib-location>
</taglib>

隨后，你需要向下面一樣在你的JSP里把eXtremeTable包含進(jìn)來(lái)：

<%@ taglib uri="/tld/extremecomponents" prefix="ec" %>

如果你的servlet容器支持JSP 1.2 (或更高版本)，它將能夠自動(dòng)發(fā)現(xiàn)TLD文件，那么你什么也不需要做。 當(dāng)extremecomponents.jar被容器加載的時(shí)候，在它的META-INF目錄下的extremecomponents.tld文件將被找到。 這時(shí)，你需要向下面一樣在你的JSP里把eXtremeTable包含進(jìn)來(lái)：

<%@ taglib uri="http://www.extremecomponents.org" prefix="ec" %>

為了使用eXtremeTable樣式，從styles目錄拷貝extremecomponents.css到你存放.css腳本的地方。 當(dāng)然在JSP頁(yè)面里，你需要提供一個(gè)到CSS的鏈接。就像我將我的樣式表放在/styles目錄下。

<%@ taglib uri="/tld/c" prefix="c" %>
<link rel="stylesheet" type="text/css" href="<c:url value="/styles/extremecomponents.css"/>">

為了使導(dǎo)出功能有效，你需要設(shè)置導(dǎo)出過(guò)濾器。這是一個(gè)僅用于導(dǎo)出功能的可選配置。

如下所示在/WEB-INF/web.xml里配置過(guò)濾器：

<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>

過(guò)濾器還有一個(gè)可選的初始化參數(shù)，用于決定什么時(shí)候生成報(bào)頭（headers）。我發(fā)現(xiàn)大多數(shù)的servlet容器 傾向于在調(diào)用過(guò)濾器的doFilter()方法后才設(shè)置響應(yīng)報(bào)頭（response headers）。然而，一些servlet容器只有在 調(diào)用過(guò)濾器的doFilter()方法前設(shè)置響應(yīng)報(bào)頭，過(guò)濾器才能正常工作。默認(rèn)的方法是調(diào)用過(guò)濾器的doFilter()方法后 設(shè)置響應(yīng)報(bào)頭，你可以通過(guò)使用responseHeadersSetBeforeDoFilter這個(gè)初始化參數(shù)調(diào)整它。

<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擴(kuò)展了正常的 sitemesh的PageFilter，它使得正在進(jìn)行導(dǎo)出的JSP頁(yè)面不被修飾。

如下所示在/WEB-INF/web.xml里配置過(guò)濾器：

<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>

使用發(fā)行包的test.jsp來(lái)測(cè)試安裝。將test.jsp拷貝到web應(yīng)用的最頂層， 默認(rèn)的圖片文件在 /images/table/子目錄下。為了測(cè)試，創(chuàng)建相應(yīng)的目錄并將拷貝所有需要的圖片。所有工作都完成后，你可以在瀏覽 器里運(yùn)行test.jsp了。

提示: 我不提倡在JSP里使用腳本（scriplets），但為了不用使用框架而能進(jìn)行快速測(cè)試，在test.jsp 使用腳本是唯一的辦法。