eXtremeComponents文档
http://www.blogjava.net/lucky/archive/2010/01/19/33380.html
?
前言
1. 配置 1.1. 先決條件 1.2. 安裝 1.3. 導出過濾器(可選) 1.4. 安裝測試2. 概述 2.1. 引言3. TableTag 3.1. 引言 3.2. 顯示圖片 3.3. 過濾、排序和動作（Action） 3.4. 設定每頁顯示行數 3.5. 樣式 3.6. 保存表的狀態 3.7. 其他屬性 3.8. 擴展屬性4. RowTag 4.1. 引言 4.2. 高亮顯示行 4.3. 樣式 4.4. Javascript屬性 4.5. 擴展屬性5. ColumnTag 5.1. 引言 5.2. Cell 5.3. Filter Cell 5.4. Header Cell 5.5. 樣式 5.6. 解析和格式化 5.7. 過濾和排序 5.8. Calc 5.9. 允許和不允許視圖 5.10. 其他屬性 5.11. 擴展屬性6. ParameterTag 6.1. 引言7. ExportTag 7.1. 引言 7.2. 擴展屬性8. Callbacks 8.1. 引言 8.2. RetrieveRowsCallback 8.3. FilterRowsCallback 8.4. SortRowsCallback9. 視圖 9.1. 引言 9.2. 表視圖 9.3. 導出視圖10. Preferences 10.1. 引言 10.2. TableTag 10.3. ColumnTag 10.4. Advanced Techniques11. Messages 11.1. 資源綁定 11.2. 全局資源 11.3. TableTag 11.4. ColumnTag12. Limit 12.1. Limit指南 12.2. 創建Limit 12.3. Filter和Sort屬性 12.4. 設置頁和行屬性 12.5. Setup13. AutoGenerateColumns 13.1. 引言 13.2. ColumnsTag14. Utilities 14.1. 引言 14.2. HtmlBuilder15. 1.0.1-M4升級說明 15.1. 變更概述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"/>">
</ec:column>
</ec:row>
</ec:table>
切記bean中所有的屬性都是可訪問的，因此你甚至可以通過firstName屬性 來顯示下一頁。請注意firstName屬性是如何作為URL字符串傳輸的。
<ec:table
items="presidents"
var="pres"
action="${pageContext.request.contextPath}/presidents.run"
/>
<ec:row>
<ec:column property="lastName">
<a href="http://goto.president.detail?firstName=${pageScope.pres.firstName}">
${pageScope.presidents.lastName}
</a>
</ec:column>
</ec:row>
</ec:table>
我將不再在任何示例中強調pageScope。JSP標簽總是最先在pageScope中尋找任何對像, 因此我們總是能安全地返回正確的bean。
5.2.?Cell
每一列總是被實現Cell接口的對象修飾，你可以認為Cell是一個為了html顯示或導出而返回格式化值的對象。 發行包包含的Cell有DisplayCell、DateCell、 NumberCell和RowCountCell。 DisplayCell是僅僅顯示列值的默認cell；DateCell使用parse屬性（可選）和format屬性來格式化對應的屬性值； NumberCell使用format屬性來格式化對應的屬性值；RowCountCell顯示當前行。
提示：為了避免混亂并提高靈活性Cell接口已經被修改。而且對于區別 如何處理html和導出顯示值也不是很清晰。以前列值作為html顯示，列的propertyValue作為導出使用。 另外列值和propertyValue已經重寫，他們以前在view中是不能被訪問的。
cell現在是singleton并且不再線程安全，改變的原因是為了Cell接口能更簡單地被使用。 init()和destroy()方法作為singleton更靈活但是處于一種混亂的狀態。
Cell接口如下：
public interface Cell {
/**
* The display that will be used for the exports.
*/
public String getExportDisplay(TableModel model, Column column);
/**
* The html that will be displayed in the table.
*/
public String getHtmlDisplay(TableModel model, Column column);
}
現在得到導出和html顯示存在明顯的區別。更重要的，需要返回字符串。列值和屬性值不再 需要設置。
DisplayCell是擴展AbstractCell的最簡單的Cell。AbstractCell定義 的虛擬方法getCellValue用來返回cell的值。雖然AbstractCell在一些情況下是有用的， 但更多情況下只需要直接實現Cell接口。
DisplayCell：
public class DisplayCell extends AbstractCell {
public String getExportDisplay(TableModel model, Column column) {
return column.getPropertyValueAsString();
}
protected String getCellValue(TableModel model, Column column) {
return column.getValueAsString();
}
}
AbstractCell：
public abstract class AbstractCell implements Cell {
public String getExportDisplay(TableModel model, Column column) {
return getCellValue(model, column);
}
public String getHtmlDisplay(TableModel model, Column column) {
HtmlBuilder html = new HtmlBuilder();
CellBuilder.tdStart(html, column);
CellBuilder.tdBody(html, getCellValue(model, column));
CellBuilder.tdEnd(html);
return html.toString();
}
/**
* A convenience method to get the display value.
*/
protected abstract String getCellValue(TableModel model, Column column);
}
現在你應該知道Cell是多么簡單。只需通過實現Cell接口或擴展AbstractCell來定制你自己的Cell， 并設置列標簽的Cell屬性為類的全路徑。例如: 如果你定制了一個名為MyCell的Cell，那么你可以像下面一樣使用它：
<ec:column property="firstName" cell="com.mycompany.cell.MyCell"/>
如果你改變列的數據，那么過濾或排序可能沒有意義。切記我的意思是如果你人為地改變數據， 而不是使用樣式對它進行包裝或作為<a href>包含。 如果你的定制cell顯示數據的樹狀視圖，或者是一幅圖片， 那么過濾和排序等一切邏輯操作都是沒有意義的。
5.3.?Filter Cell
列的filterCell屬性控制過濾器如何顯示，它和cell屬性非常相像并且也是實現Cell接口。 已經定義了兩個過濾器cells：默認的和droplist。默認的是一個輸入框元素，除非你確信你需要使這列可以進行過濾， 否則你不需要做任何事。
你可以像下面一樣使用droplist過濾器Cell：
<ec:table
items="presidents"
action="${pageContext.request.contextPath}/presidents.run"
>
<ec:row>
<ec:column property="status" filterCell="droplist"/>
</ec:row>
</ec:table>
filterCell也允許你定義定制的過濾器，所有你必須做的就是實現Cell接口或者擴展AbstractCell， 并設置列標簽的Cell屬性為類的全路徑。例如，如果你定制了一個名為MyCell的Cell，那么你可以像下面一樣使用它：
<ec:column property="firstName" filterCell="com.mycompany.cell.MyFilterCell"/>
參閱Cell節了解如何創建你自己定制Cells的更多信息。
5.4.?Header Cell
headerCell屬性控制headers如何顯示，它和cell屬性非常相像并且也是實現Cell接口。 默認header cell作為文本顯示，包含排序邏輯。
headerCell也允許你定義定制的過濾器，所有你必須做的就是實現Cell接口或者擴展AbstractCell， 并設置列標簽的Cell屬性為類的全路徑。例如，如果你定制了一個名為MyCell的Cell，那么你可以像下面一樣使用它：
<ec:column property="firstName" headerCell="com.mycompany.cell.MyHeaderCell"/>
參閱Cell節了解如何創建你自己定制Cells的更多信息。
5.5.?樣式
ColumnTag關聯了很多樣式屬性：
<ec:column
width=""
style=""
styleClass=""
headerStyle=""
headerClass=""
filterStyle=""
filterClass=""
/>
所有這些都是可選的。style屬性定義列內聯的樣式；styleClass允許你定義一個列顯示的css類； headerClass屬性允許你改變header列的css類；filterClass屬性允許你改變filter列的css類。
5.6.?解析和格式化
解析和格式化屬性被用在日期和貨幣的顯示上。
和date交互的工作依賴于你的bean屬性是否是一個字符串或者是一個Date對象。 如果是一個字符串那么你就需要確定parse屬性，parse屬性是按照模板定義來解析一個字符串為 一個日期對象。如果bean中的屬性是日期型對象則不需要添加parse屬性。不論如何你都需要設置format屬性。 format屬性按你提供的模板對值進行格式化。
本示例中使用MM/dd/yyyy模板格式化日期型值。因為bean中的born屬性值為字符串，所以我們需要 使用parse屬性來將它轉換成日期型數值。
<ec:column property="born" cell="date" parse="yyyy-MM-dd" format="MM/dd/yyyy"/>
對于貨幣只需要設置format屬性：
<ec:column property="payroll" cell="currency" format="###,###,##0.00"/>
很多時候在extremeTable中，你使用同樣的模版來解析和格式化日期和貨幣值。 所以便利的方法是在你自己的extremecomponents.properties文件中定義解析和格式化屬性。 參閱Preferences章了解更多信息。
5.7.?過濾和排序
你可能記得在TableTag中看見過filterable和sortable屬性，ColumnTag中也有相同的屬性。 列的filterable和sortable屬性將覆蓋表的filterable和sortable屬性設置。當你需要除了對表中的一、兩列之外的 所有列進行過濾和排序時，十分便利。
<ec:table
items="presidents"
action="${pageContext.request.contextPath}/presidents.run"
>
<ec:row>
<ec:column property="firstName" filterable="false"/>
<ec:column property="lastName" sortable="false"/>
</ec:row>
</ec:table>
5.8.?Calc
列新增了兩個屬性：calc和calcTitle：
<ec:column property="data" calc="total" calcTitle="Total:" />
calc屬性實現具有唯一方法的Calc接口：
public interface Calc {
public Number getCalcResult(TableModel model, Column column);
}
它傳入model和column，并返回一個Number型的值。默認的實現為總計和平均值。
為了使用定制的Calc，只需要使用ColumnTag的calc屬性來指定實現Calc接口的實現類的 全路徑。
Calc為singleton并且不是線程安全的，因此不要定義任何類變量。
5.9.?允許和不允許視圖
viewsAllowed屬性制定類允許使用的視圖。視圖包括：html、pdf、xls、csv，以及任何定制的視圖。 如果你指定一個或幾個視圖，那么列僅能使用這些指定的視圖。例如：你指定viewsAllowed="pdf"，這意味著 這列只允許PDF導出，而不能進行其他格式的導出或html視圖。
<ec:table
items="presidents"
action="${pageContext.request.contextPath}/presidents.run"
>
<ec:row>
<ec:column property="firstName"/>
<ec:column property="lastName" viewsAllowed="pdf"/>
</ec:row>
</ec:table>
viewsDenied屬性制定類不允許使用的視圖。視圖包括：html、pdf、xls、csv，以及任何定制的視圖。 如果你指定一個或幾個視圖，那么列僅這些指定的視圖不能被使用。例如：你指定viewsDenied="html"，這意味著 這列不允許使用html試圖，但能進行任何形式的導出。
<ec:table
items="presidents"
action="${pageContext.request.contextPath}/presidents.run"
>
<ec:row>
<ec:column property="firstName"/>
<ec:column property="lastName" viewsDenied="html"/>
</ec:row>
</ec:table>
5.10.?其他屬性
title屬性用來為header設定一個描述性的名稱。如果你不定義title那么列將使用屬性名。 如果你不想顯示任何title，你只需要設置title屬性值為一個空白（whitespace）。
<ec:table
items="presidents"
action="${pageContext.request.contextPath}/presidents.run"
title="Presidents"
>
<ec:row>
<ec:column property="firstName"/> //title shows as First Name
<ec:column property="firstName" title="First Name"/> //title shows as First Name
<ec:column property="firstName" title=" "/> //no title shows up
</ec:row>
</ec:table>
5.11.?擴展屬性
大多數標簽包含一系列的固定屬性，這樣那些已經實現的功能能夠被使用。然而，eXtremeTable具有一種更具彈性的架構， 你可以添加自己的標簽屬性實現更多的定制工作。此外，eXtremeTable提供了非常清晰的鉤子（hooks）允許你得到那些定制的 標簽屬性來做一些你需要的工作。
通過addExtendedAttributes()方法將擴展屬性包含到eXtremeTable里：
public void addExtendedAttributes(Column column);
如果方法被覆蓋ColumnTag將調用它。你需要做的就是擴展ColumnTag，覆蓋addExtendedAttributes()方法，然后添加自己 的屬性到列對象中。一個定制的CustomTag示例如下：
public class MyCustomTag extends ColumnTag {
private String customAttributeOne;
public String getCustomAttributeOne() {
return customAttributeOne;
}
public void setCustomAttributeOne(String customAttributeOne) {
this.customAttributeOne = customAttributeOne;
}
public void addExtendedAttributes(Column column) {
column.addAttribute("customAttributeOne", customAttributeOne);
}
}
現在你添加了屬性值到Column對象，現在你可以像下例一樣來定制cell：
public class MyCustomCell implements Cell {
public String getHtmlDisplay(TableModel model, Column column) {
Object customAttributeOne = column.getAttribute("customAttributeOne")
String customAttributeOne = column.getAttributeAsString("customAttributeOne")
}
}
另外，你也可以定制自己的標簽和自己的TLD文件。你不需要修改extremecomponents.tld文件。 你能象使用eXtremeTable里的標簽一樣使用自己的標簽，除了使用你自己標簽的參照。假如你的標簽參照為mycompany 并且標簽為customColumn，你可以像下面一樣使用他們：
<ec:table
items="presidents"
action="${pageContext.request.contextPath}/public/demo/presidents.jsp"
title="Presidents"
>
<ec:row>
<mycompany:customColumn
property="hello"
cell="com.mycompany.cell.MyCustomCell"
customAttributeOne="Hello World"/>
</ec:row>
</ec:table>
Chapter?6.?ParameterTag
6.1.?引言
eXtremeTable能夠指定是否處理所有的參數。默認為處理所有的參數，這意味著當你進行 過濾、排序、分頁時，所有的參數都被eXtremeTable保存并傳到JSP中。通常這是你需要的功能， 然而，有時候你需要只允許一些特定的參數保存到eXtremeTable中。我喜歡把它看作鎖定extremeTable， 可以通過設置表的autoIncludeParameters屬性值為false來到達目的：
<ec:table
items="presidents"
action="${pageContext.request.contextPath}/presidents.run"
autoIncludeParameters=”false”
>
...
</ec:table>
甚至當表被鎖定時，你仍然可以通過簡單地使用parameter標簽來包含一些你想使用的參數。下例 包含了foo參數：
<ec:table
items="presidents"
action="${pageContext.request.contextPath}/presidents.run"
autoIncludeParameters=”false”
>
<ec:parameter name=”foo” value=”${param.foo}”/>
...
</ec:table>
現在所有的eXtremeTable參數都被鎖定。但過濾、排序和翻頁時，foo參數仍將被傳遞。
Chapter?7.?ExportTag
7.1.?引言
eXtremeTable具有導出不同格式文件的功能，導出的數據為過濾和排序后的所有結果集， 分頁不會影響返回的結果集。換句話說，如果表數據分多頁顯示，那么所有頁的數據都將被導出。 導出的格式為Microsoft Excel (OpenOffice Calc)、PDF和CSV。
使用ExportXlsTag導出Microsoft Excel (OpenOffice Calc)：
<ec:table
items="presidents"
action="${pageContext.request.contextPath}/presidents.run"
/>
<ec:exportXls
fileName="presidents.xls"
tooltip="Export Excel"/>
...
</ec:table>
使用ExportPdfTag導出PDF。所有要做的就是指定fileName屬性和一些樣式屬性：
<ec:table
items="presidents"
action="${pageContext.request.contextPath}/presidents.run"
/>
<ec:exportPdf
fileName="presidents.pdf"
tooltip="Export PDF"
headerColor="blue"
headerBackgroundColor="red"
headerTitle="Presidents"/>
...
</ec:table>
使用ExportCsvTag導出CSV。當使用CSV導出是默認的分隔符為‘,’(comma)。你可以使用 delimiter屬性來指定為其他的符號。下面為指定‘|’（pipe）為CSV分隔符的示例：
<ec:table
items="presidents"
action="${pageContext.request.contextPath}/presidents.run"
/>
<ec:exportCsv
fileName="presidents.txt"
tooltip="Export CSV"
delimiter="|"/>
...
</ec:table>
你可以通過指定view屬性來導出其他文件格式。eXtremeTable視圖實現View接口并是 可插接的。參閱View章了解更多信息。
7.2.?擴展屬性
大多數標簽包含一系列的固定屬性，這樣那些已經實現的功能能夠被使用。然而，eXtremeTable具有一種更具彈性的架構， 你可以添加自己的標簽屬性實現更多的定制工作。此外，eXtremeTable提供了非常清晰的鉤子（hooks）允許你得到那些定制的 標簽屬性來做一些你需要的工作。
通過addExtendedAttributes()方法將擴展屬性包含到eXtremeTable里：
public void addExtendedAttributes(Export export);
如果方法被覆蓋ExportTag將調用它。你需要做的就是擴展ExportTag，覆蓋addExtendedAttributes()方法，然后添加自己 的屬性到導出對象中。
一個定制的ExportCsvTag示例如下:
public class ExportCsvTag extends ExportTag {
private String delimiter;
public String getDelimiter() {
return delimiter;
}
public void setDelimiter(String delimiter) {
this.delimiter = delimiter;
}
public void addExtendedAttributes(Export export) {
String view = export.getView();
if (StringUtils.isBlank(view)) {
export.setView(TableConstants.VIEW_CSV);
export.setImageName(TableConstants.VIEW_CSV);
}
export.addAttribute(CsvView.DELIMITER, getDelimiter());
}
}
現在你添加了屬性值到Export對象，下面是CsvView實現的一部分：
public class CsvView implements View {
public void body(TableModel model, Column column) {
Export export = model.getExportHandler().getCurrentExport();
}
}
另外，你也可以定制自己的標簽和自己的TLD文件。你不需要修改extremecomponents.tld文件。 你能象使用eXtremeTable里的標簽一樣使用自己的標簽，除了使用你自己標簽的參照。假如你的標簽參照為mycompany 并且標簽為customExport，你可以像下面一樣使用他們：
<ec:table
items="presidents"
action="${pageContext.request.contextPath}/public/demo/presidents.jsp"
title="Presidents"
>
<mycompany:customExport fileName="presidents.txt" delimiter="|"/>
...
</ec:table>
Chapter?8.?Callbacks
8.1.?引言
Callbacks被用于重新得到（retrieve）、過濾和排序行數據。eXtremeTable為每個callback提供了一個定制實現。 首先，載入所有的元數據，元數據為所有eXtremeTable標簽的所有屬性；接著在eXtremeTable的model中調用 execute方法。eXtremeTable使用execute方法決定如何通過調用每個callback的接口來重新得到、過濾和排序行數據。 這三個callback的接口是：RetrieveRowsCallback、FilterRowsCallback和SortRowsCallback。
callbacks為singleton并且不是線程安全的，因此不要定義任何類變量。
8.2.?RetrieveRowsCallback
RetrieveRowsCallback的默認實現在servlet范圍內尋找具有名稱和TableTag 的items屬性設置相同的Beans集合。為了使用定制的callback，只要實現RetrieveRowsCallback接口， 然后使用retrieveRowsCallback屬性來指定實現類的全路徑：
<ec:table
var="pres"
action="${pageContext.request.contextPath}/presidents.run"
retrieveRowsCallback="com.mycompany.callback.MyCustomCallback"
/>
RetrieveRowsCallback接口如下所示：
public interface RetrieveRowsCallback {
public Collection retrieveRows(TableModel model) throws Exception;
}
只有一個方法需要實現，傳入TableModel并返回一個集合，集合為Beans或Maps集合。 通過得到TableModel，就擁有了TableTag的所有元數據并能訪問Context。能夠訪問Context非常重要， 這意味著你訪問web容器的任何東西。
8.3.?FilterRowsCallback
FilterRowsCallback的默認實現得到Beans集合，通過實現jakarta Predicate接口進行過濾， 過濾值從eXtremeTable的filter輸入框中取得。為了使用定制的callback，只要實現FilterRowsCallback接口， 然后使用filterRowsCallback屬性來指定實現類的全路徑：
<ec:table
var="pres"
action="${pageContext.request.contextPath}/presidents.run"
filterRowsCallback="com.mycompany.callback.MyCustomCallback"
/>
FilterRowsCallback接口如下所示：
public interface FilterRowsCallback {
public Collection filterRows(TableModel model, Collection rows) throws Exception;
}
只有一個方法需要實現，傳入TableModel并返回一個集合。你只需像eXtremeTable對 每個callback的默認實現一樣來定制自己的callback。
8.4.?SortRowsCallback
SortRowsCallback的默認實現得到Beans集合，使用jakarta BeanComparator進行排序， 排序值當用戶點擊列頭時取得。為了使用定制的callback，只要實現SortRowsCallback接口， 然后使用sortRowsCallback屬性來指定實現類的全路徑：
<ec:table
var="pres"
action="${pageContext.request.contextPath}/presidents.run"
sortRowsCallback="com.mycompany.callback.MyCustomCallback"
/>
SortRowsCallback接口如下所示：
public interface SortRowsCallback {
public Collection sortRows(TableModel model, Collection rows) throws Exception;
}
只有一個方法需要實現，傳入TableModel并返回一個集合。你只需像eXtremeTable對 每個callback的默認實現一樣來定制自己的callback。
Chapter?9.?視圖
9.1.?引言
eXtremeTable里視圖是可插接的，這意味著html很容易改變，或者一類新的導出能夠被實現。 所有需要做的就是實現View接口并在TableTag或ExportTag中設置view屬性。首先，讓我們看一下View接口：
public interface View {
public void beforeBody(TableModel model);
public void body(TableModel model, Column column);
public Object afterBody(TableModel model);
}
實現View接口的類有三次插入內容的機會。beforeBody()方法會被立刻調用； body()方法在每一行的每一列處理的時候調用；afterBody()方法是被eXtremeTable調用的 最后方法，它將返回代表視圖的一個對象，通常它是一個字符串。例如：在HTML視圖類中為的html 標簽（markup），當然它可以是任何東西。最主要的原因是定制導出時,你應該返回一些其他的對象。
9.2.?表視圖
eXtremeTable的所有標簽（markup）在兩個地方生成：View或Cell。 組合使用他們， 能為你提供一種可插接的表示內容的解決方案。為了使用定制的View， 只需要使用TableTag的view屬性來指定實現View接口的實現類的 全路徑：
<ec:table
items="presidents"
action="${pageContext.request.contextPath}/presidents.run"
view="com.mycompany.view.MyCustomView"
>
...
</ec:table>
9.3.?導出視圖
與表視圖不同，export的所有標簽都在View中生成。為了使用定制的View， 只需要使用ExportTag的view屬性來指定實現View接口的實現類的 全路徑：
<ec:table
items="presidents"
action="${pageContext.request.contextPath}/presidents.run"
>
<ec:export
fileName="custom.file"
tooltip="Export Custom"
view="com.mycompany.view.MyCustomExportView"/>
...
</ec:table>
Chapter?10.?Preferences
10.1.?引言
為了替代硬編碼eXtremeTable使用的默認屬性值，我在屬性文件中配置所有用到的屬性。 如果你需要覆蓋任何默認的設置，你可以創建自己的extremecomponents.properties文件 并設置你想改變的值。
為了設置屬性文件，你應該如下例所示在/WEB-INF/web.xml文件中聲明一個context-param，并 指定你的屬性文件的路徑：
<context-param>
<param-name>extremecomponentsPreferencesLocation</param-name>
<param-value>/org/extremesite/resource/extremecomponents.properties</param-value>
</context-param>
你可以認為屬性文件為你提供了一個對所有的eXtremeTables聲明全局設置的一個方法。 創建屬性文件的最大好處就是避免在標簽中復制、粘貼相同的屬性。典型的extremecomponents.properties文件如下所示：
table.imagePath=/extremesite/images/*.gif
table.rowsDisplayed=12
column.parse.date=yyyy-MM-dd
column.format.date=MM/dd/yyyy
column.format.currency=$###,###,##0.00
10.2.?TableTag
在屬性文件定義的TableTag使用最多的兩個屬性是：imagePath和rowsDisplayed。如果你不在屬性文件中聲明 這些屬性，你需要在每個eXtremeTable中添加他們。典型的表如下所示：
<ec:table
items="presidents"
action="${pageContext.request.contextPath}/presidents.run"
imagePath="${pageContext.request.contextPath}/images/*.gif"
rowsDisplayed="12"
title="Presidents"
>
...
</ec:table>
如果在屬性文件聲明imagePath和rowsDisplayed，則表如下所示：
<ec:table
items="presidents"
action="${pageContext.request.contextPath}/presidents.run"
title="Presidents"
>
...
</ec:table>
正如你所見，屬性文件避免了重復編碼。
10.3.?ColumnTag
在屬性文件定義的ColumnTag使用最多的兩個屬性是：parse和format。如果你不在屬性文件中聲明 這些屬性，你需要在每個eXtremeTable中添加他們。典型的列使用日期cell如下所示：
<ec:column property="dateOfBirth" cell=”date” parse=”yyyy-MM-dd” format=”MM/dd/yyyy”/>
如果在屬性文件聲明parse和format，則列如下所示：
<ec:column property="dateOfBirth" cell=”date”/>
當然你仍然可以定義parse和format屬性來覆蓋全局設置，但是大多數工程對于日期使用一致的parse 和format。需要注意屬性文件中parse.date和format.date的聲明語法。
下例為使用貨幣cell的典型列：
<ec:column property="salary" cell=”currency” format=”$###,###,##0.00”/>
如果在屬性文件聲明format，則列如下所示：
<ec:column property="salary" cell=”currency”/>
另外，你可以聲明一個定制的format并在列中通過使用列的basis來使用它，我把這想象為named屬性。因此如果你的 extremecomponents.properties文件如下所示：
table.format.myCustomDate=yy-MM-dd
那么列可以如下使用定制的format：
<ec:column property="dateOfBirth" cell="date" format=”myCustomDate”>
10.4.?Advanced Techniques
使用named屬性是我定義其他不同屬性默認值時經常使用的方法。你可能對我 使用cell="date"來指定日期cell、使用cell="currency"來指定貨幣cell或使用view="xls."來指定xls導出感到疑惑。 如果我給你展示extremetable.properties文件的一些片斷，這些就將非常清晰了。 extremetable.properties是eXtremeTable聲明默認設置的屬性文件，你可以通過使用 extremecomponents.properties文件來覆蓋它。
column.cell.date=org.extremecomponents.table.cell.DateCell
column.cell.currency=org.extremecomponents.table.cell.NumberCell
column.filterCell.droplist=org.extremecomponents.table.cell.FilterDroplistCell
table.view.xls=org.extremecomponents.table.view.XlsView
當你在列上定義cell="date"時，eXtremeTable尋找到column.cell. 屬性并將你定義的cell屬性值拼接上。 換句話說cell="date"關聯到column.cell.date=org.extremecomponents.table.cell.DateCell這條屬性。使用屬性文件 真正強大的地方在于你能夠在extremecomponents.properties文件中聲明一個定制的cell，并在ColumnTag中通過 名稱來使用它。
再使用一個實例來闡明這一點，是否記得ColumnTag章Cell節中如何調用一個名為MyCell的定制cell：
<ec:column property="firstName" cell="com.mycompany.cell.MyCell"/>
cell使用的更好方式是在屬性文件中聲明并通過名稱使用它。首先，更新extremecomponents.properties文件：
table.imagePath=/extremesite/images/*.gif
table.rowsDisplayed=12
table.cellspacing=2
column.parse.date=yyyy-MM-dd
column.format.date=MM/dd/yyyy
column.format.currency=$###,###,##0.00
column.cell.myCell=com.mycompany.cell.MyCell
現在可以通過名稱調用MyCell：
<ec:column property="firstName" cell="myCell"/>
正如你所見的這能幫助保持代碼清潔，并且這些都在一個地方定義。如果你的定制cell聲明 需要改變你只需要修改屬性文件。
Chapter?11.?Messages
11.1.?資源綁定
為了設置資源綁定，你應該如下例所示在/WEB-INF/web.xml文件中聲明一個context-param，并 指定你的資源文件的路徑：
<context-param>
<param-name>extremecomponentsMessagesLocation</param-name>
<param-value>org/extremesite/resource/extremecomponentsResourceBundle</param-value>
</context-param>
本示例中資源文件為extremecomponentsResourceBundle，它可以為任何名或者使用已經存在的資源文件。
如果你不指定locale，則它將根據你的servlet request來決定使用哪個資源文件。 在eXtremeTable中可以通過使用TableTag的locale屬性來設置它。
<ec:table
items="presidents"
action="${pageContext.request.contextPath}/public/demo/locale.jsp"
title="table.title.president"
locale="de_DE"
>
...
</ec:table>
在這里eXtremeTable將尋找德文資源文件。
11.2.?全局資源
eXtremeTable使用一些全局的keys來與用戶交互，包括：狀態欄的文本信息，Rows Displayed droplist和不同的tooltips。如果你足夠幸運，eXtremeTable已經提供了相應的語言支持 的話，那么你什么也不用擔心。否則的話，你需要申明下列keys：
statusbar.resultsFound={0} results found, displaying {1} to {2}
statusbar.noResultsFound=There were no results found.
toolbar.firstPageTooltip=First Page
toolbar.lastPageTooltip=Last Page
toolbar.prevPageTooltip=Previous Page
toolbar.nextPageTooltip=Next Page
toolbar.filterTooltip=Filter
toolbar.clearTooltip=Clear
toolbar.clearText=Clear
toolbar.firstPageText=First
toolbar.lastPageText=Last
toolbar.nextPageText=Next
toolbar.prevPageText=Prev
toolbar.filterText=Filter
column.headercell.sortTooltip=Sort By
column.calc.total=Total
column.calc.average=Average
現在僅支持英語和德語。如果你使用其他語言的話，并能提供相應的翻譯的話我將不勝感激。你可以通過 extremecomponents@gmail.com發送給我。
譯者注:我已經提供了中文和日文的資源文件。
11.3.?TableTag
TableTag屬性中能夠使用locale方式指定的是：imagePath和title。
在eXtremeTable中，imagePath屬性有一個特定的key：table.imagePath。你可以在你的資源文件中 設置這個key為特定語言的目錄結構。例如：德文圖片可能放在de文件夾下，那么你可以在相應的資源文件中 進行如下設置：
table.imagePath=/extremesite/images/table/de/*.gif
title有一點不同，如果你指定的title屬性值包含dot (.)并且你定義了一個資源文件，那么 eXtremeTable將尋找匹配的key。例如，如果你像下例一樣在表中指定屬性title="table.title.president"：
<ec:table
items="presidents"
action="${pageContext.request.contextPath}/public/demo/locale.jsp"
title="table.title.president"
>
...
</ec:table>
那么eXtremeTable將在屬性文件中尋找匹配的key：
table.title.president=US Pr?sidenten
11.4.?ColumnTag
ColumnTag屬性中能夠使用locale方式指定的是：format和title。
在eXtremeTable中，format屬性有一個特定的key：table.fomat.type。參考屬性文件的討論 來了解更多的細節，他們具有同樣的概念。日期和貨幣的format類型定義可能如下所示：
column.format.date=MM/dd/yyyy
column.format.currency=$###,###,##0.00
title有一點不同，如果你指定的title屬性值包含dot (.)并且你定義了一個資源文件，那么 eXtremeTable將尋找匹配的key。例如，如果你像下例一樣在列中指定屬性title="table.column.nickName"：
<ec:table
items="presidents"
action="${pageContext.request.contextPath}/public/demo/locale.jsp"
title="table.title.president"
>
<ec:row>
<ec:column property="nickName" title="table.column.nickName" />
</ec:row>
</ec:table>
那么eXtremeTable將在屬性文件中尋找匹配的key：
table.column.nickName=Spitzname
Chapter?12.?Limit
12.1.?Limit指南
默認的情況下eXtremeTable取得所有的結果集然后處理Beans集合，這樣的好處是 你可以隨意進行排序、過濾和分頁操作。你只需要組裝Beans集合并讓eXtremeTable知道如何 引用它。這樣的操作對于小到中等數據量的結果集非常有效，當結果集很大時這將非常糟糕。 這是一個判斷，但我更喜歡描述如何做出我的技術決定。如果您認為在性能上有問題， 那么最好是使用一個profiler工具記錄并查看它。有許多開源和商業的profiler工具可以幫助 你做出最好的判斷。因此，假設我們發現了性能上存在問題，需要我們自己來處理分頁。
手動處理分頁意味著你一次只想取得一頁顯示需要的結果集。同時，你需要自己處理排序、過濾和分頁。 下面的討論是基于我假設你從數據庫中取得集合，當然同樣的原理能應用到任何地方。
這是一個重要的部分。為了得到較小的結果集，你可以創建一個普通的查詢語句，但是limit你得到的結果集。 在Sybase和SQLServer中你可以使用rowcount命令，在MySql中你可以使用limit命令。 我不知道其他數據庫怎么使用，但我確信每個數據庫都有相似的功能。 也就是說當用戶瀏覽第一頁是得到第一頁需要的 結果集，當用戶瀏覽下一頁時，再得到下一頁需要的結果集。
使用Sybase的開發人員可能會說:rowcount命令總是從第一條開始，那么當我到第二頁時我也必須 從第一條數據開始。 是的，你現在得到的是兩頁的結果集，而不需要得到所有的結果集。當你到第三頁時，你只需要得到三頁的結果集。。。。。。 其他數據庫比如MySQL，允許你精確地得到你想要的那段數據，這樣你就可以只得到當前頁面顯示需要的結果集。
為了知道用戶想如何排序和過濾，他們想瀏覽哪一頁，一頁需要顯示幾條結果，eXtremeTable有一個使用LimitFactory 創建的名為Limit的簡便接口：
12.2.?創建Limit
首先你需要通過LimitFactory得到一個Limit實例：
Context context = new HttpServletRequestContext(request);
LimitFactory limitFactory = new TableLimitFactory(context, tableId);
Limit limit = new TableLimit(limitFactory);
Limit對象定義了limit結果集的所有方法。
TableLimitFactory具有另外一個構造函數，如果沒有指定tableId的話默認的tableId將為ec。
Context context = new HttpServletRequestContext(request);
LimitFactory limitFactory = new TableLimitFactory(context);
Limit limit = new TableLimit(limitFactory);
12.3.?Filter和Sort屬性
當你對Limit實例化時，實例化對象包含兩個對象：FilterSet和Sort。
private FilterSet filterSet;
private Sort sort;
FilterSet包含一個過濾動作（Action）和一個過濾器對象數組。 動作為TableConstants.FILTER_ACTION或TableConstants.CLEAR_ACTION。 一個過濾器包含一個property和這個過濾器的值。
private final String action;
private final Filter[] filters;
Sort對象包含property和sortOrder。sortOrder為 TableConstants.SORT_ASC或TableConstants.SORT_DESC：
private Sort sort;
12.4.?設置頁和行屬性
設置行屬性：
limit.setRowAttributes(totalRows, DEFAULT_ROWS_DISPLAYED);
下面是設置行屬性可能用到的信息：
private int rowStart;
private int rowEnd;
private int currentRowsDisplayed;
private int page;
private int totalRows;
每個變量都有一個getter方法,我將不深入講解屬性的細節。
12.5.?Setup
在你完成所有的定制工作：排序、過濾.....定制的Controller（Spring）或者Action（Struts）或者其他類似的框架后， 另外你需要創建一個callback，eXtremeTable已經提供了一個名為LimitCallback的實現。為了使用你只需要設置表 屬性：retrieveRowsCallback、filterRowsCallback和sortRowsCallback：
<ec:table
items="presidents"
retrieveRowsCallback="limit"
filterRowsCallback="limit"
sortRowsCallback="limit"
action="${pageContext.request.contextPath}/limit.run"
title="Presidents"
>
<ec:row>
<ec:column property="fullName" title="Name"/>
<ec:column property="nickName" />
<ec:column property="term" />
<ec:column property="born" cell="date"/>
<ec:column property="died" cell="date"/>
<ec:column property="career" />
</ec:row>
</ec:table>
使用callback需要做的唯一事情是傳輸集合到request，同時傳輸totalRows屬性。 totalRows表示總行數，使用PaginationCallback.TOTAL_ROWS靜態變量將易于維護。 如果JSP頁面使用了兩個（以上）eXtremeTable的話你可以利用tableId分別傳輸totalRows。 例如如果tableId名為pres，你可以如下處理：
request.setAttribute("pres", presidents);
request.setAttribute("pres_totalRows", new Integer(""+totalRows));
譯者注:關于limit使用的更詳細信息，請參考《Limit指南》。
Chapter?13.?AutoGenerateColumns
13.1.?引言
大多數情況下你按照你需要的列來設計數據庫表。但是，有時候需要運行時動態生成一些列。 為了實現這點，eXtremeTable需要使用ColumnsTag并設置autoGenerateColumns屬性。
AutoGenerateColumns為singleton并且不是線程安全的，因此不要定義任何類變量。
13.2.?ColumnsTag
ColumnsTag只有autoGenerateColumns這一個屬性。所有你必須做的就是實現AutoGenerateColumns接口， 并設置autoGenerateColumns屬性為類的全路徑。
<ec:table
items="presidents"
action="${pageContext.request.contextPath}/autoGenerateColumns.run"
title="Presidents"
>
<ec:columns autoGenerateColumns="org.extremesite.controller.AutoGenerateColumnsImpl"/>
</ec:table>
AutoGenerateColumns接口只有一個方法：
public void addColumns(TableModel model);
你需要做的就是添加列（columns）到model里。最簡單的示例如下：
public class AutoGenerateColumnsImpl implements AutoGenerateColumns {
public void addColumns(TableModel model) {
Iterator iterator = columnsToAdd().iterator();
while (iterator.hasNext()) {
Map columnToAdd = (Map) iterator.next();
Column column = new Column(model);
column.setProperty((String) columnToAdd.get(PROPERTY));
column.setCell((String) columnToAdd.get(CELL));
model.getColumnHandler().addAutoGenerateColumn(column);
}
}
}
示例中columnsToAdd()方法簡單返回一個包含生成列（columns）需要的所有信息的集合。 作為參考，下面是我在eXtremeComponents網站實例中使用的columnsToAdd()方法：
private List columnsToAdd() {
List columns = new ArrayList();
columns.add(columnToAdd("fullName", "display"));
columns.add(columnToAdd("nickName", "display"));
columns.add(columnToAdd("term", "display"));
columns.add(columnToAdd("born", "date"));
columns.add(columnToAdd("died", "date"));
columns.add(columnToAdd("career", "display"));
return columns;
}
private Map columnToAdd(String property, String cell) {
Map column = new HashMap();
column.put(Column.PROPERTY, property);
column.put(Column.CELL, cell);
return column;
}
另外，我想聲明的是只創建列一次。eXtremeTable為了高效，不會每行創建一列， 而是通過循環持續插入新列值到已經存在的列。記住TableModel能夠訪問Context，因此 你可以在Controller（Spring）或Action（Struts）中定義樣式（look like）并通過request傳輸集合。 所以你得AutoGenerateColumns實現只需要構建列（Columns）并添加到model.columns里。
Chapter?14.?Utilities
14.1.?引言
eXtremeTable包含許多Utility類。在這里我只簡單地討論一些，你可以通過javadocs 得到更多的信息。
14.2.?HtmlBuilder
封裝了所有html語法的類。這個簡單類的使你能夠寫出更干凈的html代碼，而不用擔心null或空字符串。 一個span標簽的示例代碼如下：
HtmlBuilder html = new HtmlBuilder();
html.span().styleClass(FORM_BUTTONS).close();
html.append(formButtons);
html.spanEnd();
return html.toString();
Chapter?15.?1.0.1-M4升級說明
15.1.?變更概述
下面的特性已經被更改：
-
HtmlView基于原來代碼的實現已經deprecated
-
Cell接口更簡單
-
增加RowTag
-
AutoGenerateColumns變為singleton，更易添加列屬性
-
Extended Attributes方法名變更
-
TableTag的collection屬性被刪除
-
BaseModel更名為TableModel
-
Properties和ResourceBundle現在為Preferences和Messages
-
pageContext被Context接口代替
-
Limit和LimitFactory的語法變更，更易于使用
-
TableTag的saveFilterSort屬性被state屬性代替
-
ColumnTag的showTotal屬性被calc屬性代替
-
search圖片的名稱變為filter
-
FormTag/InputTag為deprecated
-
RetrieveRowsCallbacks、FilterRowsCallback、SortRowsCallback都變為singletons
15.1.1.?HtmlView
我把和舊的view相關的代碼：原始的view、cell和相關代碼放到deprecated文件夾。 原因是新的view代碼非常成功，所以沒有必要使用舊的代碼。使用新代碼構建定制view請參考 view包中的HtmlView或CompactView。
15.1.2.?Cell
Cell接口已經改變，原因是想結束混亂以提高靈活性。以前對于如何處理區分html和export顯示值 不是十分明顯。現在Column值設置html，Column的propertyValue設置export。另外因為Column值和 propertyValue值被重寫。現在他們在view中是不可見的。
cell現在是singleton并且不再線程安全，因此不要定義任何類變量。改變的原因是為 了Cell接口能更簡單地被使用。init()和destroy()方法作為singleton更靈活但是處于一種混亂的狀態。
Cell接口如下：
public interface Cell {
/**
* The display that will be used for the exports.
*/
public String getExportDisplay(TableModel model, Column column);
/**
* The html that will be displayed in the table.
*/
public String getHtmlDisplay(TableModel model, Column column);
}
現在得到導出和html顯示存在明顯的區別。更重要的，需要返回字符串。列值和屬性值不再 需要設置。另一個細微的區別是：BaseModel已經被TableModel取代。這種改變是的不再需要一個 基礎包（base package），這意味著不再需要BaseModel。
cell變為singleton不會導致使用復雜，如果你定義了任何類變量只需要把他們放到正確的 方法那么他們就能被任何其他方法使用。
BaseCell被刪除因為不再需要添加任何值。替代的是AbstractCell，虛擬方法 getCellValue被用來返回cell的值。這種方法非常容易使用并不需要關心markup。查看 AbstractCell也是有意義的，你會發現這代碼實現的多么簡單。然而，很多時候需要做的僅僅是 實現Cell接口：
DisplayCell：
public class DisplayCell extends AbstractCell {
public String getExportDisplay(TableModel model, Column column) {
return column.getPropertyValueAsString();
}
protected String getCellValue(TableModel model, Column column) {
return column.getValueAsString();
}
}
AbstractCell：
public abstract class AbstractCell implements Cell {
public String getExportDisplay(TableModel model, Column column) {
return getCellValue(model, column);
}
public String getHtmlDisplay(TableModel model, Column column) {
HtmlBuilder html = new HtmlBuilder();
CellBuilder.tdStart(html, column);
CellBuilder.tdBody(html, getCellValue(model, column));
CellBuilder.tdEnd(html);
return html.toString();
}
/**
* A convenience method to get the display value.
*/
protected abstract String getCellValue(TableModel model, Column column);
}
15.1.3.?RowTag
RowTag<ec:row> 現在被需要，它被用來替代columns。 現在看來它一直被需要。它不知道表中到底有多少列，最近重構的時候我通過 Table -> Row -> Column使結構固定來合并得到更好的靈活性。將來我可能提供更多的 特性，因為我知道eXtremeTable有著清晰的架構。
典型的eXtremeTable如下：
<ec:table
items="presidents"
var="pres"
action="${pageContext.request.contextPath}/presidents.run"
>
<ec:row>
<ec:column property="name"/>
<ec:column property="term"/>
</ec:row>
</ec:table>
15.1.4.?AutoGenerateColumns
AutoGenerateColumns得到了很大的提高，現在你只需要設置你需要的屬性。 當你添加列到ColumnHandler使，defaults將別自動調用。
AutoGenerateColumns為singleton并且不是線程安全的，因此不要定義任何類變量。
現在它的實現可能如下：
public class AutoGenerateColumnsImpl implements AutoGenerateColumns {
public void addColumns(TableModel model) {
Iterator iterator = columnsToAdd().iterator();
while (iterator.hasNext()) {
Map columnToAdd = (Map) iterator.next();
Column column = new Column(model);
column.setProperty((String) columnToAdd.get(PROPERTY));
column.setCell((String) columnToAdd.get(CELL));
model.getColumnHandler().addAutoGenerateColumn(column);
}
}
}
15.1.5.?Extended Attributes
addExtendedAttributes方法重命名使得如何使用這個特性更清晰。 因此RowTag的addExtendedAttributes現在變為addRowAttributes，ColumnTag變 為addColumnAttributes，TableTag變為addTableAttributes，ExportTag變 為addExportAttributes。另外你參考正確的model bean（它的實現更清晰）， 將知道如何添加屬性到你的cell、view.....
使用ExportCsvTag的示例如下：
public void addExportAttributes(Export export) {
String view = export.getView();
if (StringUtils.isBlank(view)) {
export.setView(TableConstants.CSV);
export.setImageName(TableConstants.CSV);
}
export.addAttribute(CsvView.DELIMITER, getDelimiter());
}
為了得到delimiter屬性值你只需要從Export bean中get它：
Export export = model.getExportHandler().getCurrentExport();
String delimiter = export.getAttributeAsString(DELIMITER);
現在你需要在ExportTag中覆蓋它，你只需要調用setter方法。如果是新的屬性，那么使用 可以和前一版一樣使用addAttribute()方法。為了得到值，首先從ExportHandler得到Export， 然后調用需要的getter方法。這和使用其它tags一樣。
在RowTag和ColumnTag中增加了兩個新的callback方法：modifyRowAttributes和 modifyColumnAttributes，因此你可以在rows/columns被處理時改變屬性值。
15.1.6.?TableTag的collection屬性
TableTag的collection屬性被刪除，現在變為三個新屬性：tableId、items和var。 因為我按照標準的JSTL命名，你應該能夠根據這些名稱知道他們的作用。tableId屬性 被用來作為表的唯一標識，items屬性用來表示從各種servlet的scopes里取得的集合， var屬性表示你將使用EL編寫腳本的名稱。
依賴你的需要來決定如何使用新的屬性，tableId用來唯一標識表。如果你的頁面上只使用了 一個eXtremeTable并且不使用Limit特性，那么你根本不需要定義它。默認的表示名為'ec'；如果使用 Limit特性你也可以使用'ec'這個名稱。然而，如果的一個JSP頁面上同時使用兩個eXtremeTables你就 需要使用tableId來唯一標識他們。var屬性被用來你將使用EL編寫腳本的名稱。items屬性用來表示從 各種servlet的scopes里取得的集合，而且現在非常健壯。你現在能nest集合到另外的對象，或者nest你想的 深度。
取得集合的語法如下：
<ec:table items="command.myObject.myCol" />
本示例將從命令對象（command object）取得myCol集合。
<ec:table items="myCol" />
本示例中將根據名稱自動取得集合，就像以前版本的collection屬性一樣。
15.1.7.?BaseModel
BaseModel被重命名為TableModel，這是因為已經不需要一個基礎包（base package）了，這也 意味著不再需要BaseModel了。
15.1.8.?Properties和ResourceBundle
web.xml文件中使用extremecomponentsPreferencesLocation屬性取代extremecomponentsPropertiesLocation屬性， properties現在被Preferences接口控制。在以后的版本，我將提供可選的xml文件配置。
eXtremeTable不再默認在頂層類路徑（top level classpath）尋找 extremecomponents.properties文件。你應該在web.xml中使用設置context-param屬性的 值為extremecomponentsPreferencesLocation，這將更為通用。
web.xml文件中使用extremecomponentsMessagesLocation屬性取代extremecomponentsResourceBundleLocation屬性， internationalization現在被Messages接口控制。
Properties和ResourceBundle屬性根據table、row、column、export和filterare區分開。 在以前版本中每個屬性都以'table'開頭，現在每個屬性關聯到被使用的標簽。另外poperty不再需要使用奇怪的下劃線語法， 而是使用dot來強調。
下面為properties文件的示例：
table.imagePath=/extremesite/images/*.gif
table.rowsDisplayed=12
column.parse.date=yyyy-MM-dd
column.format.date=MM/dd/yyyy
column.format.currency=$###,###,##0.00
[英文的屬性文件示例如下：]
statusbar.resultsFound={0} results found, displaying {1} to {2}
statusbar.noResultsFound=There were no results found.
toolbar.firstPageTooltip=First Page
toolbar.lastPageTooltip=Last Page
toolbar.prevPageTooltip=Previous Page
toolbar.nextPageTooltip=Next Page
toolbar.filterTooltip=Filter
toolbar.clearTooltip=Clear
toolbar.clearText=Clear
toolbar.firstPageText=First
toolbar.lastPageText=Last
toolbar.nextPageText=Next
toolbar.prevPageText=Prev
toolbar.filterText=Filter
column.headercell.sortTooltip=Sort By
column.calc.total=Total
column.calc.average=Average
15.1.9.?pageContext
TableModel （以前的BaseModel）不再直接訪問pageContext，取而代之的是使用Context接口， 默認的被pageContext支持。直接訪問pageContext是一個不好的實現，Context提供你需要從不同servlet scopes中 取得需要屬性值的所有方法。然而，如果你需要直接訪問背后的對象，可以使用getContextObject()方法。
15.1.10.?Limit和LimitFactory
Limit和LimitFactory現在都是接口，以前版本的實現不如我想象的簡單。然而， Limit對象的方法命名和以前版本的一樣，因此你以前的代碼也能很好的工作。
我兩個Limit實現重構為一個，但是仍有兩個LimitFactory實現， 從coding的觀點用戶只要使用一個 實現，但是它必須兼容以前的版本。現在只有一個Limit實現我重命名為TableLimit。同時，因為Limit特性 依賴Context而不是request，我重命名工廠類（TableLimitFactory）來reflect它。
Limit在導出時正確地顯示行信息，Limit具有一個isExported()方法。
使用Limit和LimitFactory的示例如下：
Context context = new HttpServletRequestContext(request);
LimitFactory limitFactory = new TableLimitFactory(context, tableId);
Limit limit = new TableLimit(limitFactory);
設置row屬性，僅設置totalRows和默認的行顯示：
limit.setRowAttributes(totalRows, DEFAULT_ROWS_DISPLAYED);
RequestLimitFactory具有另一個如果沒有指定tableId將設置為ec的構造函數：
Context context = new HttpServletRequestContext(request);
LimitFactory limitFactory = new TableLimitFactory(context);
15.1.11.?TableTag的saveFilterSort屬性
saveFilterSort屬性被state屬性取代，state屬性參照State接口并能插接不通的關于 如何保存表狀態的實現。
State接口如下：
public interface State {
public void saveParameters(TableModel model, Map parameters);
public Map getParameters(TableModel model);
}
表新增了兩個屬性：state和stateAttr。state屬性使用預設的四種 狀態（default、notifyToDefault、persist和notifyToPersist）之一， 你也可以插接自己的實現。default狀態不維持任何狀態；persist狀態沒有任何參數傳入，將一直維持表的狀態； notifyToDefault狀態將一直維持表的狀態直到你傳入參數告訴它回到default狀態；notifyToPersist狀態 將一直維持當前狀態直到你傳入參數告訴它維持persisted狀態。stateAttr為指定參數提供了一條途徑，你 也可以使用屬性文件在全局范圍內指定它。為了向后兼容，默認參數一直為useSessionFilterSort。
如果你想state按照不同方式工作你只要實現State接口，然后使用TableTag的state屬性來指定實現類的 全路徑。
15.1.12.?ColumnTag的showTotal屬性
列新增了兩個屬性：calc和calcTitle：
<ec:column property="data" calc="total" calcTitle="Total:" />
calc屬性實現具有唯一方法的Calc接口：
public interface Calc {
public Number getCalcResult(TableModel model, Column column);
}
它傳入model和column，并返回一個Number型的值。默認的實現為總計和平均值。
為了使用定制的Calc，只需要使用ColumnTag的calc屬性來指定實現Calc接口的實現類的 全路徑。
Calc為singleton并且不是線程安全的，因此不要定義任何類變量。
showTotal因為不再適用在新版中被刪除，我也刪除了表中的totalTitle。
15.1.13.?Image名
search圖片名從search變為filter。
15.1.14.?FormTag / InputTag Deprecated
FormTag和InputTag現在為deprecated。他們在新的html視圖（view）中不再被使用。
15.1.15.?RetrieveRowsCallbacks、FilterRowsCallback、SortRowsCallback
Callbacks為singleton并且不是線程安全的，因此不要定義任何類變量。
Chapter?16.?Tag Attributes
16.1.?TableTag
Table?16.1.?
| action | The URI that will be called when the filter, sort and pagination is used. |
| autoIncludeParameters | Specify whether or not to automatically include the parameters, as hidden inputs, passed into the JSP. |
| border | The table border attribute. The default is 0. |
| cellpadding | The table cellpadding attribute. The default is 0. |
| cellspacing | The table cellspacing attribute. The default is 0. |
| filterable | Specify whether or not the table is filterable. Boolean value with the default being true. |
| filterRowsCallback | A fully qualified class name to a custom FilterRowsCallback implementation. Could also be a named type in the preferences. Used to filter the Collection of Beans or Collection of Maps. |
| form | The reference to a surrounding form element. |
| imagePath | The path to find the images. For example imagePath=/extremesite/images/*.png is saying look in the image directory for the .png images. |
| intercept | A fully qualified class name to a custom InterceptTable implementation. Could also be a named type in the preferences. Used to add table attributes. |
| items | Reference the collection that will be retrieved. |
| locale | The locale for this table. For example fr_FR is used for the French translation. |
| method | Used to invoke the table action using a POST or GET. |
| onsubmit | The javascript onsubmit action for the table. |
| retrieveRowsCallback | A fully qualified class name to a custom RetrieveRowsCallback implementation. Could also be a named type in the preferences. Used to retrieve the Collection of Beans or Collection of Maps. |
| rowsDisplayed | The number of rows to display in the table. |
| scope | The scope (page, request, session, or application) to find the Collection of beans or Collection of Maps defined by the collection attribute. |
| showPagination | Specify whether or not the table should use pagination. Boolean value with the default being true. |
| showExports | Specify whether or not the table should use the exports. Boolean value with the default being true. |
| showStatusBar | Specify whether or not the table should use the status bar. Boolean value with the default being true. |
| showTooltips | Specify whether or not to show the tooltips. Boolean value with the default being true. |
| sortRowsCallback | A fully qualified class name to a custom SortRowsCallback implementation. Could also be a named type in the preferences. Used to sort the Collection of Beans or Collection of Maps. |
| sortable | Specify whether or not the table is sortable. Boolean value with the default being true. |
| state | The table state to use when returning to a table. Acceptable values are default, notifyToDefault, persist, notifyToPersist. |
| stateAttr | The table attribute used to invoke the state change of the table. |
| style | The css inline style sheet. |
| styleClass | The css class style sheet. |
| tableId | The unique identifier for the table. |
| theme | The theme to style the table. The default is eXtremeTable. |
| title | The title of the table. The title will display above the table. |
| var | The name of the variable to hold the current row bean. |
| view | Generates the output. The default is the HtmlView to generate the HTML. Also used by the exports to generate XLS-FO, POI, and CSV. |
| width | Width of the table. |
16.2.?RowTag
Table?16.2.?
| highlightClass | The css class style sheet when highlighting rows. |
| highlightRow | Used to turn the highlight feature on and off. Acceptable values are true or false. The default is false. |
| intercept | A fully qualified class name to a custom InterceptRow implementation. Could also be a named type in the preferences. Used to add or modify row attributes. |
| onclick | The javascript onclick action |
| onmouseout | The javascript onmouseout action |
| onmouseover | The javascript onmouseover action |
| style | The css inline style sheet. |
| styleClass | The css class style sheet. |
16.3.?ColumnTag
Table?16.3.?
| alias | Used to uniquely identify the column when the same property is used for more than one column. |
| calc | A fully qualified class name to a custom Calc implementation. Could also be a named type in the preferences. Used to do math on a column. |
| calcTitle | The title of the calc. |
| cell | Display for the column. The valid values are display, currency, rowCount, and date. The default value is display. The cell can also be a fully qualified class name to a custom Cell. Be sure to implement the Cell interface or extend AbstractCell if making a custom cell. |
| escapeAutoFormat | Specify whether auto format of value will be skipped. False by default, and is only effective if autoformatting is implement in the view. |
| filterable | Specify whether or not the column should be filterable. Acceptable values are true or false. The default is to use the value for the table filterable attribute. |
| filterCell | Displays the filter column. The valid values are filter and droplist. The default is filter. The cell can also be a fully qualified class name to a custom cell. |
| filterClass | The css class style sheet used to define what the table filter column looks like. |
| filterStyle | The css class style sheet to use for the filter column. |
| format | The format to use for the cell. For instance if used with a date cell then the format can be MM/dd/yyyy. |
| headerCell | Display for the header column. The default is header. The cell can also be a fully qualified class name to a custom cell. |
| headerClass | The css class style sheet used to define what the table header column looks like. |
| headerStyle | The css class style sheet to use for the header column. |
| intercept | A fully qualified class name to a custom InterceptColumn implementation. Could also be a named type in the preferences. Used to add or modify column attributes. |
| parse | Used if the format needs to be interpreted. For instance, a date needs to be parsed in the specific format, such as MM-dd-yyyy. |
| property | The bean attribute to use for the column. |
| sortable | Specify whether or not the column should be sortable. The acceptable values are true or false. The default is to use the value for the table sortable attribute. |
| style | The css inline style sheet. |
| styleClass | The css class style sheet. |
| title | The display for the table column header. If the title is not specified then it will default to the name of the property, changing the camelcase syntax to separate words. |
| value | The value for the column. If the value attribute is not specifed then it will be retrieved automatically using the property attribute. The value can also be defined within the column body. |
| viewsAllowed | The comma separated list of views that this column will be used in. |
| viewsDenied | The comma separated list of views that this column will not be used in. |
| width | Specify the column width. |
16.4.?ExportTag
Table?16.4.?
| fileName | The name of the export file. |
| imageName | The image name. |
| intercept | A fully qualified class name to a custom InterceptExport implementation. Could also be a named type in the preferences. Used to add or modify export attributes. |
| view | A fully qualified class name to a custom View implementation. Could also be a named type in the preferences. Default types are pdf, xls, or csv. |
| viewResolver | A fully qualified class name to a custom ViewResolver implementation. Could also be a named type in the preferences. Default types are pdf, xls, or csv. |
| text | The text for the export view. |
| tooltip | The tooltip that shows up when you mouseover the export image. |
16.5.?ExportXlsTag
Table?16.5.?
| fileName | The name of the export file. |
| imageName | The image name. |
| intercept | A fully qualified class name to a custom InterceptExport implementation. Could also be a named type in the preferences. Used to add or modify export attributes. |
| view | A fully qualified class name to a custom View implementation. Could also be a named type in the preferences. Default types are pdf, xls, or csv. |
| viewResolver | A fully qualified class name to a custom ViewResolver implementation. Could also be a named type in the preferences. Default types are pdf, xls, or csv. |
| text | The text for the export view. |
| tooltip | The tooltip that shows up when you mouseover the export image. |
16.6.?ExportCsvTag
Table?16.6.?
| delimiter | What to use as the file delimiter. The default is a comma. |
| fileName | The name of the export file. |
| imageName | The image name. |
| intercept | A fully qualified class name to a custom InterceptExport implementation. Could also be a named type in the preferences. Used to add or modify export attributes. |
| view | A fully qualified class name to a custom View implementation. Could also be a named type in the preferences. Default types are pdf, xls, or csv. |
| viewResolver | A fully qualified class name to a custom ViewResolver implementation. Could also be a named type in the preferences. Default types are pdf, xls, or csv. |
| text | The text for the export view. |
| tooltip | The tooltip that shows up when you mouseover the export image. |
16.7.?ExportPdfTag
Table?16.7.?
| headerBackgroundColor | The background color on the header column. |
| headerColor | The font color for the header column. |
| headerTitle | The title displayed at the top of the page. |
| fileName | The name of the export file. |
| imageName | The image name. |
| intercept | A fully qualified class name to a custom InterceptExport implementation. Could also be a named type in the preferences. Used to add or modify export attributes. |
| view | A fully qualified class name to a custom View implementation. Could also be a named type in the preferences. Default types are pdf, xls, or csv. |
| viewResolver | A fully qualified class name to a custom ViewResolver implementation. Could also be a named type in the preferences. Default types are pdf, xls, or csv. |
| text | The text for the export view. |
| tooltip | The tooltip that shows up when you mouseover the export image. |
16.8.?ColumnsTag
Table?16.8.?
| autoGenerateColumns | A fully qualified class name to a custom AutoGenerateColumns implementation. Could also be a named type in the preferences. Used to generate columns on the fly. |
16.9.?ParameterTag
Table?16.9.?
| name | The name of the parameter. |
| value | The value of the parameter. |
總結
以上是生活随笔為你收集整理的eXtremeComponents文档的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： Hello JavaEye
- 下一篇： 《UNIX编程艺术》--读书笔记