本节书摘来异步社区《Java EE 7精粹》一书中的第2章，第2.1节，作者：【美】Arun Gupta，更多章节内容可以访问云栖社区“异步社区”公众号查看。

第3章 JSF

JSF是基于Java的Web应用程序开发的服务器端用户界面（UI）框架。使用JSF可以实现：

• 使用遵循模型-视图-控制器（MVC）设计模式的可重用的UI组件集合来创建网页。
• 绑定组件到服务器端模型，允许UI与应用程序数据双向移动。
• 处理UI事件响应和模型交互中的页面导航。
• 管理跨服务器请求的UI组件状态。
• 提供从客户端生成的事件到服务器端应用程序代码的简单模型。
• 轻松地构建和重用自定义UI组件。

JSF应用程序包括：

• 置于UI组件的布局中的一组网页。
• 一组托管的Bean，包括绑定组件到服务器端模型的Bean（通常是CDI Bean）和作为控制器的Bean（通常是EJB或CDI Bean）。
• 可选的部署描述符文件web.xml。
• 可选的配置文件faces -config.xml。

• 可选的一组自定义对象，包括应用程序开发人员创建的转换器和监听器。

3.1 Facelets

Facelets是JSF的视图声明语言（又名视图处理器）。他是JSP的替代者，JSP现在只保留了向后兼容性。在JSF2规范中引入的新功能，如复合组件和Ajax，只会暴露给Facelets的使用者。Facelets的主要优点包括一个功能强大的模板系统，可重用和易于开发，更好的错误报告（包括行号），以及对设计人员友好。

Facelets页面使用XHTML1.0和层叠样式表（CSS）来编写。XHTML1.0的文档是遵循XML1.0规则书写的HTML4文档。页面必须符合XHTML-1.0-Transitional DTD的要求。

使用XHTML定义的一个简单的Facelets页面如下：

在这段代码中，XML声明之后是文档类型定义（DTD）。页面的根元素是html，其中声明了命名空间http://www.w3.org/1999/xhtml。声明XML命名空间是为了在Web页面中使用标签库，Facelets的html标签（那些以h开头的标签）和普通的html标签用于添加组件。

表3-1给出了Facelets支持的标准标签库集合。

按照惯例，使用XHTML创建的Web页面使用.xhtml作为扩展名。

Facelets提供表达式语言（EL）集成，这使得后台Bean可以和前台UI之间实现双向的数据绑定：

在这段代码中，EL表达式#{name.value}代表请求作用域的CDI Bean的value字段的值：

重要的是要为这个CDI Bean添加@Named注解，以使其可以依赖注入到EL表达式中。

在JSF2.2中，@javax.faces.bean.ManagedBean注解是未来的版本中不建议使用的，所以强烈建议使用@Named来代替。

JSF2.2还引入了新的CDI作用域：javax.faces.view.ViewScoped。在一个Bean上指定该注解，可以将这个Bean与当前视图绑定。javax.faces.bean.ViewScoped注解是未来的版本中不建议使用的，所以强烈建议使用新引入的作用域。

同样地，一个EJB可以在EL表达式注入：

这是一个无状态的会话Bean，包含一个返回客户名称列表的业务方法。@Named标记它可以依赖注入到EL表达式中，可以在Facelets的EL表达式中使用：

在这段代码中，客户名称列表的返回值显示在一个表格组件当中。请注意getCustomerNames方法是如何作为一个属性用在EL表达式中的。

Facelets还提供了编译期EL表达式验证。

此外，Facelets提供了一个功能强大的模板系统，使我们可以在一个Web应用程序的多个页面之间提供一致的界面外观。基础页面称为模板，是通过Facelets的模板标签创建的。这个页面为Web页面定义了一个缺省页面骨架，包括内容占位符，会在将来的页面中使用模板来添肉。模板客户端页面使用这个模板，为模板骨架中定义的占位符提供具体的肉（实际的内容）。

表3-2列出了一些在模板和模板客户端页面中使用的通用标签。

模板页面的外观示例如下：

在这段代码中，在页面中使用

和CSS（在这里没有显示）定义结构。ui:insert定义了被模板客户端页面替换的内容。

模板客户端页面示例如下：

在这段代码中，名为top和bottom的ui:insert没有定义，那么这些部分使用模板页面的ui:define元素的名称匹配模板中的ui:insert元素，因此模板的这部分内容被替换。