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有三种种方式:
接下来让我们首先让我们准备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 包到类路径:
类似于Struts1x中的最简单集成,Spring集成JSF也提供类似的工具类FacesContextUtils,使用如下方式获取WebApplicationContext:
WebApplicationContext ctx = FacesContextUtils.getWebApplicationContext(FacesContext.getCurrentInstance());
当然我们不推荐这种方式,而是推荐使用接下来介绍的另外两种方式。
Spring提供javax.faces.el.VariableResolver的两种实现DelegatingVariableResolver和SpringBeanVariableResolver,其都是Spring与JSF集成的中介者,此方式适用于JSF1.1、JSF1.2及JSF2:
接下来看一下如何在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>
3 、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>
4 、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前端控制器配置结束 -->
5 、执行测试,在Web 浏览器中输入http://localhost:8080/hello-jsf.jsp 可以看到“Hello Spring ”信息说明JSF 集成成功。
自此,JSF集成Spring已经成功,在此可以把DelegatingVariableResolver替换为SpringBeanVariableResolver,其只有在查找相应依赖时顺序是正好相反的,其他完全一样。
如果您的项目使用JSF1.2或JSF2,推荐使用SpringBeanFacesELResolver,因为其实标准的Unified EL实现,而且VariableResolver接口已经被注释为@Deprecated,表示可能在以后的版本中去掉该接口。
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集成就算结束了,是不是也很简单。