vlambda博客
学习文章列表

JSF 的概念在 2001 年左右首次被讨论。它是 Sun Microsystems 项目的一部分，名为 Project Rave，然后宣布为 JSR 127。 技术，虽然是对Apache等时代基于action-request的框架的改进Struts 在 2003 年和 2004 年受到了不冷不热的宣传。2004 年发布了维护版本 1.1，但直到 2006 年，JSF 1.2 规范才成为总括规范 Java EE 5 的正式部分。

然而，此时，开发人员的思想共享已经演变为 AJAX 技术、部分应用程序和非 JVM 软件，例如 Ruby 和 Ruby on Rails。 JSF 1.2 受到平台默认模板技术 JavaServer Pages 的阻碍。 JSP 被证明不适合 JSF，因为请求拦截和响应生成的生命周期本质上是不兼容的。对替代方案的搜索导致了 Facelets 的创建，这些 Facelets 旨在明确地与 JSF 一起工作。

2009 年，Facelets 成为 JSF 2.0 (JSR 314) 中的默认模板解决方案，这也是 Java EE 6 的一部分。JSF 2.0 为验证和转换添加了注解。 JSF 2.0 定义了一个标准的 AJAX 组件生命周期，并且还增加了对图形编辑器的改进。 JSF 2.0 引入了 Web 内容的资源句柄，包括图像、JavaScript 和 CSS 文件。

JSF 2.2 规范的大票 特性如下：

JSF 2.2 向后兼容 Faces 2.1 和 2.0。针对 Faces 2.0 或 2.1 构建的应用程序不需要更改即可与 Faces 2.2 一起运行；但是，反过来，使用特定的 2.2 功能将无法在这些旧环境中运行。

JSF 基于以下 Java API 规范：

JSF 是迄今为止唯一被认证为 JCP 标准的 Java Web 应用程序框架。当然，还有其他选择；事实上，可能有多达 100 种不同的 Java Web 框架，并且其中大部分将是开源的。但是，它们会根据代码库的愿景、实现、年龄以及实际维护它作为存储库的人而有所不同。如果您的应用程序所针对的 Web 框架是用昨天的技术构建的，那么这对企业来说是没有好处的，因为 Web 在不断发展。同样，Web 框架必须与时俱进，否则最终将变得无关紧要。企业相信 JSF 是一个标准，可以保证该技术将得到长期支持。

完全可以理解，应用程序架构师可能希望选择 JSF 以外的 Web 框架来满足他们的业务需求。 Apache Struts 2、Spring MVC 和 Apache Wicket 是我顺便提及的几个。 Apache Struts 2 和 Spring MVC 通常被认为是面向请求的框架。 Apache Wicket 是一个面向组件的框架，是 JSF 的直接竞争对手。 Apache Struts 是 2000 年代初期最著名的 Web 应用程序框架之一，当然也是第一个打破常规的框架。

Web 框架的世界并不止于 Java。大多数开发人员都听说过 Ruby on Rails，它是一种脱离 JVM 的技术。一些工程师会了解 Java 和 Scala 开发人员的 Play 框架，然后还有基于 Groovy 语言的解决方案，例如 Grails。

无论您为 Web 应用程序选择什么框架，本质上都为您的开发人员决定了基于 Java 的前端架构。无论你做什么，我强烈建议不要发明自己的 Web 应用程序框架。开源的优势在于拥有来自数千家不同公司、不同事业和文化的开发人员社区。

如果您选择 JSF，那么作为客户，您很可能希望维持您在 Java 平台上的投资。您的 JSF 企业应用程序的核心优势是丰富的组件，并且您依靠模型添加了默认的好处，例如更容易验证、类型转换和 HTTP 请求参数的映射以 bean 属性。许多经验丰富的 Java EE 工程师将具有 JSF 框架方面的经验，因此您将成为一个很棒的公司。

MVC 如何映射到 JSF？这已在 以下几点中得到解答：

下图从 JSF 框架的角度说明了 MVC 模式：

模型视图控制器模式是 JSF 框架的术语

下图显示了处理 Faces 请求的 JSF 生命周期：

JSF 框架内的执行和渲染生命周期阶段

标准请求处理生命周期从对 Restore View 阶段的 Faces 请求刺激开始。 JSF 为生命周期维护一个 javax.faces.context.FacesContext 实例。此对象实例包含与单个 Faces 请求关联的所有信息。 FacesContext 被传递到各个阶段。

