跟我学Spring3(10.4):集成其它Web框架之集成JSF

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集成就算结束了,是不是也很简单。

本系列:



相关文章

发表评论

Comment form

(*) 表示必填项

还没有评论。

跳到底部
返回顶部