What's JAVA ?

tree2是Myfaces的tomahawk控件中的一個，在使用tomahawk控件之前一定先確定已經按照myfaces的要求配置好web.xml文件。
Myfaces網站tomahawk欄目的Extensions Filter 子欄目中有如下一段話：
If you just use standard JSF component, but don't use any MyFaces' extended component (beginning with t:),
then you don't need the Extensions Filter.
However, if you use some of the MyFaces' extended components like t:inputFileUpload, t:inputHTtml, t:inputCalendar, ...
then you most likely need to have this filter configured in your webapp.
大概意思是，如果你在項目中沒有使用到Myfaces的擴展組件（t:開頭的），則你不需要配置這個Filter.
可是，如果你用了Myfaces的擴展組件，你必須為你的web程序配置這個Filter.
配置如下：

要使用MyFaces的tomahawk控件，要在頁面引用<%@ taglib uri="在頁面中添加tree2的標簽：

<t:tree2 id="sortTree" var="node" varNodeToggler="t" showRootNode="false" value="#{tree.treeData}">

</t:tree2>

建立托管Bean,用于填充tree。

public class TreeBacker implements Serializable
{
    public TreeNode getTreeData ( )
    {
        TreeNode treeData = new TreeNodeBase ( "foo-folder" , "Inbox" , false ) ;

        TreeNodeBase personNode = new TreeNodeBase("person", "Eddie L", false);
        //personNode.getChildren().add(new TreeNodeBase("document","Eddie doc one", true));
        TreeNodeBase doc = new TreeNodeBase("document","Eddie doc one", true);
        doc.setIdentifier("No.1");
        personNode.getChildren().add(doc);
        treeData.getChildren().add(personNode);
        
        System.out.println ( "Create Tree ..ok" ) ;
        return treeData ;
    }
}

其中TreeNodeBase personNode = new TreeNodeBase("person", "Eddie L", false);中的"person"的作用是表示渲染得時候顯示什么樣式，
跟頁面中<f:facet name="person"></f:facet>相對應。
在頁面中

<f:facet name="person">
    <h:panelGroup>
        <f:facet name="expand">
            <t:graphicImage value="../images/person.png" rendered="#{t.nodeExpanded}" border="0" />
        </f:facet>
        <f:facet name="collapse">
            <t:graphicImage value="../images/person.png" rendered="#{!t.nodeExpanded}" border="0" />
        </f:facet>
        <h:outputText value="#{node.description}" styleClass="nodeFolder" />
    </h:panelGroup>
</f:facet>

<t:graphicImage value="../images/person.png" rendered="#{t.nodeExpanded}" border="0" />顯示Tree每一個節點的圖片。rendered屬性的意思是是否渲染的意思，
jsf中渲染的意思是把jsf組件樹當前的狀態轉換成html。在jsf的生命周期里，渲染響應在最后一個周期，rendered值為false在渲染相應這個周期就不運行。
在處理葉子節點上，需要特殊的注意。因為對葉子節點是需要操作的。可能需要點擊葉子節點連接到一個頁面，或者執行某些action等。

<f:facet name="document">
    <h:panelGroup>
        <h:commandLink immediate="true" styleClass="#{t.nodeSelected ? 'documentSelected':'document'}" actionListener="#{t.setNodeSelected}" action="#{tree.okListener}" id="clickbutton">
            <t:graphicImage value="../images/document.png" border="0" />
            <h:outputText value="#{node.description}" />
            <f:param name="docNum" value="#{node.identifier}" />
        </h:commandLink>
    </h:panelGroup>
</f:facet>

commandLink標記可以有n個參數，參數分為參數名和參數值。在程序里可以讀取。
編寫action事件：okListener

FacesContext context = FacesContext.getCurrentInstance ( ) ;//取得上下文

String a = context.getExternalContext ( ).getRequestParameterMap ( )
                .get ( "docNum" ).toString ( ) ;

a的值就是docNum的值。
identifier的值在創建樹的時候一起加進去的：
TreeNodeBase doc = new TreeNodeBase("document","Eddie doc one", true);
doc.setIdentifier("No.1");

這樣。一個tree2的應用基本就算ok了。