Chapter 15. 1.0.1-M4升级说明(2)

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 15. 1.0.1-M4升级说明(2)