JSF複合組件
JSF通過Facelets提供複合組件(有點類似於Widget)的概念。複合組件是一種特殊類型的模板，它充當應用程序中的一個組成部分。
複合組件由標記標籤和其他現有組件組成。 這個可重複使用的用戶創建的組件具有定製的定義功能，並且可以像任何其他組件一樣具有連接到它的驗證器，轉換器和監聽器。 包含標記標籤和其他組件的任何XHTML頁面都可以轉換爲複合組件。
以下表格包含複合標籤以及說明 -
標籤
功能
composite:interface
它用於聲明覆合組件的約定。 組合組件可以用作單個組件，其特徵集合是使用合同中聲明的功能的並集。
composite:implementation
它用於定義複合組件的實現。 如果composite:interface元素存在，必須有一個相應的composite:implementation。
composite:attribute
它用於聲明一個屬性，該屬性可以被賦予該標籤被聲明的複合組件的一個實例。
composite:insertChildren
它用於在使用頁面中的複合組件標籤中插入子組件。
composite:valueHolder
它用於聲明由該元素嵌套的composite:interface聲明其合同的組合組件暴露了適用於使用頁面中附加對象目標的ValueHolder實現。
composite:editableValueHolder
它用於聲明由該元素嵌套的composite:interface聲明其合同的組合組件暴露了適用於使用頁面中附加對象目標的EditableValueHolder的實現。
composite:actionSource
它用於聲明由該元素嵌套的composite:interface聲明其約定的組合組件，暴露了適用於使用頁面中附加對象目標的ActionSource實現。
在下面的例子中，我們分析一個接受用戶名和電子郵件地址作爲輸入的組合組件。
實例
打開NetBeans IDE創建一個名稱爲：CompositeComponents 的Web工程，其完整的目錄結構如下所示 -
創建複合組件
在創建組合組件之前，請確保使用正確的命名空間，如下所示。
xmlns:composite="http://xmlns.jcp.org/jsf/composite"創建一個文件：composite-component.xhtml，代碼如下所示 -
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"
xmlns:composite="http://xmlns.jcp.org/jsf/composite"
xmlns:h="http://xmlns.jcp.org/jsf/html">
<h:head>
<title>Composite Component Example</title>
</h:head>
<h:body>
<h2>In composite-component.xhtml Form</h2>
<composite:interface>
<composite:attribute name="username" required="false"/>
<composite:attribute name="email" required="false"/>
</composite:interface>
<composite:implementation>
<h:outputLabel value="User Name " />
<h:inputText value="#{cc.attrs.username}"/><br/>
<h:outputLabel value="Email ID "/>
<h:inputText value="#{cc.attrs.email}"/><br/>
</composite:implementation>
</h:body>
</html>在上面的例子中，composite:interface標籤用於聲明可配置的值。 composite:implementation標籤用於聲明所有XHTML標記和cc.attrs.username用於定義inputText組件的值。 ccs是JSF中複合組件的保留字。 表達式#{cc.attrs.attribute-name}用於訪問爲組合組件界面定義的屬性。
上述代碼作爲名爲composite-component.xhtml的文件存儲在應用程序Web根目錄的 resources/com 文件夾中。
使用複合組件
使用複合組件的網頁通常稱爲使用頁面。 使用頁面包含對xml命名空間聲明中複合組件的引用，如下所示：
<html xmlns:co="http://xmlns.jcp.org/jsf/composite/com">這裏，com是存儲文件的文件夾，co是用於訪問組件的引用。
創建一個文件：index.xhtml，代碼如下所示 -
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"
xmlns:h="http://xmlns.jcp.org/jsf/html"
xmlns:co="http://xmlns.jcp.org/jsf/composite/com">
<h:head>
<title>Implementing Composite Component</title>
</h:head>
<body>
<h:form>
<co:composite-component />
</h:form>
</body>
</html>運行項目後，在網頁上將看到以下用戶界面 -