为了充分利用 JSF 框架，我们建议配置一个Web 应用程序部署描述符。该文件是一个特殊的 XML 文档，它以声明方式描述入口 servlet 端点、servlet 映射和其他环境资源。 XML文件的代码如下：

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" version="3.1" metadata-complete="false">

  <display-name>
    jsf-compositions-1.0-SNAPSHOT
  </display-name>

  <servlet>
    <servlet-name>Faces Servlet</servlet-name>
    <servlet-class>
      javax.faces.webapp.FacesServlet
    </servlet-class>
    <load-on-startup>1</load-on-startup>
  </servlet>

  <servlet-mapping>
    <servlet-name>Faces Servlet</servlet-name>
    <url-pattern>*.xhtml</url-pattern>
  </servlet-mapping>

  <context-param>
    <param-name>javax.faces.PROJECT_STAGE</param-name>
    <param-value>Development</param-value>
  </context-param>

  <welcome-file-list>
    <welcome-file>index.xhtml</welcome-file>
  </welcome-file-list>
</web-app>

前面的文件有 WEB-INF/web.xml 路径。为了激活 JSF 框架，部署描述符用完全限定的类名声明 servlet； javax.faces.webapp.FacesServlet。请注意，servlet 被映射为提供 *.xhtml 文件。

我们将使用上下文参数 javax.faces.PROJECT_STAGE 和适当的值来定义当前项目的活动阶段。在前面的示例中，阶段设置为 Development 但应用程序上线后，我们可能希望将值切换为 Production代码>。切换到 Production 可以提高性能并禁用 一些调试输出。

您将在本书的源代码中找到 部署描述符，作为项目 ch02/jsf-compositions 的一部分.将项目添加到 IDE（例如 IntelliJ、Eclipse 或 NetBeans）后，您可以在 URL http://localhost:8080/jsf-compositions- 查看应用程序服务器的输出1.0-快照/。

这是一个表描述了常见的JSF和相关的命名空间：

必须将诸如 fn 之类的缩写名称添加到根 XML 文档元素中，该元素在 的大部分case 是一个 HTML 元素。

JSF 期望 我们的 Web 资源默认放置在 resources 文件夹中。快速查看以下文件目录将有助于您理解：

jsf-composition

jsf-composition/src/main/webapp

jsf-composition/src/main/webapp/resources

jsf-composition/src/main/webapp/resources/images

jsf-composition/src/main/webapp/resources/javascripts

jsf-composition/src/main/webapp/resources/styles

jsf-composition/src/main/webapp/WEB-INF

jsf-composition/src/main/webapp/WEB-INF/classes

jsf-composition/src/main/webapp/WEB-INF/lib

在这个 Gradle 项目的简化视图中，我们可以看到放置在 resource 文件夹下的文件夹、图像、JavaScript 和 CSS 文件。让我们再次提醒一下 JSF 视图代码，如下：

<h:outputStylesheet library="styles" name="main.css" rel="stylesheet"/>
<h:outputStylesheet name="/styles/top.css" rel="stylesheet"/>

这些标签本质上是指两个文件：resources/style/top.css和resources/style/main.css。

为了使这些 标签起作用，资源必须放在资源文件夹下，或者可以放在 META -INF/resources 与 Web 应用程序一起部署的 Web 应用程序 JAR 文件的文件夹。该规范列出了以下两个选项：

<ROOT>/resources/<RES-ID>

否则，你可以使用这个：

<ROOT>/WEB-INF/lib/<DEPENDANT-JAR>/META-INF/resources/<RES-ID>

这里，<ROOT>是项目web根目录，<DEPENDANT-JAR>是第三方依赖的JAR， <RES-ID> 是资源标识符。

<RES-ID> 可以进一步分解成正式的部分，如下：

<RES-ID> ::=
   [ <LOCALE-PREFIX> / ] + 
   [ <LIBRARY-NAME> / ] [ <LIBRARY-VERSION> / ] +
   <RESOURCE-NAME> [ / <RESOURCE-VERSION> ]

[] 中的术语部分是可选的，但资源名称除外。因此，可以在库中拥有完全国际化、版本化和模块化的资源标识符。也许您的项目可能会利用以下资源：

/en_us/sportsBulletin/v1_2_3/top_masters_golfer/2015_may.png

如果您想逆势而上并更改 JSF 2.2 中资源的默认位置会发生什么？可以在 web.xml 部署描述符文件中配置替代文件夹。您可以设置上下文参数变量：javax.faces.WEBAPP_RESOURCES_DIRECTORY。

