在 JSF中JSP扮演的角色 zz

来源:互联网 发布:h5 游戏 源码 编辑:程序博客网 时间:2024/05/07 11:15
在 JSF中JSP扮演的角色
学习如何与JSF一起使用JSP

摘要
在这个来自JavaServer Faces in Action的摘录里 (Manning, November 2004), 作者Kito Mann 解释JSP如何与JSF协同工作 (1,800 words; December 13, 2004)


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 标记。
 
原创粉丝点击