JSF 应用程序需要某种显示技术, 例如JSP。JSP的酷特性之一是它能用定制标记扩展，一个定制标记就是在背后有JAVA代码支持的特殊 XML 元素。在JSP中除使用标准JSP元素或HTML元素之外还能使用定制标记。 定制标记几乎能做任何事情：显示变量的值，处理XML，有条件地显示页面的一部分，访问一个数据库，等等 (是否任何人都应该用JSP标记做所有的这些事情，那是将来的问题...). 他们主要的目的是将java代码从页面中分离并允许前台开发者用简单、熟悉的标记替代。一组有关系的定制标记构成一个标记库。 JSF与JSP一起使用定制标记。 到目前为止，在这本书里我们已经示例过的所有JSF标记 —<h:inputText>, <h:outputText>, <h:form>, <f:view>, 等等—都是定制标记。 JSF 实现提供访问标准组件，绘制器，验证器和转换器的JSP定制标记，在下表中列出了这些标记库（JSF的JAR文件中包含了这些库）
URI
名称
前缀
描述
http://java.sun.com/jsf/core
Core
f
Contains tags that are independent of a particular render kit (like <f:view>, <validator>, and so on)
http://java.sun.com/jsf/html
HTML
h
Contains tags for all of the standard components and the HTML render kit
所有这些标记库中的标记必须命名和以一种特殊的方式实现。 这种方式，能确保基于JSP的应用程序访问不同的JSF实现。大多数 IDEs 支持JSP，在极大程度上， JSF和JSP一起使用就象是使用JSF定制标记库。 然而，有一些你应该明白的细微差别, 例如象使用JSP includes。
Using JSP includes
JSP的关键特性之一是它能将多个JSP页面的内容包含到一个单一的JSP页面。 常使用这个特性执行一些有趣的任务如包含一个标题或页脚。 JSP 支持两种类型的 includes: 动态的和静态的。动态的包含 (用<jsp:include> 标记或 JSTL <c:import> 标记执行) 在运行时访问资源。在这种情形下， 控制转到被包含的JSP页，来自被包含页面的响应与包含页面的响应结合在一起。 当改变动态包含页的内容时，能自动显示新的变化，静态的包含在编译成java代码时已与包含页面的内容结合。本质上，这些被包含页面的内容被拷贝到了包含页。改变被包含页的内容一般不会自动显示新的变化，因为他们已经有了他们先前内容的拷贝。 只有重新编译新的内容才有正确的显示。 (JSP 2.0的 implicit includes, 能通过web.xml配置, 它的处理方式象静态包含) JSF使用两种类型的JSP includes. 对于动态的includes, 有两个必要条件：
被包含的页面必须用JSF核心标记 <f:subview> 封闭。 <f:subview>标记可以用在被包含页面的内部。也可以用于封闭 include 语句。如下所示（这里是站长加的代码）
<f:view>
...
<f:subview id="header">
<c:import url="header.jsp" />
</f:subview>
...
</f:view>
在被包含的JSP页面内的所有模板文本和非JSF 标记应该用 JSF核心标记 <f:verbatim>封闭；
所以，如果在一个JSP页面内我们有下列代码:
<f:view>
...
<jsp:include page="foo.jsp"/>
...
</f:view>
foo.jsp 应该象下面这样：
<f:subview>
<h:outputText value="heyah!"/>
...
<f:verbatim>
<b>Template text.</b>
<customtag:dothis/>
</f:verbatim>
</f:subview>
象你看到那样，整个被包含的页面封闭在一个 <f:subview> 标记内，所有的非JSF标记和模板文本被标记<f:verbatim>封闭。 作为选择，我们可以把<f:subview> 标记放入初始页封闭<jsp:include> 。 使用静态的include非常简单，没有什么限制—你甚至不需要使用<f:subview> 标记。在最后的例子中，我们示范一个自定义标记<customtag:dothis>, 它执行一些随机的任务，这强调了一个重点：你能把其它的JSP自定义标记与JSF一起使用。
和 JSF 一起使用 JSTL 和其它的 JSP 定制标记
所有谈到的JSF定制标记库都是不错的，但是，如果我有自己的定制标记，或有第三方的标记库应该怎么办？或者我要使用JSP标准标记库 (JSTL)？它是一组能做我们刚提到的所有事情的标记库。 在极大程度上，这些标记能与JSF标记混合使用。 Faces标记能在其它标记的内部嵌套使用，反之亦然。 一些产品，象IBM的 WebSphere Application Developer, 鼓励这种方法。其它的如 Sun的 Java Creator Studio则选择纯的JSF标记， 另一方面，Oracle的 JDeveloper 让你混合和配合使用，但也鼓励使用纯JSF标记。
注意: 无论何时，你将JSF 标记嵌套在非JSF定制标记内时，你必须分派一个组件标识符到JSF 标记。 因为JSTL 是标准的并且许多人熟悉它，我们将用它示范如何将它与 JSF定制标记一起使用。 (如果你想全面了解JSTL, 请看 Shawn Bayern写的一本极好的书, JSTL in Action.) 让我们从简单的例子开始 (显示在清单1) JSTL 标记和 JSF 标记混合和配合使用。代码引入了两个 JSF 标记库和核心 JSTL 标记库。
清单 1. JSTL 标记与 JSF 标记混合使用
<%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %>
<%@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %>
<%@ taglib uri="http://java.sun.com/jstl/core" prefix="c" %>
<html>
<head>
<title>JSF in Action: JSTL Example 1 - Mixing JSF with other custom tags
</title>
</head>
<body bgcolor="#FFFFFF">
<f:view>
<h1>
<h:outputText value="Example of using JSF tags with other custom tags"/>
</h1>
<p>
<b>
<c:out value="Here's the value of your web.xml (don't do this at home):"/>
</b>
<blockquote>
<f:verbatim>
<c:import url="WEB-INF/web.xml"/>
</f:verbatim>
</blockquote>
</p>
</f:view>
</body>
</html></code>
在这个例子里， JSTL 和JSF 标记嵌套在 JSF标记 <f:view>内， <f:view>定义了JSF组件树的开始。这个例子使用了 JSF 的h标记 (<h:outputText>) 和JSTL <c:out> 标记显示文本。 在这个页面内，JSTL <c:import> 标记包含系统的 web.xml 文件 (这不是你想与其它人共享文件的正确方法，所以，不要在一台真实的服务器上这样做). 因为 web.xml 是一个XML 文件， <c:import>标记要嵌套在<f:verbatim> 内, <f:verbatim>是一个 JSF UIOutput组件并且绘制时转义XML元素，所以能在HTML页内正确显示。这个例子没有太多的内容，但它示范了在同一页面内不同的标记能一起使用。注意我们把JSTL 标记嵌套在 JSF <f:verbatim> 标记内，一般而言，它比将 JSF 标记嵌套在其它标记内容易。事实上，任何有子组件的组件如 HtmlDataTable和 HtmlPanelGrid需要将模板文本嵌套在一个<f:verbatim> 标记内。 JSTL 标记与 JSF 标记一起使用使JSF变得更强大，这两者都使用类似的表达式语言。 (对 JSP 2.0's 表达式也是如此l). 这允许你以一种直观的方式在JSTL 和 JSF 标记间共享数据。 这里举例说明这一点，让我们看另一个例子， 它允许用户在 HtmlInputText 控件中输入一个值，然后利用这个值用 JSTL <c:forEach>标记重复输出一个字符串。 代码在清单2列出。
清单2. JSF 、JSTL 标记和同一个 backing bean
...
<f:view>
<jsp:useBean class="org.jia.examples.TestForm" id="exampleBean" scope="session"/>
<h1>
<h:outputText value="Example of using JSF and JSTL expression languages"/>
</h1>
<h:form>
<h:outputLabel for="inputInt">
<h:outputText value="How many times do you want to repeat the Oracle's prophecy?"/>
</h:outputLabel>
<h:inputText id="inputInt" value="#{sessionScope.exampleBean.number}"/>
<h:commandButton value="Go!"/>
<p>
<c:if test="${sessionScope.exampleBean.number > 0}">
<c:forEach begin="0" end="${sessionScope.exampleBean.number - 1}" var="count">
Queen Tracey will achieve world domination.<br>
</c:forEach>
</c:if>
</p>
</h:form>
...
</f:view>
...
警告: 如果你用 JSP 或 JSTL 表达式访问 managed beans, 你必须确保 beans 已经被创建，这是因为这些旧的表达式语言不知道JSF中的Managed Bean如何创建。这个例子中定义了一个叫exampleBean的JavaBean, 它有一个int类型的 number 属性。使用HtmlInputText 组件基于用户的输入更新bean的属性值。当用户点击Go! 按钮时 (一个 HtmlCommandButton 组件), 更新number属性的值并重新显示页面。 当这一切发生时， JSTL <c:forEach> 标记通过 JSTL <c:out> 标记重复显示文本 exampleBean.number 次。当exampleBean.number的值大于0时，<c:forEach> 标记才执行，这通过JSTL <c:if>进行测试。
你不能在叠代主体的循环标记内部使用 JSF 组件标记，象JSTL 的 <c:forEach>标记。 推荐的方法是使用 HtmlDataTable 组件或其它的组件叠代一个数据集或集合，在这个例子中，没有 JSF 组件 嵌套在 JSTL <c:if>标记内。 但是如果组件显示一次然后当页面再次显示时被条件标记（如 <c:if>）隐藏会发生什么呢？ 第一次显示组件时，组件被添加到视图，第二次如果<c:if> 标记不显示组件， JSF 将从视图中删除它。意思就是任何输入控件会丢失他们的本地值，你不能再引用这些组件，举一个例子，看清单3, 它来自清单2的同一页.
清单 3. 用JSTL标记条件显示JSF 组件
...
<h:form>
<h:outputText value="If you entered a number greater than 10,
two input controls will display below."/>
<p>
<c:if test="${sessionScope.exampleBean.number > 10}">
<h:outputLabel id="inputStringLabel"for="inputString">
<h:outputText id="outputStringLabel" value="Enter in your string.
JSF will remember the value unless this control is hidden."/>
</h:outputLabel>
<h:inputText id="inputString"/>
<h:commandButton value="Go!"/>
</c:if>
</p>
</h:form>
...
如果exampleBean.number的值比10大， JSTL <c:if> 标记将会执行它的主体。如果主体被执行，那么所有嵌套其中的组件将增加到视图并显示。 如果没有执行，组件将会删除 (如果先前已增加). 这显示在图1. 如果你用JSTL 条件标记（或其它的定制标记）控制组件的可见性。如果它们没有显示，组件将被从视图中移走。这意思是说组件会忘记他们的本地值。
Figure 1. The JSTL <c:if> tag will execute its body if the value of exampleBean.number is greater than 10. Click on thumbnail to view full-sized image.
图 2 显示了清单2和清单3的输出。顶部输入域(一个 HtmlInputText 组件)的值关联到了 exampleBean.number的属性， JSTL <c:forEach>使用它显示一个字符串exampleBean.number次，在页面底部,如果exampleBean.number的值大于10， JSTL <c:if>标记显示一个带有JSF组件的表格。 否由,组件将不会显示， 并从视图中移出 (输入控件将丢失它的值).
Figure 2. The output of the JSP page shown in Listings 2 and 3. Click on thumbnail to view full-sized image.
你能达到清单3中代码同样的效果，通过把组件放入一个 HtmlPanelGroup 并设置它的 rendered 属性等于同样的表达式。 HtmlPanelGroup 可以作为多个组件的容器，下面是例子：
<h:panelGroup rendered="#{sessionScope.exampleBean.number > 10}">
<h:outputLabel id="inputStringLabel2" for="inputString">
<h:outputText id="outputStringLabel2" value="Enter in your string. JSF
will remember the value."/>
</h:outputLabel>
<h:inputText id="inputString2"/>
<h:commandButton value="Go!"/>
</h:panelGroup>
如果exampleBean.number 大于10，这个面板变得可见。在这种情况下，如果组件没有显示也不会删除。这是一个使用纯JSF而不用JSTL的好例子。
Tip: 即使你使用JSTL提供一个有很多功能的定制标记，如果你从零开始开发 (或重做）, 你应当首先看看用标准的JSF组件能否实现你想要的行为。使用好的组件和设计良好的backing beans, 在页面中能消除很多JSTL标记。使用标准的JSF，你能显示或隐藏面板和做各种各样的有强大功能的事情。 下面是几个可以让JSF标记和JSTL国际化、格式化标记协同工作的条件:
不推荐使用<fmt:parseDate>和<fmt:parseNumber> . 你应该使用一个带有的日期或数字转换器的HtmlInputText 组件。
不应该使用<fmt:requestEncoding>标记指定页面的字符编码，通常, JSF自动处理。如果你要强迫用特殊的字符编码, 你应该用JSP页面指示：
<%page contentType="[contenttype];[charset]"%>.
也不应该使用<fmt:setLocale> 标记，因为它不知道, 它可能引起你的JSTL标记使用一个地区而你的JSF组件使用另一个， 代替这种灾难发生的处方是，你应该使用JSF的国际化特性。为了控制特殊页面的场所，使用UIViewRoot 组件的locale 属性。 JSF的国际化特性能在JSF和JSTL两者中工作。
结合JSF和JSTL能变得十分强大。 在这里我们示范了你的定制标记或从第三方获取的标记与JSF、JSTL一起工作。 通常，当可能时，你应该尽可能地使用JSF 标记。
--
