跟我学Spring3（10.4）：集成其它Web框架之集成JSF，spring3jsf

来源： javaer 分享于 2019-04-09 点击 18601 次点评：110

跟我学Spring3（10.4）：集成其它Web框架之集成JSF，spring3jsf

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：

java代码：

WebApplicationContext ctx = FacesContextUtils.getWebApplicationContext(FacesContext.getCurrentInstance());

当然我们不推荐这种方式，而是推荐使用接下来介绍的另外两种方式。

10.4.3 使用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）实现：

java代码：

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）：

java代码：

<?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”。

3、JSP页面定义（webapp/hello-jsf.jsp）：

java代码：

	
<%@ 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>

4、JSF前端控制器定义，在web.xml中添加如下配置：

指定JSF配置文件位置，通过javax.faces.CONFIG_FILES上下文初始化参数指定JSF配置文件位置，多个可用“，”分割，如果不指定该参数则默认加载的配置文件为“/WEB-INF/ faces-config.xml”：

java代码：

<!-- 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请求：

java代码：

<!-- 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前端控制器配置结束   -->

5、执行测试，在Web浏览器中输入http://localhost:8080/hello-jsf.jsp可以看到“Hello Spring”信息说明JSF集成成功。

自此，JSF集成Spring已经成功，在此可以把DelegatingVariableResolver替换为SpringBeanVariableResolver，其只有在查找相应依赖时顺序是正好相反的，其他完全一样。

如果您的项目使用JSF1.2或JSF2，推荐使用SpringBeanFacesELResolver，因为其实标准的Unified EL实现，而且VariableResolver接口已经被注释为@Deprecated，表示可能在以后的版本中去掉该接口。

10.4.4 使用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）：

将如下配置

java代码：

<variable-resolver>
    org.springframework.web.jsf.DelegatingVariableResolver
</variable-resolver>

修改为：

java代码：

<el-resolver>
org.springframework.web.jsf.el.SpringBeanFacesELResolver
</el-resolver>

3、执行测试，在Web浏览器中输入http://localhost:8080/hello-jsf.jsp可以看到“Hello Spring”信息说明JSF集成成功。

自此JSF与Spring集成就算结束了，是不是也很简单。

本系列：

跟我学 Spring 3（1）： Spring 概述
跟我学 Spring 3（2.1）：IoC 基础
跟我学Spring3（2.2）：IoC容器基本原理
跟我学Spring3（2.3）：IoC容器基本原理
跟我学Spring3（3.1）：DI的配置使用
跟我学Spring3（3.2）：DI之循环依赖
跟我学Spring3（3.3）：更多的DI知识
跟我学Spring3（3.4）：DI之Bean的作用域
跟我学Spring3（4.1）：资源之基础知识
跟我学Spring3（4.2）：内置Resources实现
跟我学Spring3（4.3）：访问Resource
跟我学Spring3（4.4）：Resource通配符路径
跟我学Spring3（5.1 & 5.2）：Spring表达式语言之概述和SpEL基础
跟我学Spring3（5.3）：Spring 表达式语言之 SpEL 语法
跟我学Spring3（5.4）：在Bean定义中使用EL—跟我学spring3
跟我学Spring3（6.1）：AOP的HelloWorld
跟我学Spring3（6.3）：基于Schema的AOP
跟我学Spring3（6.5）：AspectJ切入点语法详解
跟我学Spring3（6.6）：通知参数
跟我学Spring3（6.7）：通知顺序
跟我学Spring3（6.8）：切面实例化模型
跟我学Spring3（6.9）：代理机制
跟我学Spring3（ 7.1 ）：对JDBC的支持之概述
跟我学Spring3（ 7.2 ）：对JDBC的支持之JDBC模板类
跟我学Spring3（7.3）：对JDBC的支持之关系数据库操作对象化
跟我学Spring3（7.4）：对JDBC的支持之Spring提供的其它帮助
跟我学Spring3（7.5）：对JDBC的支持之集成Spring JDBC及最佳实践
跟我学Spring3（8.1）：对ORM的支持之概述
跟我学Spring3（8.2）：对ORM的支持之集成Hibernate3
跟我学Spring3（9.1）：Spring的事务之数据库事务概述
跟我学Spring3（9.2）：Spring的事务之事务管理器
跟我学Spring3（9.3）：Spring的事务之编程式事务
跟我学Spring3（9.4）：Spring的事务之声明式事务
跟我学Spring3（10.1）：集成其它Web框架之概述
跟我学Spring3（10.2）：集成其它Web框架之集成Struts1.x
跟我学Spring3（10.3）：集成其它Web框架之集成Struts2.x
跟我学Spring3（10.4）：集成其它Web框架之集成JSF

跟我学Spring3（10.4）：集成其它Web框架之集成JSF，spring3jsf