这是将资源文件夹定义为资产的描述符的摘录：

  <context-param>
    <param-name>
    javax.faces.WEBAPP_RESOURCES_DIRECTORY</param-name>
    <param-value>assets</param-value>
  </context-param>

我们将在 Chapter 3, 构建 JSF 表单 和 第 4 章， JSF 验证和 AJAX。

表达式的语法有两种形式：${expression} 和 #{expression}。开头的美元 字符表示立即计算的表达式。开头的哈希字符表示稍后延迟的表达式 。

立即表达式 总是被立即计算，作为一个结果，它们只能用于读取值而不是设置它们。在呈现页面时进行评估，这通常是 JavaServer Pages 的情况。

当我们使用 JSF 构建应用程序时，我们将在本书中主要使用延迟表达式。延迟表达式意味着幕后的技术负责获取文字文本并将其解释为结果或调用返回结果的函数。

让我们快速向前一点，介绍一个名为 <h:inputText> 的 JSF 自定义标记。此标记呈现一个 HTML 输入元素，其类型为文本。该标签接受一个 id 属性来指定一个 HTML 标识符；但是，我想提请您注意 value 属性，它指定了一个 EL 值表达式。

我们可以编写一个像在 JSP 中一样立即计算的值表达式。这是代码片段：

<h:inputText id="firstName" value="${employee.firstName}"/>

这将作为只读值工作。但是，无法使用 JSF 将该值应用到员工 bean，因为在任何生命周期状态下都不会计算表达式。

如果我们将表达式从立即形式更改为延迟形式，那么我们将看到以下行为：

<h:inputText id="firstName" value="#{employee.firstName}"/>

通过此更改，EL 会在生命周期的渲染响应阶段立即进行评估。 JSF 实现执行评估并从名为employee 的bean 中检索firstName 属性的值。

当 表单作为 Faces 请求回传到服务器时，通过方式也是称为postback事件，JSF实现有一个有机会在延迟时间检索值。正是在这些后期的生命周期状态——应用请求值、流程验证和更新模型——评估值表达式并将来自 Faces 请求的值注入到目标 bean 属性中。

值表达式 是返回单个结果的表达式。 值是从管理 Java 实例集合的实现中的对象图中检索的。对于 Java EE，它是 JSF 或 JSP 提供程序，而对于应用程序服务器，它是一个上下文和依赖注入提供程序。 CDI 在 @javax.inject.Named bean 内部维护一组集合。 （请等待命名bean的解释或直接前往第3章，构建 JSF 表单。）特别是，JSF 传统上会记录使用 @javax.faces.bean.ManagedBean 注释的托管 bean。

JSP 会在页面范围、请求范围、会话范围中搜索命名对象，然后是 servlet 容器的应用范围。在幕后，有一个抽象类javax.el.E​​LResolver的子类，它负责求值。这个类有有用的方法，例如getValue(), setValue(), isReadOnly( ) 和 invoke()，开发人员可以使用它们以编程方式向自己的应用程序添加评估。

在任何情况下，值表达式的第一个调用端口是具有标识名称的对象实例。这被称为初始期限。之后，评估逻辑可以使用点符号 (.) 通过命名属性遍历对象图。评估继续通过表达式中的后续项。让我们暂时使用 JSF，并考虑 #{employee.firstName} 表达式将评估对范围内名为employee 的对象的延迟搜索。然后 EL 解析器将在名为 firstName 的 bean 中查找属性，这反过来将调用 getFirstName() 方法。作业将完成，EL 解析器返回属性的结果值。

EL 也适用于 Java 集合。特别是，java.util.Map 集合被特殊处理。标准 EL 假定集合具有 String 类型的键，我们可以将其视为 Map 。可以使用点表示法或方括号表示法[] 访问 Map 中的条目。

下面的值表达式表将使这个方案对于更复杂的表达式更加清晰：

方括号表示法 [] 对于包含破折号和/或句点字符的字符串非常有用。当您想要从资源包中提取消息以用于 国际化目的时，此表示法会有所帮助。您可以将 值表达式编写为：appMessages["registeredTraveller.applicant.firstName.required"]。

方括号表示法允许我们编写特殊的表达式。我们可以写出如下的值表达式：

${employee['class'].simpleName}

这将转换为以下等效的 Java 代码：

employee.getClass().getSimpleName()

${capitalCitiesMap['France']}   
  // translates to capitalCitiesMap.get("France")
#{capitialCitesMap['France']}  // ditto, but deferred

${departmentList[0].name}
${departmentArray[0].name}

List<Department> department = resolve(...)
departmentList.get(0).getName()

