A4J 用户指南Copyright © 2006 Eadel 译者: icess( ) 转载请保留版权标识和译者信息. 目录 1. 介绍 2. 开始使用Aja4jsf 环境需求 下载Aja4jsf 安装 简单的 AJA Echo 项目 JSP 页面 数据 Bean faces-config.ml Web.ml 部署3. Aja4jsf 框架的基本概念 介绍 结构概览 如何做... 发送一个AJA 请求 决定发送什么 决定改变什么4. Aja4JSF 组件库 a4j:ajaListener a4j:region a4j:page a4j:support a4j:commandLink a4j:commandButton a4j:outputPanel a4j:actionparam a4j:status a4j:loadBundle a4j:mediaOutput5. Aja4jsf内建的换肤功能 6. 技术要求 支持的java版本 支持的 JavaServer Faces 实现 支持的服务器 支持的浏览器7. 附加的设置 Web程序描述符参数 Sun JSF RI Apache MyFaces Facelets 支持 JBoss Seam 支持8. 与IDE集成 9. Eadel VCP 和 Aja4jsf 10. Web上的资源List of Tables4.1. a4j:ajaListener attributes 4.2. a4j:region attributes 4.3. a4j:page attributes 4.4. a4j:support attributes 4.5. a4j:commandLink attributes 4.6. a4j:commandButton attributes 4.7. a4j:outputPanel attributes 4.8. a4j:actionparam attributes 4.9. a4j:status attributes 4.10. a4j:loadBundle attributes 4.11. a4j:mediaOutput attributes 7.1. Initialization Parametres 7.2. org.aja4jsf.Filter Initialization Parametres 10.1. Aja4jsf Resources序言: Aja4JSF是一个很容易使用的框架.有什么问题可以在JSF中文论坛讨论. Chapter 1. 介绍这里是一些介绍a4j的内容,暂时先不翻译了,等有时间再补充上.Aja4jsf 是一个添加Aja功能到JSF项目中的开源框架,使用该框架不用写JS代码. Aja4jsf 充分利用了JSF框架的优点,如: 生命周期, 验证, 转换的灵活性和受管理的静态和动态资源. 使用Aja4jsf, 具有Aja支持的富组件和高度可自定义的外观感觉可以很容易的与JSF结合起来.Aja4JSF 被设计用来:在使用Aja时充分显示JSF的优点.Aja4jsf 完全被结合到 JSF 生命周期中. 当其他框架仅仅给你访问Managed Bean的便利时,Aja4JSF带给你 Action 和 Value Change 监听器,激活服务端验证,在Aja请求-响应周期中的转化 这些功能. 添加 AJA 功能到已经存在的 JSF 项目. 该框架被实现为使用一个组件库来添加aja功能到你的页面中,而不要写js代码或者使用新的Aja装饰器替换你已经做好的JSF组件. Aja4jsf 具有页面范围(page-wide)的Aja支持,而不是传统的组件范围(component-wide)的aja支持. 这意味着你可以在页面中定义一个激活Aja请求的事件,和当根据客户端事件触发Aja请求来改变服务器端数据后 如何使用JSF组件树来同步显示JSF页面. 使用内建的Aja支持写自定义富组件. 将来, 我们将有一个完全的组件开发包(CDK)来支持AJa4JSF. CDK 将包含代码生成工具和一个使用类似JSP语法的模版工具.这些功能将去除一些创建组件的一个例行工作.使用这个喝满油的组件工厂机器来创建一个带有Aja功能的富组件将比使用传统的编码过程创建一个简单的组件还要简单. 项目的Java类与资源包. 除了核心的 AJA 功能外, Aja4jsf 也有管理资源的高级支持,例如:图片,JS代码和CSS样式表单,资源框架使 简单的打包这些资源到你自定义组件的Jar文件中成为可能. 动态(on-the-fly)将非常容易. 作为另外一种附加的功能, 资源框架有一个动态产生图片的工具. 使用这个特性,你可以使用类似于使用Java Graphic2D库的方法来创建图片. 使用基于皮肤的技术来创建一个现代富用户界面的外观感觉(look-and-feel). Aja4jsf 提供一个换肤特性 . 该特性允许通过命名的皮肤参数来简单的定义和管理不同颜色模式与其他UI特性. 你可以从JSP代码和Java代码(例如:基于UI的文本来产生动态的图片)来访问这些皮肤参数 . 注意:, 虽然换肤功能不是完全的替代传统的CSS,但是它还是值得称赞的. 测试components, actions, listeners, 和 pages 就像你在创建他们一样容易. 一个制动测试工具正在开发中 .它将在你开发组件使为你的组件产生测试案例. 该测试框架不仅仅测试组件,也测试服务端和客户端的功能包括JS代码 .作为附加的有用工具,你不需要单独的部署测试程序到Servlet容器中 就可以做到这些了. Aja4JSF 组件已经可以使用了, 因此开发者可以立即使用这种省时的具有高级特性的工具来创建提供了更快更可靠的用户体验的Web程序了. Chapter 2. 开始使用Aja4jsfTable of ContentsEnvironment Downloading Aja4jsf Installation Simple AJA Echo Project JSP Page Data Bean faces-config.ml Web.ml Deployment环境要求要使用Aja4JSF 框架你仅仅需要JDK1.4或者更高,任何JSF实现,和你最喜欢的Servlet容器.在下一章我们将给你提供详细的环境信息. Aja4jsf 被设计为一个容易使用的框架.仅仅有一点简单的设置步骤就可以在你的JSF程序中使用Aja功能了. 下载 Aja4jsf最新的Aja4jsf 发布版在这里 下载. 安装· 解压 aja4jsf.zip 文件. · 复制 aja4jsf.jar and oscache-2.2.jar 到程序的 WEB-INF/lib 文件夹下. · 把下面的内容添加到你的程序的 WEB-INF/web.ml 文件中: · · Aja4jsf Filter· aja4jsf· org.aja4jsf.Filter· · · aja4jsf· Faces Servlet· REQUEST· FORWARD· INCLUDE· 注意. 你可以复制和粘贴上面的内容在 README.tt 文件中.· 添加下面的内容:· <%@ taglib uri=" prefi="a4j"%> 到你每个使用Aja功能的JSP页面中.简单的 AJA Echo 项目 让我们来看一个简单的JSF项目. 我们仅仅需要一个JSP页面,里面包含一个Form和一些JSF标签: 和 . 我们这个简单的程序应该可以让我们输入一些文字到中, 然后发送数据到Server,并在 中显示Server的响应(给我们一个Echo信息). JSP 页面下面是一个我们需要的页面代码 (echo.jsp) : <%@ taglib uri=" prefi="a4j"%> <%@ taglib uri=" prefi="h"%> <%@ taglib uri=" prefi="f"%> repeater 就如你看到的,唯一一行于常给JSF页面代码不同的就是下面的一行 在这里我们在父标签()中添加了一个AJA 支持. 该支持绑定了JavaScript事件“onkeyup” .因此, 每一次该事件发布给父标签时,我们的程序将发送一个AJA请求到Server.这意味着我们的受管理的bean将包含。