【第十章】集成其它Web框架 之 10.4 集成JSF ——跟我学spring3
10.4 集成JSF
10.4.1 概述
JSF（JavaServer Faces）框架是Java EE标准之一，是一个基于组件及事件驱动的Web框架，JSF只是一个标准（规范），目前有很多厂家实现，如Oracle的默认标准实现Mojarra、Apache的MyFaces、Jboss的RichFaces 等。
本示例将使用Oracle标准实现Mojarra，请到官网http://javaserverfaces.java.net/下载最新的JSF实现。
JSF目前有JSF1.1、JSF1.2、JSF2版本实现。
Spring集成JSF有三种种方式：
- 最简单集成：使用FacesContextUtils工具类的getWebApplicationContext方法，类似于Struts1x中的最简单实现；
- VariableResolver实现：Spring提供javax.faces.el.VariableResolver的两种实现DelegatingVariableResolver和SpringBeanVariableResolver，此方式适用于JSF1.1、JSF1.2及JSF2，但在JSF1.2和JSF2中不推荐使用该方式，而是使用第三种集成方式；
- ELResolver实现：Spring提供javax.el.ELResolver （Unified EL）实现SpringBeanFacesELResolver用于集成JSF1.2和JSF2。
接下来让我们首先让我们准备JSF所需要的jar包：
首先准备JSF所依赖的包：
|
commons-digester.jar //必须，已有 commons-collections.jar //必须，已有 commons-beanutils.jar //必须，已有 jsp-api.jar //必须，已有 servlet-api.jar //必须，已有 jstl.jar //可选 standard.jar //可选 |
准备JSF包，到http://javaserverfaces.java.net/下载相应版本的Mojarra实现，如下载JSF1.2实现mojarra-1.2_15-b01-FCS-binary.zip，拷贝如下jar包到类路径：
|
lib\jsf-api.jar //JSF规范接口包 lib\jsf-impl.jar //JSF规范实现包
|
10.4.2 最简单集成
类似于Struts1x中的最简单集成，Spring集成JSF也提供类似的工具类FacesContextUtils，使用如下方式获取WebApplicationContext：
- WebApplicationContext ctx = FacesContextUtils.getWebApplicationContext(FacesContext.getCurrentInstance());
当然我们不推荐这种方式，而是推荐使用接下来介绍的另外两种方式。
10.4.2 使用VariableResolver实现集成
Spring提供javax.faces.el.VariableResolver的两种实现DelegatingVariableResolver和SpringBeanVariableResolver，其都是Spring与JSF集成的中介者，此方式适用于JSF1.1、JSF1.2及JSF2：
- DelegatingVariableResolver：首先委托给JSF默认VariableResolver实现去查找JSF管理Bean，如果找不到再委托给Spring容器去查找Spring管理Bean；
- SpringBeanVariableResolver：其与DelegatingVariableResolver查找正好相反，首先委托给Spring容器去查找Spring管理Bean，如果找不到再委托给JSF默认VariableResolver实现去查找JSF管理Bean。
接下来看一下如何在JSF中集成Spring吧（本示例使用JSF1.2，其他版本的直接替换jar包即可）：
1、JSF管理Bean（Managed Bean）实现：
- package cn.javass.spring.chapter10.jsf;
- public class HelloBean {
- private String message;
- public void setMessage(String message) {
- this.message = message;
- }
- public String getMessage() {
- return message;
- }
- }
2、JSF配置文件定义（resources/chapter10/jsf/faces-config.xml）：
- <?xml version="1.0" encoding="UTF-8"?>
- <faces-config version="1.2" xmlns="http://java.sun.com/xml/ns/javaee"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-facesconfig_1_2.xsd">
- <application>
- <variable-resolver>
- org.springframework.web.jsf.DelegatingVariableResolver
- </variable-resolver>
- </application>
- <managed-bean>
- <managed-bean-name>helloBean</managed-bean-name>
- <managed-bean-class>
- cn.javass.spring.chapter10.jsf.HelloBean
- </managed-bean-class>
- <managed-bean-scope>request</managed-bean-scope>
- <managed-property>
- <property-name>message</property-name>
- <value>#{message}</value>
- </managed-property>
- </managed-bean>
- </faces-config>
- 与Spring集成：通过<variable-resolver>标签来指定集成Spring的中介者DelegatingVariableResolver；
- 注入Spring管理Bean：通过<managed-property>标签的<value>#{message}</value>注入Spring管理Bean“message”。
4、JSP页面定义（webapp/hello-jsf.jsp）：
- <%@ page language="java" pageEncoding="UTF-8" contentType="text/html; charset=UTF-8"%>
- <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
- <%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %>
- <%@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %>
- <f:view>
- <html>
- <head>
- <title>Hello World</title>
- </head>
- <body>
- <h:outputText value="#{helloBean.message}"/>
- </body>
- </html>
- </f:view>
5、JSF前端控制器定义，在web.xml中添加如下配置：
指定JSF配置文件位置，通过javax.faces.CONFIG_FILES上下文初始化参数指定JSF配置文件位置，多个可用“，”分割，如果不指定该参数则默认加载的配置文件为“/WEB-INF/ faces-config.xml”：
- <!-- JSF配置文件开始 -->
- <context-param>
- <param-name>javax.faces.CONFIG_FILES</param-name>
- <param-value>
- /WEB-INF/classes/chapter10/jsf/faces-config-jsf1x.xml
- </param-value>
- </context-param>
- <!-- JSF配置文件结束 -->
前端控制器定义：使用FacesServlet作为JSF的前端控制器，其拦截以“.jsf”结尾的HTTP请求：
- <!-- jsf前端控制器配置开始 -->
- <servlet>
- <servlet-name>jsf</servlet-name>
- <servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
- </servlet>
- <servlet-mapping>
- <servlet-name>jsf</servlet-name>
- <url-pattern>*.jsf</url-pattern>
- </servlet-mapping>
- <!-- jsf前端控制器配置结束 -->
7、执行测试，在Web浏览器中输入http://localhost:8080/hello-jsf.jsp可以看到“Hello Spring”信息说明JSF集成成功。
自此，JSF集成Spring已经成功，在此可以把DelegatingVariableResolver替换为SpringBeanVariableResolver，其只有在查找相应依赖时顺序是正好相反的，其他完全一样。
如果您的项目使用JSF1.2或JSF2，推荐使用SpringBeanFacesELResolver，因为其实标准的Unified EL实现，而且VariableResolver接口已经被注释为@Deprecated，表示可能在以后的版本中去掉该接口。
10.4.2 使用ELResolver实现集成
JSF1.2之前，JSP和JSF各个使用自己的一套表达式语言（EL Language），即如JSF使用VariableResolver实现来解析JSF EL表达式，而从JSF1.2和JSP2.1开始使用Unified EL，从而统一了表达式语言。
因此集成JSF1.2+可以通过实现Unified EL来完成集成，即Spring提供ELResolver接口实现SpringBeanFacesELResolver用于集成使用。
类似于VariableResolver实现，通过SpringBeanFacesELResolver集成首先将从Spring容器中查找相应的Spring管理Bean，如果没找到再通过默认的JSF ELResolver实现查找JSF管理Bean。
接下来看一下示例一下吧：
1、 添加Unified EL所需要的jar包：
|
el-api.jar //Unified EL规范接口包 |
由于在Jetty中已经包含了该api，因此该步骤可选。
2、 修改JSF配置文件（resources/chapter10/jsf/faces-config.xml）：
将如下配置
- <variable-resolver>
- org.springframework.web.jsf.DelegatingVariableResolver
- </variable-resolver>
修改为：
- <el-resolver>
- org.springframework.web.jsf.el.SpringBeanFacesELResolver
- </el-resolver>
3、执行测试，在Web浏览器中输入http://localhost:8080/hello-jsf.jsp可以看到“Hello Spring”信息说明JSF集成成功。
自此JSF与Spring集成就算结束了，是不是也很简单。