Department departmentArray[] = resolve(...)
departmentArray[0].getName()

<link href="#{request.contextPath}/resources/styles/main.css" rel="stylesheet"/>

EL 还允许 关联到对象实例上的方法。这种类型的引用称为方法绑定表达式。 JSF 框架允许方法表达式引用操作方法、验证器、转换器和阶段侦听器。方法表达式调用命名对象实例上的方法，然后返回结果（如果有）。

方法表达式的一个很好的示例是托管bean 上的操作处理程序，您已经在本章的基本JSF 示例中看到了这一点。

<h:commandButton action="#{basicFlow.serveResponse}" value="Invoke Action" />

#{basicFlow.serverResponse} 表达式是一个方法绑定，它引用控制器、名为 BasicFlow 的 CDI bean，以及serveResponse() 方法。

<h:inputText action="#{complexFlow.process('SALE',productLine)}" value="Purchase Products/>

我们可以使用算术运算符在表达式中执行计算。表达式还可以包含关系和逻辑运算符。

在 EL 中，以下是保留运算符：

以下是一些使用中的算术表达式的示例：

<p> The expression \#{1+5*2-3/4} evaluates to: #{1+5*2-3/4} </p>
<p> The expression \#{(2014 div 4) mod 3} evaluates to: #{(2014 div 4) mod 3} </p>
<p> The expression \#{2018 lt 2022} evaluates to: #{2018 lt 2022} </p>
<p> The expression \#{0.75 == 3/4} evaluates to: #{0.75 == 3/4} </p>

请注意转义字符的使用——反斜杠 (\)，它会阻止 JSF 视图解释表达式。我们还可以直接在页面上呈现表达式，而不需要 <h:outputText/> 自定义标签。这对页面作者来说是一种很好的享受。

JSF 还支持 Faces 配置 XML 文件中的显式导航规则。我应该警告您，这是 JSF 1 中的旧样式。x 明确描述页面之间的导航。在 JSF 2.x 中不再需要导航规则，如果你想更好地描述页面导航，提醒自己学习 Faces Flows （参见 第 6 章，JSF 流程和技巧 ）。但是，在您的专业工作中，您很有可能会遇到较旧的 JSF 应用程序，因此，您需要了解 JSF 导航规则是如何设计的。

考虑到这一点，以下是导航的明确工作方式。假设我们有一个简单的页面，我们可以在其中选择一组页面中的水果和蔬菜集合。我们也可以选择取消选择。

以下是标准 Faces 配置文件 faces-config.xml 中这些规则的表示。该文件通常位于 Maven 和 Gradle 项目的 src/main/webapp/WEB-INF 中：

<?xml version="1.0" encoding="UTF-8"?>
<faces-config xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-facesconfig_2_2.xsd" version="2.2">
  <navigaton-rule>
    <from-view-id>/order-start.xhtml</from-view-id>
    <navigation-case>
      <from-outcome>cancel</from-outcome>
      <to-view-id>/cancel.xhtml</to-view-id>
    </navigation-case>
  <navigation-case>
      <from-outcome>fruit</from-outcome>
      <to-view-id>/fruit.xhtml</to-view-id>
    </navigation-case>
  <navigation-case>
      <from-outcome>vegetable</from-outcome>
      <to-view-id>/vegetable.xhtml</to-view-id>
    </navigation-case>
  </navigation-case>
</faces-config>

显式导航由 JSF 框架应用的一组规则确定。开发人员将在 navigation-rule> 标签中编写一系列复合元素。规则的上下文由 <from-view-id> 元素确定，该元素引用特定的视图页面 /order-start .xhtml，或者它可以是适用于多个导航案例的通配符规则（星号 *）。每个导航规则都有一个 元素的集合。每个案例都需要一个 <from-outcome> 和 <to-view-id> 元素。结果标识了由控制器方法返回的文字字符串，视图 ID 是目标视图。因此，在取消情况下，由取消标识的结果字符串将导航到 /cancel.xhtml 视图。

结果间接映射到视图页面的优势是显而易见的。控制器中的结果代码保持不变，但目标视图可以更改。

我们可以编写一个 JSF 控制器来处理这些导航规则。这是 ProductTypeController 类的摘录：

@Named @ViewScoped
public class ProductTypeController {
  public String productType;
  /* ... getter and setter omitted */

  public String cancel() { return "cancel";}
  public String navigate() {
    if ("fruit".equalsIgnoreCase(productType)) {
      return "fruit";
    }
    else {
      return "vegetable";
    }
  }
}

