先進行通用配置, 【第十章】集成其它Web框架 之 10.1 概述
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集成就算結束了,是不是也很簡單。
原文地址:http://sishuok.com/forum/blogPost/list/2513.html