1.0.1-M5-A4升級說明(M5 Release翻譯稿)
extremecomponents-1.0.1-M5-A4版(下載) 是正式版發(fā)行前的最后開發(fā)快照版。這個build版所使用的代碼將被下一個release版沿用。
我決定發(fā)布一個新的里程碑(milestone)版是因為我對視圖(view)的代碼做了一些調(diào)整,現(xiàn)在eXtremeTable將能夠支持AJAX(而不是局部build)。 在確認release候選版前,這些增加的大的特性能夠完美地工作。
下面列出的是eXtremeTable下一個里程碑(milestone)版特性和改進,我希望從上一個里程碑版升級到現(xiàn)在這版沒有任何問題(breakage)。 然而,在完成M4版視圖實現(xiàn)后,我決定我必須做最后的更改...將靜態(tài)builders變?yōu)榫唧w的類。這將是唯一可能出現(xiàn)問題(breakage)并且 將只影響到定制視圖(定制cells也一樣,但是更多的是較平和的deprecated)。盡管那樣,這些更改將很容易實現(xiàn)。
所有的視圖builder類具體化,需要被實例化,這些只對開發(fā)者需要創(chuàng)建定制試圖或cells有影響。 這是因為需要使得視圖代碼能夠像他們需要的那樣具有彈性。builder classes是靜態(tài)的能夠很好地工作,但是 將來沒有機會來做一些有意義的事,并且創(chuàng)建定制試圖更加麻煩。然而,現(xiàn)在這些方法和原來的一樣,而僅僅是需要對它進行實例化。
為了使這種轉變更容易CellBuilder仍然是靜態(tài)的,但是現(xiàn)在為deprecated。新的(非靜態(tài))builder稱為ColumnBuilder,通過這個名稱我們能更確切地知道什么被構建了。
public String getHtmlDisplay(TableModel model, Column column) {
ColumnBuilder columnBuilder = new ColumnBuilder(column);
columnBuilder.tdStart();
columnBuilder.tdBody(getCellValue(model, column));
columnBuilder.tdEnd();
return columnBuilder.toString();
}
另一個例子,使用ColumnBuilder定制cells如下:
public String getHtmlDisplay(TableModel model, Column column) {
InputBuilder inputBuilder = new InputBuilder(column);
inputBuilder.tdStart();
try {
Object bean = model.getCurrentRowBean();
Integer id = new Integer(BeanUtils.getProperty(bean, "id"));
inputBuilder.tdBody(id);
} catch (Exception e) {}
inputBuilder.tdEnd();
return inputBuilder.toString();
}
private static class InputBuilder extends ColumnBuilder {
public InputBuilder(Column column) {
super(column);
}
public void tdBody(Integer id) {
getHtmlBuilder().input("radio").name("location.id").id("location.id").value(id.toString()).onclick("populateLocationFields(this.value)");
getHtmlBuilder().xclose();
}
}
}
這樣更簡潔,只需要擴展你關心的builder,并構建你定制的實現(xiàn)。
另外toolbar被完全重構,但是這個實現(xiàn)被隱藏在ToolbarBuilder類的背后,所以不會有影響。
最后,我探索性地增加了toolbar特性,這樣可以在preferences配置表關聯(lián)到不同的toolbars。 這個特性能夠用來動態(tài)構造toolbar。這將使開發(fā)者很簡單地通過preferences來定義一個定制的toolbar。 例如,一個toolbar當使用Limit定制不包含最后一頁按鈕,或者另一個toolbar不包含rows displayed... 如果你要定制的就是這些東西而不需要別的新的特性,你最好等待一兩個星期直到我實現(xiàn)完成。
Limit特性為了使用State特性,你需要使用TableLimitFactory的帶有state的構造函數(shù),當使用state 特性時,你應該提供唯一的tableId(本例為presidents),帶有state的構造函數(shù)同時也需要這個tableId。
Context context = new HttpServletRequestContext(request);
LimitFactory limitFactory = new TableLimitFactory(context, presidents, TableConstants.STATE_PERSIST, null);
Limit limit = new TableLimit(limitFactory);
TableTag新的filterOptions屬性,能夠接受一個filter options的集合,這個集合中的每個bean都實現(xiàn)FilterOption的 接口。被用來和filterCell=droplist結合,當使用Limit時使用定制droplist時非常有用。
默認的XlsView使用UTF-16編碼,這樣能夠支持對于雙字節(jié)語言導出。如果要使用unicode,你可以設置 ExportTag的新的encoding屬性,這個屬性接受的值為:UTF和UNICODE。
TableModel現(xiàn)在變?yōu)榻涌冢@只對TableAssembler產(chǎn)生影響。然而,正如下面提到的,使用Java代碼來組裝一個表將更容易。
當使用Java代碼來組裝一個表將更容易:
TableModel model = new TableModelImpl(context);
Table table = new Table(model); table.setItems(presidents); table.setAction("assembler.run"); table.setTitle("Presidents"); table.setShowTooltips(Boolean.FALSE); model.addTable(table);
Row row = new Row(model); row.setHighlightRow(Boolean.FALSE); model.addRow(row);
Column columnName = new Column(model); columnName.setProperty("fullName"); columnName.setIntercept((AssemblerIntercept.class).getName()); model.addColumn(columnName);
Column columnNickName = new Column(model); columnNickName.setProperty("nickName"); model.addColumn(columnNickName);
Object view = model.assemble();
過濾器的response頭應該能更好地適應不同環(huán)境,在response頭后添加:
response.setHeader("Cache-Control", "must-revalidate, post-check=0,pre-check=0");
autoGenerateColumns屬性現(xiàn)在可以在Preferences文件中配置,可以使用別名來避免全路徑引用。
當使用eXtremeTable API來通過JAVA代碼來創(chuàng)建表時,現(xiàn)在可以結合AJAX技術來生成視圖。這意味著 當navigate(比如:翻頁)時不需要刷新web頁,這令人非常興奮,關于這個特性的更多的文檔將會出來。開發(fā) 者能夠更好地測試并使用這個特性,這個特性的真正hook是表的onInvokeAction屬性,它使得javascript方法 能夠被invoked。AJAX整合一個最強大的地方是它不需要整合。下一步是使eXtremeTable有一個清晰并且易于使用的API, 這意味著你可以使用你感興趣的AJAX技術因為eXtremeTable沒有整合一個特定的技術。現(xiàn)在你可以通過CVS得到eXtremeSite代碼, 它展示了一個使用AJAX的實例,它現(xiàn)在使用HSQL所以只需要下載并直接運行。請暫時不要向我詢問更多的文檔,我現(xiàn)在正在整理 并將盡可能快的發(fā)布出來。
posted on 2006-03-21 10:18 Lucky 閱讀(1127) 評論(0) 編輯 收藏 所屬分類: extremeComponents