cancel() 方法 只返回取消结果，JSF 映射到 /cancel.xhtml 页面，因为导航案例与结果匹配。 navigate() 方法根据 productType 属性设置结果。 fruit 和 vegetable 方法只能有两个结果，导航案例确保 fruit.xhtml 和 vegetable.xhtml 页面分别呈现。

导航规则 也可能有通配符视图。通配符导航规则出现在星号 (*) 字符添加到 <from-view-id> 元素。

假设我们有一个 网站，其中包含受保护的页面，除非用户以注册用户身份登录，否则这些页面不应显示。我们可以编写一个导航规则，供保护区下的所有页面共享。假设我们要保护 URI /secured 下的任何网页：

<faces-config ...>
  <navigaton-rule>
    <from-view-id>/secured/*</from-view-id>
    <navigation-case>
      <from-outcome>login</from-outcome>
      <to-view-id>/login.xhtml</to-view-id>
    </navigation-case>
    <navigation-case>
      <from-outcome>register</from-outcome>
      <to-view-id>/register.xhtml</to-view-id>
    </navigation-case>
  </navigation-case>
  ... more rules ...
</faces-config>

通配符 from-view-id /secured/* 标识所有以 /secured/ 前缀开头的页面。 URI 路径中只能有一个通配符。

在结果中使用通配符会引发优先级问题。通配符 view id 何时优先于直接结果？这是 Faces Configuration XML 的导航案例摘录，我们在其中设置了源页面视图：

<from-view-id>stocks.xhtml</from-view-id>
// Has higher precedure than 
<from-view-id>*</from-view-id>

直接 view id 总是比等效的通配符视图具有更高的优先级。 JSF 在通配符视图上选择直接视图的导航案例 stocks.xhtml，如下所示：

<from-view-id>/secured/portfolio/*</from-view-id>
// Has higher precedure than 
<from-view-id>/secured/*</from-view-id>

如果有多个 通配符视图在竞争 匹配项，则选择最长的匹配。 JSF 在最长匹配视图中选择导航用例，在插图 /secured/portfolio/* 中。

JSF 显式页面 导航也支持Faces 配置中的条件导航的思想文件。这允许开发人员根据应用程序的动态状态以声明方式设置导航规则。条件导航是通过使用 <if> 元素标签实现的，如下例所示：

<faces-config>
  <navigaton-rule>
    <from-view-id>/shopping-cart.xhtml</from-view-id>
    <navigation-case>
      <from-outcome>nextPage</from-outcome>
      <if>#{user.registered}</if>
      <to-view-id>/existing-customer.xhtml</to-view-id>
    </navigation-case>
    <navigation-case>
      <from-outcome>nextPage</from-outcome>
      <if>#{!user.registered}</if>
      <to-view-id>/new-customer.xhtml</to-view-id>
    </navigation-case>
  </navigation-case>
</faces-config>

<if> 的正文内容是一个延迟值表达式，它在 JSF 生命周期中进行评估，应该返回一个布尔值。在代码中，#{user.registered} 表达式被评估为具有当前登录用户配置文件 bean 和名为已注册的属性的 bean。 #{!user.registered} 表达式计算否定 - 请注意对运算符使用感叹号。

要完成关于页面导航的 数字开发者故事，是时候看看使用 JSF 的静态导航了。静态导航允许我们在不调用托管 bean 控制器的情况下从一个 JSF 页面遍历到另一个页面。它对于不需要服务器端 Java 代码或没有 HTML 输入元素的页面视图很有用。静态导航是通过 Facelets 视图上的标记和显式导航规则的组合来实现的。

在前面的 Basic JSF 示例中，我们有一个带有 <h:link> 的页面视图。让我们把它改成 <h:commandButton>：

<h:form>
  ...
  <h:commandButton action="your-next-view">
      Composition 1
  </h:commandButton>
</h:form>

action 属性指定要导航的结果的名称。我们将用 <h:commandButton> JSF 标记替换旧元素。 action 属性指定值表达式。 JSF 在多个上下文中查找初始术语，但它也会搜索 Faces 配置以匹配导航规则。为了使这种遍历工作，我们还需要在 Faces 配置中使用导航规则：

<navigation-case>
  <from-outcome>your-next-view</from-outcome>
  <to-view-id>/shopping-cart.xhtml</to-view-id>
</navigation-case>

导航规则与 Facelets 视图中的 your-next-view 结果相匹配，因此 JSF 可以导航到目标页面。

我想我们将在这里停止关于页面导航主题。我们将在 Chapter 4、JSF 验证和AJAX。