隨筆分類(103)

在最后會附上一些我在使用中的體會，和大家分享，如果大家有什么想法的話，可以和我多多交流了。本人第一次翻譯文章，難免會有很多不足之處，請大家諒解，也請多多指點。

英文原作：http://www.aygfsteel.com/steady/archive/2006/01/12/27814.html

轉(zhuǎn)載自：http://wiki.apache.org/myfaces/Tree2

正文如下：

Tree2組件使用HTML表格將你的數(shù)據(jù)呈現(xiàn)為一個樹。這個樹是動態(tài)的：當用戶點擊它們時它們可以展開或者折疊。該組件同時支持客戶端和服務(wù)端的交互方式，在客戶端交互時使用了JavaScript。在隨后的例子中，每次用戶的點擊將產(chǎn)生一個Request / Response 周期，并在新的視圖狀態(tài)（View State）中重新呈現(xiàn)新的樹結(jié)構(gòu)。

注：在后面的例子中只有可見的（已經(jīng)展開的節(jié)點）數(shù)據(jù)被傳送到客戶端。而在第一個例子（客戶端Tree），在每個HTML Response中，整個樹都被發(fā)送到客戶端瀏覽器。樹的每個節(jié)點都包含了不少的HTML代碼（假定每個節(jié)點200個字符，這個大小將取決于你希望在節(jié)點上顯示的信息的量），這些信息將被傳送到瀏覽器，其中包括了那些不可見的節(jié)點（沒有展開的節(jié)點），因為它們的一個祖系節(jié)點被展開。如果你有一個深度有四層的樹，平均每個結(jié)點擁有四個子結(jié)點，這時候你就需要傳輸10 + 10² + 10³ + 10⁴ = 11 110個節(jié)點，每個節(jié)點有200個字符，這個樹總共就有2 222 000個字符，也就是2M的數(shù)據(jù)。這個例子將向用戶說明，雖然純客戶端Tree會給客戶端帶來更好的用戶體驗，但隨之而來的帶寬問題迅速的增長。純客戶端的樹適用于小型的樹，或者在Intranet及寬帶連接中使用的中型大小的樹。對于大型的樹，或者你需要照顧到一些低帶寬的用戶的需要時，你就需要使用服務(wù)端樹。你可以通過<t:tree2>的clientSideToggle這個屬性來選擇你使用的是客戶端的樹或者服務(wù)端的樹，<t:tree2 clientSideToggle="false" ...將會使用服務(wù)端的樹，屬性值設(shè)為true將會使用客戶端的樹，默認值為true。

用法：

Backing Bean:

Tree2組件對Backing Bean中的一個TreeModel進行操作。通常情況，你只要把這個TreeModel綁定到這個組件上就可以了，就像這樣：

<t:tree2 value="#{myHandler.treeModel}" 

下面需要建立一個類MyHandler，在faces-config.xml中的managed bean配置成myHandler，在例子中這個類提供了一個方法getTreeModel()用于返回一個TreeModel用于表示你的數(shù)據(jù)。

public class MyHandler {
  public TreeModel getTreeModel() {
    
  }
}

TreeModel實際上是對TreeNode實例進行了一些簡單的包裝。

TreeNode是一個接口，其中和tree2相關(guān)有四個方法：

String getType()

boolean isLeaf()

List getChildren()

int getChildCount()

其它方法都沒有什么用處了，可能會在今后的版本中取消。它們要求開發(fā)者在開發(fā)backing bean中做一些并不必要的操作。

int getChildCount() 方法返回這個節(jié)點的子結(jié)點數(shù)量，這個方法了很容易的采用如下的方式實現(xiàn)：

  public final int getChildCount() {
    return getChildren().size();
  }

該方法的出現(xiàn)使得對于子結(jié)點的延遲加載變的可行。該方法的實現(xiàn)只需要返回該節(jié)點的子結(jié)點數(shù)量，而不需要返回每個子結(jié)點的實例。

boolean isLeaf() 方法在該節(jié)點沒有子節(jié)點的時候返回true。這樣，一個很直截了當?shù)膶崿F(xiàn)可以這樣：

  public final boolean isLeaf() {
    return getChildren().isEmpty();
  }

不管你提供了什么樣的實現(xiàn)，在任何時間任何情況下你都得保持getChildren().isEmpty() ==> isLeaf()。isLeaf()方法實際上控制了節(jié)點被怎樣呈現(xiàn)：是否被當做樹葉節(jié)點（不能被繼續(xù)展開）。

String getType() 方法決定了用怎樣的方式來呈現(xiàn)這個節(jié)點。在 JSF 頁面中，可以在 <t:tree2> 的Tag 中嵌套facet，JSF將會選出與 getType() 方法返回值同名的 facet 用于呈現(xiàn)。如果該節(jié)點沒有找到相符的 facet，將會導(dǎo)致一個錯誤，并且這個方法不會返回null。

List getChildren() 方法返回一個 List，其中包含了該節(jié)點下所有的 TreeNode，這就表示這些節(jié)點將被呈現(xiàn)為該節(jié)點下的子結(jié)點。該 List 不能包含 null，如果該 List 的大小和getChildCount()不符，將會報錯。子結(jié)點將按照它們在 List 中的順序呈現(xiàn)出來。

   后面一半的將會盡快完成翻譯，大約今晚或明天就可以拿出來了。