Oracle ADF Faces(adfFaces)提供了丰富的UI组件,可以简化你的web应用开发.可以通过学习示例代码来理解adfFaces的使用,示例代码包.

 adfFaces定义了一个API和一套基本的标签来构建基于web的用户接口,它基于JSF框架,扩展了UI组件.本文将展示如何在现有的JSF应用中使用adfFaces所提供的UI组件.

 首先,要运行示例代码,最低环境要求为J2SE 1.4,Servlet 2.3,JSP 1.2,JSF 1.1,ADF Faces EA13,JSTL 1.0,支持JDBC的数据库或者Oracle Toplink.

 本文将基于另外一篇文章介绍的例子,在此例子基础上用adfFaces替换JSF接口来实现数据的访问.之前的例子可以参见链接.

 和JSF类似,adfFaces也提供了一个开放的API供你的JAVA类使用,两个JSP标签库(HTML & CORE)供页面使用.另外,adfFaces也包括一系列的资源(图片,js,css)以供UI组件内部使用.

 下载资源包,将adf-faces-api-ea13.jar, adf-faces-impl-ea13.jar和share-1_1_18.jar拷贝到你的web项目lib库中(一般是WEB-INF\lib\),解压adf-faces-install-ea13.zip(包括了图片,js和css)到你的web应用相应目录.

 服务端web.xml的配置:

    FacesServlet
    javax.faces.webapp.FacesServlet
    1


    FacesServlet
    /faces/*


    FacesServlet
    *.faces


...


    AdfFacesFilter
    
        oracle.adf.view.faces.webapp.AdfFacesFilter
    



    AdfFacesFilter
    FacesServlet

 新建adf-faces-config.xml,在此描述符制定额外的参数

    true
    
        #{prefs.proxy.accessibilityMode}
    
    
        #{prefs.proxy.lookAndFeel}
    

遵循如下步骤修改你现有的jsp页面

1. 导入adfFaces标签库

a) 核心库包含UI组件,按钮,输入框,列表,菜单,表格,树,面板等等

<%@ taglib prefix="af" uri="http://xmlns.oracle.com/adf/faces/EA13" %>

b) HTML库包含了HTML元素标签
<%@ taglib prefix="afh" uri="http://xmlns.oracle.com/adf/faces/EA13/html" %>

2.使用adfFaces的HTML标签,和

<%@ taglib prefix="af" 
    uri="http://xmlns.oracle.com/adf/faces/EA13" %>
<%@ taglib prefix="afh" 
    uri="http://xmlns.oracle.com/adf/faces/EA13/html" %>



    

    
        
        
            ...
        
    

3. 重命名原有的jsf标签和属性

adfFaces提供了一套与标准jsf类似的标签,并且扩展了不少额外的标签供使用,两者可以混合使用,但为了统一的代码风格建议使用同样的标签,如下面的JSF

可以转换成

其中的通过属性rows和secret的设置,能够用来显示单行,多行,密码输入

使用adfFaces的panel标签,此标签可以用来快速实现多种面板组合,在此不做详细介绍.