a) 導入 ADF Faces 標記庫
ADF Faces 定義了兩個(gè)標記庫 — Core 和 HTML。Core 庫包含 UI 組件：按鈕、輸入域、列表、菜單、表、樹(shù)、面板以及許多其他組件。HTML 庫包括幾個(gè)標記，它們可用于生成 Web 頁(yè)面的 <html>、<head> 和 <body> 標記以及其他與 HTML 相關(guān)的內容，如框架和表格。必須使用 <%@taglib%> 指令將這兩個(gè)庫導入到任何使用它們的頁(yè)面中：
<%@ taglib prefix="af" uri="http://xmlns.oracle.com/adf/faces/EA13" %> <%@ taglib prefix="afh" uri="http://xmlns.oracle.com/adf/faces/EA13/html" %>
當您將 ADF Faces 組件添加到現有 JSF 頁(yè)面（使用 Component Palette）時(shí)或者當您將 JSF 標記轉換為 ADF Faces 標記（使用本節后面提到的 JDeveloper 的向導）時(shí)，Oracle JDeveloper 自動(dòng)插入這兩個(gè) <%@taglib%> 指令。.
b) 使用 ADF Faces 的 HTML 標記
ADF Faces 的 <afh:html>、<afh:head> 和 <afh:body> 標記生成相應的 HTML 元素以及其他一些內容，如文檔的 <title> 元素和 ADF Faces 組件的樣式表。以下是一個(gè)使用 ADF Faces 的典型 JSF 頁(yè)面的模板：
<%@ taglib prefix="f" uri="http://java.sun.com/jsf/core" %> <%@ taglib prefix="h" uri="http://java.sun.com/jsf/html" %> <%@ taglib prefix="af" uri="http://xmlns.oracle.com/adf/faces/EA13" %> <%@ taglib prefix="afh" uri="http://xmlns.oracle.com/adf/faces/EA13/html" %> <f:view> <f:loadBundle var="labels" basename="..."/> <afh:html> <afh:head title="#{labels...}"/> <afh:body> ... </afh:body> </afh:html> </f:view>
如果有必要，您可以在沒(méi)有 ADF Faces 幫助的情況下在 JSF 頁(yè)面中編寫(xiě) <html>、<head> 和 <body> 標記，但這時(shí)您必須在 HTML 標題中包含一個(gè) <af:styleSheet> 組件。
c) 重命名 JSF 標記以及它們的一些屬性
ADF Faces 提供一組類(lèi)似于標準 JSF 標記的標記以及很多在 JSF 中沒(méi)有對應項的其他標記。您可以在同一頁(yè)面中混合使用 JSF 和 ADF Faces 標記，這是因為所有 UI 組件都基于由 JSF 標準定義的同一個(gè) API。在將 ADF Faces 添加到現有 JSF 應用程序時(shí)，您應該重命名那些在 ADF Faces 中具有對應項的 JSF 標記，以確保前后一致的觀(guān)感并從其他特性（如客戶(hù)端驗證）中獲益。ADF Faces 標記還幫助您減少代碼的行數。例如，一個(gè) ADF Faces 標記（如 <af:inputText>）就可以生成一個(gè)輸入組件、一個(gè)標記和一個(gè)錯誤消息：
<af:inputText id="email" required="true" validator="#{subscriber.emailValidator}" label="#{labels.email}" value="#{subscriber.email}" columns="40" maximumLength="80"> <f:validateLength minimum="1" maximum="80"/> </af:inputText>
而對于 JSF，您需要三個(gè)標記（<h:outputLabel>、<h:message> 和 <h:inputText>）來(lái)達到同樣的效果：
<h:outputLabel for="email" value="#{labels.email}"/> <h:message for="email" styleClass="message"/><br> <h:inputText id="email" required="true" validator="#{subscriber.emailValidator}" value="#{subscriber.email}" size="40" maxlength="80"> <f:validateLength minimum="1" maximum="80"/> </h:inputText>
請注意，<af:inputText> 標記可以用于顯示單行、多行和口令域，而 JSF 為這些類(lèi)型的組件提供了三種不同的標記：<h:inputText>、<h:inputTextarea> 和 <h:inputSecret>。ADF Faces 的 <af:inputText> 標記有兩個(gè)名為 rows 和 secret 的屬性，它們將確定域的類(lèi)型。例如，您可以使用以下代碼生成一個(gè)口令域：
<af:inputText id="password" secret="true" required="true" label="#{labels.password}" value="#{subscriber.password}" columns="10" maximumLength="20"> <f:validateLength minimum="6" maximum="20"/> </af:inputText>
ADF Faces 文檔（參見(jiàn)“資源”）詳細說(shuō)明了 JSF 標記與其 ADF Faces 對應項之間存在的所有差別。在很多情況下，您只需將 h 前綴替換為 af，并可能要重命名一些屬性。有時(shí)您還必須重命名標記。例如，您將使用 <af:goLink> 代替 <h:outputLink>，使用 <af:selectOneChoice> 代替 <h:selectOneMenu>：
<af:selectOneChoice id="subscriptionType" label="#{labels.subscriptionType}" value="#{subscriber.subscriptionType}" required="true"> <f:validateLongRange minimum="1" maximum="3"/> <af:selectItem label="#{labels.daily}" value="#{subscriber.dailyConst}"/> <af:selectItem label="#{labels.weekly}" value="#{subscriber.weeklyConst}"/> <af:selectItem label="#{labels.monthly}" value="#{subscriber.monthlyConst}"/> </af:selectOneChoice>
